> ## Documentation Index
> Fetch the complete documentation index at: https://docs.swaps.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Status

> Retrieve the status and details of a transaction by transaction ID.



## OpenAPI

````yaml /swap-api-reference/openapi.json get /getStatus
openapi: 3.1.0
info:
  title: Swaps API
  description: >-
    The Swaps API provides instant cross-chain swap and bridge functionality for
    decentralized applications.

    It supports multiple virtual machines (EVM, Solana, Bitcoin) and various DEX
    protocols and bridge solutions.
  version: 3.0.0
  contact:
    name: Swaps.xyz
    url: https://swaps.xyz
servers:
  - url: https://api-v2.swaps.xyz/api
    description: Production server
security:
  - ApiKeyAuth: []
paths:
  /getStatus:
    get:
      summary: Get Status
      description: Retrieve the status and details of a transaction by transaction ID.
      operationId: getTransactionStatus
      parameters:
        - name: txHash
          in: query
          description: Transaction hash to query (required if txId not provided)
          required: false
          schema:
            type: string
            pattern: ^0x[a-fA-F0-9]{64}$
            example: '0xd56968cf4fede6a0773f3e6dfad7d1088aacd3994bada55d44faee9596dadff2'
        - name: txId
          in: query
          description: Transaction ID to query (required if txHash not provided)
          required: false
          schema:
            type: string
            example: '0x49b1d3d38176e45864fd55500c6c1879ab318609e1ed0c8eb9abd818e6c811fd'
        - name: chainId
          in: query
          description: Source chain ID for the transaction (optional but recommended)
          required: false
          schema:
            type: integer
            example: 1
      responses:
        '200':
          description: Transaction status response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TxDetails'
      servers:
        - url: https://api-v2.swaps.xyz/api
          description: Core Swap API server
components:
  schemas:
    TxDetails:
      allOf:
        - $ref: '#/components/schemas/TxStatus'
        - type: object
          properties:
            org:
              nullable: true
              allOf:
                - $ref: '#/components/schemas/Org'
            usdValue:
              type: number
              nullable: true
              description: USD value of the transaction
              example: 100.5
            srcTx:
              $ref: '#/components/schemas/OnchainTx'
            dstTx:
              $ref: '#/components/schemas/OnchainTx'
    TxStatus:
      type: object
      properties:
        status:
          type: string
          enum:
            - success
            - pending
            - requires refund
            - refunded
            - failed
          description: Status of the transaction
          example: success
        sender:
          type: string
          pattern: ^0x[a-fA-F0-9]{40}$
          description: Sender wallet address
          example: '0x1234567890123456789012345678901234567890'
        srcChainId:
          type: integer
          description: Source chain ID
          example: 1
        dstChainId:
          type: integer
          description: Destination chain ID
          example: 42161
        srcTxHash:
          type: string
          pattern: ^0x[a-fA-F0-9]{64}$
          description: Source transaction hash
          example: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef'
        dstTxHash:
          type: string
          pattern: ^0x[a-fA-F0-9]{64}$
          description: Destination transaction hash
          example: '0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890'
        bridgeDetails:
          $ref: '#/components/schemas/BridgeDetails'
        txId:
          type: string
          description: Unique transaction identifier
          example: '0x49b1d3d38176e45864fd55500c6c1879ab318609e1ed0c8eb9abd818e6c811fd'
        actionRequest:
          $ref: '#/components/schemas/ActionRequest'
          description: Original action request parameters
        actionResponse:
          $ref: '#/components/schemas/ActionResponse'
          description: Original action response data
        workflow:
          allOf:
            - $ref: '#/components/schemas/WorkflowData'
          nullable: true
          description: >-
            Workflow information if transaction is associated with a workflow
            (only present if the transaction had a workflow)
    Org:
      type: object
      properties:
        appId:
          type: string
          description: Application ID
          example: '0xb38801d6'
        appName:
          type: string
          description: Application name
          example: Box Examples / Scenarios
        affiliateId:
          type: string
          description: Affiliate ID
          example: '0x00000000'
      required:
        - appId
        - affiliateId
    OnchainTx:
      type: object
      properties:
        toAddress:
          type: string
          pattern: ^0x[a-fA-F0-9]{40}$
          description: Recipient address
          example: '0x38630c8ec92494cf96ded12060d8136b75e7a8b5'
        txHash:
          type: string
          pattern: ^0x[a-fA-F0-9]{64}$
          description: Transaction hash
          example: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef'
        chainId:
          type: integer
          description: Chain ID
          example: 1
        value:
          type: string
          description: Transaction value as string (may include bigint notation like '0n')
          example: 0n
        timestamp:
          type: integer
          description: Unix timestamp in seconds
          example: 1765593607
        paymentToken:
          $ref: '#/components/schemas/Token'
        revertReason:
          type: string
          nullable: true
          description: Revert reason if transaction failed, null otherwise
    BridgeDetails:
      type: object
      properties:
        isBridge:
          type: boolean
          description: Whether this transaction involves bridging
          example: true
        bridgeTime:
          type: number
          nullable: true
          description: Bridge time in seconds (null if not a bridge)
          example: 420
        txPath:
          type: array
          items:
            $ref: '#/components/schemas/TxNode'
          description: Transaction path through different chains
      required:
        - isBridge
        - bridgeTime
        - txPath
    ActionRequest:
      type: object
      properties:
        actionType:
          $ref: '#/components/schemas/ActionType'
          description: Type of action to perform
        sender:
          $ref: '#/components/schemas/Address'
          description: The address of the sender/user
        srcChainId:
          $ref: '#/components/schemas/ChainId'
          description: Source chain ID
        srcToken:
          $ref: '#/components/schemas/Address'
          description: Source token address
        dstChainId:
          $ref: '#/components/schemas/ChainId'
          description: Destination chain ID
        dstToken:
          $ref: '#/components/schemas/Address'
          description: Destination token address
        slippage:
          type: number
          format: float
          minimum: 0
          maximum: 10000
          description: Slippage tolerance in bps
        amount:
          type: string
          pattern: ^[0-9]$
          description: The exact in or exact out amount of the swap
        swapDirection:
          $ref: '#/components/schemas/SwapDirection'
          description: Swap direction for the action
        recipient:
          $ref: '#/components/schemas/Address'
          description: Address to receive the swapped tokens
        to:
          $ref: '#/components/schemas/Address'
          description: The EVM address of the target contract (20 bytes hex)
        data:
          $ref: '#/components/schemas/Hex'
          description: Calldata for the transaction
        value:
          type: string
          pattern: ^[0-9]$
          description: Value to send with transaction
        erc20Amount:
          type: string
          pattern: ^[0-9]$
          description: The amount of Erc20 being transferred
        erc20Spender:
          $ref: '#/components/schemas/Address'
          description: The Erc20 spender requiring approval for the transaction call
        bridgeIds:
          type: array
          items:
            $ref: '#/components/schemas/BridgeId'
          description: Specific bridge protocols to use
        refundTo:
          $ref: '#/components/schemas/Address'
          description: Alternate address to receive refunds
        appFees:
          type: array
          items:
            $ref: '#/components/schemas/AppFee'
          maxItems: 2
          description: Application fees configuration
      required:
        - actionType
        - sender
        - srcChainId
        - srcToken
        - dstChainId
        - dstToken
        - slippage
    ActionResponse:
      type: object
      required:
        - tx
        - txId
        - vmId
        - amountIn
        - amountInMax
        - amountOutMin
        - amountOut
        - protocolFee
        - applicationFee
        - exchangeRate
        - estimatedTxTime
        - estimatedPriceImpact
        - allRoutes
        - requiresTokenApproval
        - requiresRegisterTransaction
      properties:
        tx:
          oneOf:
            - $ref: '#/components/schemas/EvmTransaction'
              title: EVM Transaction
            - $ref: '#/components/schemas/SerializedSolTransaction'
              title: Solana Transaction
            - $ref: '#/components/schemas/AltVmTransaction'
              title: Alt VM Transaction
            - $ref: '#/components/schemas/HyperCoreTransaction'
              title: HyperCore Transaction
          description: Transaction data for execution
        txId:
          $ref: '#/components/schemas/Hex'
          description: Transaction ID
        vmId:
          type: string
          enum:
            - evm
            - solana
            - alt-vm
            - hypercore
          description: Virtual machine identifier.
        amountIn:
          $ref: '#/components/schemas/Payment'
          description: >-
            Expected amount to input (exclusive of slippage - recommended value
            to display in frontend)
        amountInMax:
          $ref: '#/components/schemas/Payment'
          description: Maximum amount to input (inclusive of slippage)
        amountOut:
          $ref: '#/components/schemas/Payment'
          description: >-
            Expected amount delivered to users (exclusive of slippage -
            recommended value to display in frontend)
        amountOutMin:
          $ref: '#/components/schemas/Payment'
          description: Minimum amount delivered to users (inclusive of slippage)
        protocolFee:
          $ref: '#/components/schemas/Payment'
          description: Swaps.xyz fee
        applicationFee:
          $ref: '#/components/schemas/Payment'
          description: Application fee (your fee!)
        bridgeFee:
          $ref: '#/components/schemas/Payment'
          description: Bridge fee (from aggregated providers)
        bridgeIds:
          type: array
          items:
            $ref: '#/components/schemas/BridgeId'
          description: Bridge IDs used in the route.
        bridgeRoute:
          $ref: '#/components/schemas/BridgeRoute'
          description: >-
            Bridge route information (src chain + token, dst chain + token,
            BridgeId)
        exchangeRate:
          type: number
          format: float
          description: Exchange rate for the swap.
        estimatedTxTime:
          type: number
          format: float
          description: Estimated transaction time in seconds.
        estimatedPriceImpact:
          type: number
          format: float
          description: Estimated price impact percentage.
        requiresTokenApproval:
          type: boolean
          description: >-
            Flag indicating whether the transaction object requires a source
            token approval check.
        requiresRegisterTransaction:
          type: boolean
          description: >-
            Flag indicating whether the transaction requires registration via
            the registerTxs endpoint. Mandatory for non-EVM transactions.
        allRoutes:
          type: array
          items:
            $ref: '#/components/schemas/BaseActionResponse'
          description: All available routes for the action.
        executionsType:
          type: string
          enum:
            - DEFAULT
            - GASLESS
          description: >-
            Indicates the execution mode. `GASLESS` when `gasless=true` was
            requested and a relay provider is available; `DEFAULT` otherwise.
        executions:
          type: array
          items:
            $ref: '#/components/schemas/Execution'
          description: >-
            Ordered list of signing steps the client must complete before
            calling `POST /submitTx`. Only present when `executionsType` is
            `GASLESS`.
        relayerFee:
          $ref: '#/components/schemas/Payment'
          description: >-
            Fee charged by the relay provider, denominated in USDT. If non-zero,
            the user must hold USDT in addition to the source token. Only
            present when `executionsType` is `GASLESS`.
    WorkflowData:
      type: object
      required:
        - name
        - operation
        - status
        - timestamp
        - data
      properties:
        name:
          type: string
          description: Workflow name
          example: polymarket
        operation:
          type: string
          description: Operation type
          example: placeOrder
        status:
          type: string
          description: Workflow status
          example: success
        timestamp:
          type: integer
          description: Unix timestamp when workflow was executed
          example: 1763996274
        data:
          oneOf:
            - $ref: '#/components/schemas/PolyMarketWorkflowData'
              title: Polymarket Data
            - title: Generic Workflow Data
              type: object
              additionalProperties: true
          description: Workflow-specific data
    Token:
      type: object
      properties:
        name:
          type: string
          description: Token name
          example: Ethereum
        symbol:
          type: string
          description: Token symbol
          example: ETH
        decimals:
          type: integer
          description: Token decimals
          example: 18
        amount:
          type: string
          description: Token amount as bigint string
          example: '1000000000000000000'
        address:
          type: string
          pattern: ^0x[a-fA-F0-9]{40}$
          description: Token contract address
          example: '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174'
        chainId:
          type: integer
          description: Chain ID for the token
          example: 137
        isNative:
          type: boolean
          description: Whether the token is the native gas token
          example: false
        usdAmount:
          type: number
          description: USD value of the token amount
          example: 4.00687776
      required:
        - name
        - symbol
        - decimals
        - amount
        - address
        - chainId
        - isNative
    TxNode:
      type: object
      properties:
        chainId:
          type: integer
          description: Chain ID for this step
          example: 1
        txHash:
          type: string
          pattern: ^0x[a-fA-F0-9]{64}$
          description: Transaction hash for this step
          example: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef'
        timestamp:
          type: string
          description: Timestamp as bigint string
          example: '1640995200000000000'
        nextBridge:
          type: string
          description: Bridge type for the next hop
          example: layerZero
    ActionType:
      type: string
      enum:
        - swap-action
        - evm-calldata-tx
        - polymarket
      description: Type of action to perform.
    Address:
      type: string
      description: >-
        Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or
        AltVmAddress.
    ChainId:
      type: integer
      description: Chain ID. Find in the list of supported networks.
    SwapDirection:
      type: string
      enum:
        - exact-amount-in
        - exact-amount-out
      description: Swap direction for the action.
    Hex:
      type: string
      pattern: ^0x[a-fA-F0-9]*$
      description: Hex string with 0x prefix
    BridgeId:
      type: string
      description: Bridge protocol identifier (e.g. "across", "relay", "mayan").
    AppFee:
      type: object
      required:
        - bps
        - receiverAddress
      properties:
        bps:
          type: number
          description: Fee in basis points
        receiverAddress:
          $ref: '#/components/schemas/EvmAddress'
          description: EVM address to receive the fee
    EvmTransaction:
      type: object
      required:
        - to
        - data
        - value
      properties:
        to:
          $ref: '#/components/schemas/EvmAddress'
        data:
          $ref: '#/components/schemas/Hex'
        value:
          type: string
          pattern: ^[0-9]+$
          description: Value in wei as string
        chainId:
          $ref: '#/components/schemas/ChainId'
    SerializedSolTransaction:
      type: object
      required:
        - base64Tx
        - recentBlockhash
        - payer
      properties:
        base64Tx:
          type: string
          description: Base64-encoded transaction
        recentBlockhash:
          type: string
          description: Recent blockhash for transaction validity
        payer:
          $ref: '#/components/schemas/SolanaAddress'
          description: PublicKey who pays fees
    AltVmTransaction:
      type: object
      required:
        - to
        - toExtra
        - value
        - chainId
        - chainKey
      properties:
        to:
          $ref: '#/components/schemas/ExchangeAddress'
          description: Exchange address
        toExtra:
          type: string
          nullable: true
          description: Additional address information (e.g., memo, tag). Can be null.
        value:
          type: string
          pattern: ^[0-9]+$
          description: Value as string
        chainId:
          $ref: '#/components/schemas/ChainId'
        chainKey:
          type: string
          description: Chain key identifier
    HyperCoreTransaction:
      type: object
      required:
        - type
        - destination
        - amount
        - chainId
      properties:
        type:
          $ref: '#/components/schemas/HyperCoreAction'
        destination:
          type: string
          description: Destination address
        amount:
          type: string
          description: Amount to transfer
        chainId:
          $ref: '#/components/schemas/ChainId'
          description: Chain ID. 1337 for HyperCore
    Payment:
      allOf:
        - $ref: '#/components/schemas/TokenInfo'
        - type: object
          required:
            - amount
          properties:
            amount:
              type: string
              pattern: ^[0-9]+$
            usdAmount:
              type: number
              format: float
              description: USD value of the payment amount
    BridgeRoute:
      type: array
      items:
        $ref: '#/components/schemas/BridgeStep'
      description: Array of bridge steps
    BaseActionResponse:
      type: object
      required:
        - tx
        - txId
        - amountIn
        - vmId
        - amountInMax
        - amountOutMin
        - amountOut
        - protocolFee
        - applicationFee
        - exchangeRate
        - estimatedTxTime
        - estimatedPriceImpact
        - requiresRegisterTransaction
      properties:
        tx:
          oneOf:
            - $ref: '#/components/schemas/EvmTransaction'
              title: EVM Transaction
            - $ref: '#/components/schemas/SerializedSolTransaction'
              title: Solana Transaction
            - $ref: '#/components/schemas/AltVmTransaction'
              title: Alt VM Transaction
            - $ref: '#/components/schemas/HyperCoreTransaction'
              title: HyperCore Transaction
          description: Transaction data for execution
        txId:
          $ref: '#/components/schemas/Hex'
          description: Transaction ID
        vmId:
          type: string
          enum:
            - evm
            - solana
            - alt-vm
            - hypercore
          description: Virtual machine identifier.
        amountIn:
          $ref: '#/components/schemas/Payment'
          description: >-
            Expected amount to input (exclusive of slippage - recommended value
            to display in frontend)
        amountInMax:
          $ref: '#/components/schemas/Payment'
          description: Maximum amount to input (inclusive of slippage)
        amountOut:
          $ref: '#/components/schemas/Payment'
          description: >-
            Expected amount delivered to users (exclusive of slippage -
            recommended value to display in frontend)
        amountOutMin:
          $ref: '#/components/schemas/Payment'
          description: Minimum amount delivered to users (inclusive of slippage)
        protocolFee:
          $ref: '#/components/schemas/Payment'
          description: Swaps.xyz fee
        applicationFee:
          $ref: '#/components/schemas/Payment'
          description: Application fee (your fee!)
        bridgeFee:
          $ref: '#/components/schemas/Payment'
          description: Bridge fee (from aggregated providers)
        bridgeIds:
          type: array
          items:
            $ref: '#/components/schemas/BridgeId'
          description: Bridge IDs used in the route.
        bridgeRoute:
          $ref: '#/components/schemas/BridgeRoute'
          description: >-
            Bridge route information (src chain + token, dst chain + token,
            BridgeId)
        exchangeRate:
          type: number
          format: float
          description: Exchange rate for the swap.
        estimatedTxTime:
          type: number
          format: float
          description: Estimated transaction time in seconds.
        estimatedPriceImpact:
          type: number
          format: float
          description: Estimated price impact percentage.
        requiresRegisterTransaction:
          type: boolean
          description: >-
            Flag indicating whether the transaction requires registration via
            the registerTxs endpoint. Mandatory for non-EVM transactions.
        executionsType:
          type: string
          enum:
            - DEFAULT
            - GASLESS
          description: >-
            Indicates the execution mode. `GASLESS` when `gasless=true` was
            requested and a relay provider is available; `DEFAULT` otherwise.
        executions:
          type: array
          items:
            $ref: '#/components/schemas/Execution'
          description: >-
            Ordered list of signing steps the client must complete before
            calling `POST /submitTx`. Only present when `executionsType` is
            `GASLESS`.
        relayerFee:
          $ref: '#/components/schemas/Payment'
          description: >-
            Fee charged by the relay provider, denominated in USDT. If non-zero,
            the user must hold USDT in addition to the source token. Only
            present when `executionsType` is `GASLESS`.
    Execution:
      description: >-
        A single signing step returned in the `executions` array of a gasless
        `getAction` response. Only available for Tron same-chain swaps. The
        client must sign each item in order and include the signatures when
        calling `POST /submitTx`.
      oneOf:
        - $ref: '#/components/schemas/EvmTransactionSignExecution'
        - $ref: '#/components/schemas/EvmSignTypedDataExecution'
      discriminator:
        propertyName: txType
        mapping:
          evmTransactionSign:
            $ref: '#/components/schemas/EvmTransactionSignExecution'
          evmSignTypedData:
            $ref: '#/components/schemas/EvmSignTypedDataExecution'
    PolyMarketWorkflowData:
      type: object
      required:
        - userId
        - orderRequest
        - orderResponse
      properties:
        userId:
          type: string
          description: Polymarket user ID
          example: '0x0797bfec6d2d4f733d461bbee8125805e9e9c892'
        orderRequest:
          $ref: '#/components/schemas/PolymarketOrderRequest'
        orderResponse:
          oneOf:
            - $ref: '#/components/schemas/PolymarketOpenOrder'
              title: Open Order
            - title: Error Response
              type: object
              required:
                - error
                - status
              properties:
                error:
                  type: string
                  description: Error message
                status:
                  type: string
                  description: Order status
          description: Order response from Polymarket
        relayTx:
          type: object
          nullable: true
          properties:
            txHash:
              type: string
              pattern: ^0x[a-fA-F0-9]{64}$
              description: Transaction hash of the relay transaction
            status:
              type: string
              description: Status of the relay transaction
          description: Relay transaction details (null if not applicable)
    EvmAddress:
      type: string
      pattern: ^0x[a-fA-F0-9]{40}$
      description: EVM address (0x prefix + 40 hex characters)
    SolanaAddress:
      type: string
      pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
      description: Solana public key (base58 encoded, 32-44 characters)
    ExchangeAddress:
      type: string
      description: Exchange address format
    HyperCoreAction:
      type: string
      enum:
        - usdSend
      description: HyperCore action type
    TokenInfo:
      type: object
      required:
        - chainId
        - address
        - name
        - symbol
        - decimals
        - isNative
      properties:
        chainId:
          $ref: '#/components/schemas/ChainId'
          description: Chain ID for the token
        address:
          $ref: '#/components/schemas/Address'
          description: Token address
        name:
          type: string
          description: Token name
        symbol:
          type: string
          description: Token symbol
        decimals:
          type: integer
          description: Token decimals
        isNative:
          type: boolean
          description: Boolean flag for whether token is the chain's gas token.
        logo:
          type: string
          nullable: true
          description: URL to the token's logo image. Can be null if logo is not available.
        swapsXyzCode:
          type: string
          description: Internal Swaps.xyz token identifier code.
    BridgeStep:
      type: object
      required:
        - srcChainId
        - dstChainId
        - srcBridgeToken
        - dstBridgeToken
        - bridgeId
      properties:
        srcChainId:
          $ref: '#/components/schemas/ChainId'
        dstChainId:
          $ref: '#/components/schemas/ChainId'
        srcBridgeToken:
          $ref: '#/components/schemas/Address'
        dstBridgeToken:
          $ref: '#/components/schemas/Address'
        bridgeId:
          $ref: '#/components/schemas/BridgeId'
    EvmTransactionSignExecution:
      type: object
      required:
        - txType
        - data
        - signature
      properties:
        txType:
          type: string
          enum:
            - evmTransactionSign
        data:
          type: string
          description: >-
            JSON string of an unsigned Tron transaction (TronWeb `raw_data`
            shape)
        signature:
          type: string
          description: Hex-encoded signature from TronLink or compatible Tron wallet
    EvmSignTypedDataExecution:
      type: object
      required:
        - txType
        - data
        - signature
      properties:
        txType:
          type: string
          enum:
            - evmSignTypedData
        data:
          description: >-
            EIP-712 typed data to sign. Accepted as either a JSON string (same
            format returned by `GET /getAction`) or a parsed object — both are
            equivalent.
          oneOf:
            - type: string
              description: JSON-encoded EIP-712 typed data
            - $ref: '#/components/schemas/Eip712Data'
        signature:
          type: string
          description: Hex-encoded EIP-712 signature
    PolymarketOrderRequest:
      type: object
      required:
        - side
        - tokenID
        - orderType
        - feeRateBps
        - slippage
        - tickSize
        - negRisk
      properties:
        side:
          type: string
          enum:
            - BUY
            - SELL
          description: Order side
        tokenID:
          type: string
          description: Polymarket CLOB token ID
          example: >-
            110902308091723190012269532299497167125504426554890434343419495764557291673806
        orderType:
          type: string
          enum:
            - FOK
            - FAK
            - GTC
            - GTD
          description: Order type (FOK/FAK are market orders, GTC/GTD are limit orders)
        feeRateBps:
          type: number
          minimum: 0
          description: Fee rate in basis points
          example: 0
        slippage:
          type: number
          description: Slippage tolerance in basis points
          example: 100
        tickSize:
          type: string
          enum:
            - '0.01'
            - '0.001'
            - '0.0001'
          description: Price tick size
        negRisk:
          type: boolean
          description: Negative risk flag
        amount:
          type: number
          description: Amount for market orders (FOK/FAK)
          example: 5
        price:
          type: number
          minimum: 0
          maximum: 1
          description: >-
            Price per share (0-1) - required for limit orders, optional for
            market orders
          example: 0.021
        size:
          type: number
          minimum: 0
          description: Number of shares for limit orders
          example: 5
    PolymarketOpenOrder:
      type: object
      required:
        - id
        - status
        - owner
        - maker_address
        - market
        - asset_id
        - side
        - original_size
        - size_matched
        - price
        - outcome
        - created_at
        - expiration
        - order_type
        - associate_trades
      properties:
        id:
          type: string
          description: Order ID
          example: '0xbd2f3c625c1f6f918a74e8645c3afee9e8f2c5adf91f178efa5e1b65f74fb489'
        status:
          type: string
          description: Order status
          example: MATCHED
        owner:
          type: string
          description: Owner ID
          example: 258f7485-b93f-52e5-2327-a53c49a299c1
        maker_address:
          type: string
          pattern: ^0x[a-fA-F0-9]{40}$
          description: Maker address
          example: '0xBEDcAD563ddf52391573a016Bc5EC7A334Eec756'
        market:
          type: string
          description: Market ID
          example: '0xb050c89e1e5738c79e117d28da1f057ac2f193511aab87a01b517b466c7265dc'
        asset_id:
          type: string
          description: Asset ID (token ID)
          example: >-
            110902308091723190012269532299497167125504426554890434343419495764557291673806
        side:
          type: string
          enum:
            - BUY
            - SELL
          description: Order side
        original_size:
          type: string
          description: Original order size
          example: '5'
        size_matched:
          type: string
          description: Size matched
          example: '0'
        price:
          type: string
          description: Order price
          example: '0.02'
        outcome:
          type: string
          description: Order outcome
          example: 'No'
        expiration:
          type: string
          description: Expiration timestamp
          example: '1763996360'
        order_type:
          type: string
          description: Order type
          example: GTD
        associate_trades:
          type: array
          items:
            type: string
          description: Associated trade IDs
        created_at:
          type: integer
          description: Unix timestamp when order was created
          example: 1763996291
    Eip712Data:
      type: object
      required:
        - domain
        - types
        - message
      properties:
        domain:
          $ref: '#/components/schemas/Eip712Domain'
        types:
          type: object
          description: EIP-712 type definitions (field name → array of {name, type} pairs)
          additionalProperties:
            type: array
            items:
              type: object
              properties:
                name:
                  type: string
                type:
                  type: string
        message:
          type: object
          description: The typed data message payload
          additionalProperties: true
    Eip712Domain:
      type: object
      required:
        - name
        - version
        - chainId
        - verifyingContract
      properties:
        name:
          type: string
          description: EIP-712 domain name
        version:
          type: string
          description: EIP-712 domain version
        chainId:
          type: integer
          description: Chain ID the typed data is bound to
        verifyingContract:
          type: string
          description: Address of the contract verifying the signature
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: 'Limited demo key for API Reference: `5c951bc81da566bbd030ba8e20724063`.'

````