PolymarketDocumentation/docs/api-reference/bridge/get-transaction-status.md

Documentation Index

Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt Use this file to discover all available pages before exploring further.

Get transaction status

Get the transaction status for all deposits and withdrawals associated with a given address.

Usage:

• Use the deposit address returned from the /deposit or /withdraw endpoint (EVM, SVM, or BTC address)
• Poll this endpoint to track the progress of your deposits and withdrawals

Status Values:

• DEPOSIT_DETECTED: Funds detected but not yet processing
• PROCESSING: Transaction is being routed and swapped
• ORIGIN_TX_CONFIRMED: Origin transaction has been confirmed on source chain
• SUBMITTED: Transaction has been submitted to destination chain
• COMPLETED: Transaction completed successfully
• FAILED: Transaction encountered an error and did not complete

Notes:

• Transactions typically complete within a few minutes, but may take longer depending on network conditions
• An empty transactions array means no transactions have been made to this address yet

OpenAPI

openapi: 3.0.3
info:
  title: Polymarket Bridge API
  version: 1.0.0
  description: >
    HTTP API for Polymarket bridge and swap operations. 


    Polymarket uses USDC.e (Bridged USDC) on Polygon as collateral for all
    trading activities. This API enables users to bridge assets from various
    chains and swap them to USDC.e on Polygon for seamless trading.
servers:
  - url: https://bridge.polymarket.com
    description: Polymarket Bridge API
security: []
tags:
  - name: Bridge
    description: Bridge and swap operations for Polymarket
paths:
  /status/{address}:
    get:
      tags:
        - Bridge
      summary: Get transaction status
      description: >
        Get the transaction status for all deposits and withdrawals associated
        with a given address.


        **Usage:**

        - Use the deposit address returned from the `/deposit` or `/withdraw`
        endpoint (EVM, SVM, or BTC address)

        - Poll this endpoint to track the progress of your deposits and
        withdrawals


        **Status Values:**

        - `DEPOSIT_DETECTED`: Funds detected but not yet processing

        - `PROCESSING`: Transaction is being routed and swapped

        - `ORIGIN_TX_CONFIRMED`: Origin transaction has been confirmed on source
        chain

        - `SUBMITTED`: Transaction has been submitted to destination chain

        - `COMPLETED`: Transaction completed successfully

        - `FAILED`: Transaction encountered an error and did not complete


        **Notes:**

        - Transactions typically complete within a few minutes, but may take
        longer depending on network conditions

        - An empty transactions array means no transactions have been made to
        this address yet
      parameters:
        - name: address
          in: path
          required: true
          description: >-
            The address to query for transaction status (EVM, SVM, or BTC
            address from the `/deposit` or `/withdraw` response)
          schema:
            type: string
          example: EXoZue2avJae1d45B3fVw2unhkrtToSYQqHtHgfZ2cbE
      responses:
        '200':
          description: Successfully retrieved transaction status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionStatusResponse'
              example:
                transactions:
                  - fromChainId: '1151111081099710'
                    fromTokenAddress: '11111111111111111111111111111111'
                    fromAmountBaseUnit: '13566635'
                    toChainId: '137'
                    toTokenAddress: '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174'
                    status: DEPOSIT_DETECTED
                  - fromChainId: '1151111081099710'
                    fromTokenAddress: '11111111111111111111111111111111'
                    fromAmountBaseUnit: '13400000'
                    toChainId: '137'
                    toTokenAddress: '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174'
                    createdTimeMs: 1757646914535
                    status: PROCESSING
                  - fromChainId: '1151111081099710'
                    fromTokenAddress: '11111111111111111111111111111111'
                    fromAmountBaseUnit: '13500152'
                    toChainId: '137'
                    toTokenAddress: '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174'
                    txHash: >-
                      3atr19NAiNCYt24RHM1WnzZp47RXskpTDzspJoCBBaMFwUB8fk37hFkxz35P5UEnnmWz21rb2t5wJ8pq3EE2XnxU
                    createdTimeMs: 1757531217339
                    status: COMPLETED
        '400':
          description: Bad Request - Missing address parameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: address is required
        '500':
          description: Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: cannot get transaction status
components:
  schemas:
    TransactionStatusResponse:
      type: object
      properties:
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/Transaction'
          description: List of transactions for the given address
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
      required:
        - error
    Transaction:
      type: object
      properties:
        fromChainId:
          type: string
          description: Source chain ID
          example: '1151111081099710'
        fromTokenAddress:
          type: string
          description: Source token contract address
          example: '11111111111111111111111111111111'
        fromAmountBaseUnit:
          type: string
          description: Amount in base units (without decimals)
          example: '13566635'
        toChainId:
          type: string
          description: Destination chain ID
          example: '137'
        toTokenAddress:
          type: string
          description: Destination token contract address
          example: '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174'
        status:
          type: string
          description: Current status of the transaction
          enum:
            - DEPOSIT_DETECTED
            - PROCESSING
            - ORIGIN_TX_CONFIRMED
            - SUBMITTED
            - COMPLETED
            - FAILED
          example: COMPLETED
        txHash:
          type: string
          description: Transaction hash (only available when status is COMPLETED)
          example: >-
            3atr19NAiNCYt24RHM1WnzZp47RXskpTDzspJoCBBaMFwUB8fk37hFkxz35P5UEnnmWz21rb2t5wJ8pq3EE2XnxU
        createdTimeMs:
          type: number
          description: >-
            Unix timestamp in milliseconds when transaction was created (missing
            when status is DEPOSIT_DETECTED)
          example: 1757531217339