Cross Chain

Cross-Chain API endpoints

getQuotes

get

Get the quotes for a cross chain swap

Query parameters

originChainstringRequired

The source chain from which the cross-chain swap will originate. Can be specified as chain ID or name. See here for the list of supported chains

Example: 8453

destinationChainstringRequired

The destination chain where tokens will be received after the cross-chain swap. Can be specified as chain ID or name. See here for the list of supported chains

Example: 42161

sellTokenstringRequired

The contract address of the token to sell on the origin chain. Format varies by chain type (EVM address for EVM chains, token mint address for Solana)

Example: 0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf

buyTokenstringRequired

The contract address of the token to buy on the destination chain. Format varies by chain type (EVM address for EVM chains, token mint address for Solana)

Example: 0xaf88d065e77c8cc2239327c5edb3a432268e5831

sellAmountstringRequired

The amount of sellToken (in sellToken's base units) to sell on the origin chain

Example: 2570Pattern: ^-?(0|[1-9]\d*)$

originAddressstringRequired

The wallet address on the origin chain that holds the sellToken balance and will initiate the cross-chain transaction

Example: 0x56EB0aD2dC746540Fab5C02478B31e2AA9DdC38C

destinationAddressstringOptional

The wallet address on the destination chain that will receive the buyToken. If not specified, defaults to originAddress on the destination chain

Example: 0x56EB0aD2dC746540Fab5C02478B31e2AA9DdC38C

gasPayerstringOptional

The Solana address that will pay for transaction fees when the origin chain is Solana. Only applicable for Solana origin chains

slippageBpsinteger · max: 10000Optional

The maximum acceptable slippage for each swap or bridge step of the cross-chain swap in basis points (100 = 1%)

Default: 100

excludedBridgesstringOptional

Comma-separated list of bridge providers to exclude from routing

excludedSwapSourcesstringOptional

Comma-separated list of DEX sources to exclude from routing on both chains

feeBpsstringOptional

The trading fee amounts in basis points to charge on the origin chain (supports single or comma-separated values). Must be used together with feeRecipient. When multiple values are provided, must match the length of feeRecipient.

Default: ""

feeRecipientstringOptional

The wallet addresses to receive trading fees on the origin chain (supports single or comma-separated values). Must be used together with feeBps. When multiple values are provided, must match the length of feeBps.

Default: ""

feeTokenstringOptional

The EVM token addresses for fee collection on the origin chain (supports single or comma-separated values). Must be the same as sellToken. When multiple values are provided, must match the length of feeBps. If omitted, defaults to sellToken.

Default: ""

sortQuotesBystring · enumRequired

How to sort the returned quotes - either by speed (fastest execution time) or price (best exchange rate)

Example: speedPossible values:

maxNumQuotesinteger · min: 1 · max: 10Optional

The maximum number of cross-chain quotes to return, between 1 and 10. Each quote represents a different combination of bridges and DEXs

Default: 3

Header parameters

0x-api-keystringRequired

Visit dashboard.0x.org to get your API Key

Responses

200

Successful response

application/json

or

400

400 error response

application/json

500

500 error response

application/json

get

/cross-chain/quotes

HTTPcURLJavaScriptPython

GET /cross-chain/quotes?originChain=text&destinationChain=text&sellToken=text&buyToken=text&sellAmount=text&originAddress=text&sortQuotesBy=speed HTTP/1.1
Host: api.0x.org
0x-api-key: text
Accept: */*

{
  "liquidityAvailable": true,
  "originChainId": 8453,
  "originChain": "base",
  "destinationChainId": 42161,
  "destinationChain": "arbitrum",
  "sellToken": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
  "buyToken": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
  "issues": {
    "allowance": null,
    "balance": {
      "token": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
      "actual": "0",
      "expected": "2570"
    },
    "simulationIncomplete": false,
    "invalidSwapSourcesPassed": [],
    "invalidBridgesPassed": []
  },
  "zid": "0xbed7b45844099af94219ba8c",
  "quotes": [
    {
      "sellAmount": "2570",
      "buyAmount": "2972100",
      "minBuyAmount": "2942339",
      "fees": {
        "integratorFee": null,
        "zeroExFee": {
          "amount": "6",
          "token": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
          "type": "volume"
        },
        "bridgeNativeFee": null
      },
      "gasCosts": {
        "chainType": "evm",
        "gasPrice": "11550962",
        "gasLimit": "672945",
        "totalNetworkFee": "7790577030769"
      },
      "steps": [
        {
          "type": "swap",
          "chainId": 8453,
          "sellToken": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
          "buyToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
          "sellAmount": "2564",
          "buyAmount": "2979865",
          "minBuyAmount": "2950101",
          "estimatedTimeSeconds": 0
        },
        {
          "type": "bridge",
          "originChainId": 8453,
          "destinationChainId": 42161,
          "sellToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
          "buyToken": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
          "sellAmount": "2979865",
          "buyAmount": "2972100",
          "minBuyAmount": "2942339",
          "provider": "across_v3",
          "estimatedTimeSeconds": 3
        }
      ],
      "transaction": {
        "chainType": "evm",
        "details": {
          "to": "0x0000000000001ff3684f28c67538d4d072c22734",
          "data": "0x2213bc0b...",
          "gas": "672945",
          "gasPrice": "0",
          "value": "0"
        }
      },
      "estimatedTimeSeconds": 3,
      "issues": {
        "allowance": null,
        "balance": {
          "token": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
          "actual": "0",
          "expected": "2570"
        },
        "simulationIncomplete": false
      },
      "quoteId": "0xbed7b45844099af94219ba8c00000001"
    }
  ]
}

getStatus

get

Get the status of a cross chain transaction

Query parameters

originChainstringRequired

The origin chain where the cross-chain transaction was initiated

Example: 8453

originTxHashstringRequired

The transaction hash on the origin chain to track. Format varies by chain type (32-byte hex for EVM, base58 signature for Solana)

Example: 0xe347e66b1d9793a11a962c1483f9eef03272c362c41dc1f21c87577ef5ec1a7c

quoteIdstringOptional

The quote ID associated with the cross-chain transaction

Header parameters

0x-api-keystringRequired

Visit dashboard.0x.org to get your API Key

Responses

200

Successful response

application/json

statusstring · enumRequired

The current status of the cross-chain transaction

Possible values:

bridgestringOptional

The bridge provider handling the cross-chain transfer

retryTransactionany ofOptional

Transaction details for manual retry if the cross-chain operation failed or is stuck

or

zidstringRequired

The unique ZeroEx identifier for tracking this cross-chain request

400

400 error response

application/json

404

404 error response

application/json

500

500 error response

application/json

get

/cross-chain/status

HTTPcURLJavaScriptPython

GET /cross-chain/status?originChain=text&originTxHash=text HTTP/1.1
Host: api.0x.org
0x-api-key: text
Accept: */*

{
  "status": "bridge_filled",
  "bridge": "stargate",
  "steps": [
    {
      "type": "swap",
      "chainId": 8453,
      "sellToken": "0x4200000000000000000000000000000000000006",
      "buyToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "minBuyAmount": "3676900",
      "quotedBuyAmount": "3676946",
      "estimatedTimeSeconds": 0,
      "transactions": [
        {
          "chainId": 8453,
          "txHash": "0xe347e66b1d9793a11a962c1483f9eef03272c362c41dc1f21c87577ef5ec1a7c",
          "timestamp": 1754335333
        }
      ]
    },
    {
      "type": "bridge",
      "bridge": "stargate",
      "originChainId": 8453,
      "destinationChainId": 42161,
      "sellToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "buyToken": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
      "minBuyAmount": "3671000",
      "quotedBuyAmount": "3671430",
      "estimatedTimeSeconds": 15,
      "transactions": [
        {
          "chainId": 8453,
          "chain": "base",
          "txHash": "0xe347e66b1d9793a11a962c1483f9eef03272c362c41dc1f21c87577ef5ec1a7c",
          "timestamp": 1754335333
        },
        {
          "chainId": 42161,
          "chain": "arbitrum",
          "txHash": "0xb8f4da7b2f3244d1d3174687cea1b8403e263f86ead168a841caf142b491ed5b",
          "timestamp": 1754335360
        }
      ]
    }
  ],
  "failure": null,
  "transactions": [
    {
      "chainId": 8453,
      "chain": "base",
      "txHash": "0xe347e66b1d9793a11a962c1483f9eef03272c362c41dc1f21c87577ef5ec1a7c",
      "timestamp": 1754335333
    },
    {
      "chainId": 42161,
      "chain": "arbitrum",
      "txHash": "0xb8f4da7b2f3244d1d3174687cea1b8403e263f86ead168a841caf142b491ed5b",
      "timestamp": 1754335360
    }
  ],
  "zid": "0x1e452d8e6b4ce52de314dcb4"
}

listSources

get

List available swap and bridge sources for a cross chain swap

Header parameters

0x-api-keystringRequired

Visit dashboard.0x.org to get your API Key

Responses

200

Successful response

application/json

zidstringRequired

The unique ZeroEx identifier for tracking this cross-chain request

400

400 error response

application/json

500

500 error response

application/json

get

/cross-chain/sources

HTTPcURLJavaScriptPython

GET /cross-chain/sources HTTP/1.1
Host: api.0x.org
0x-api-key: text
Accept: */*

{
  "bridges": [
    {
      "name": "text",
      "chainPairs": [
        {
          "originChainId": 1,
          "destinationChainId": 1
        }
      ]
    }
  ],
  "swapSources": [
    {
      "name": "text",
      "chainIds": [
        1
      ]
    }
  ],
  "zid": "text"
}

getTxHistory

get

Get cross-chain transaction history for a user wallet address

Query parameters

userany ofRequired

The wallet address of the user to get transaction history for. Accepts both EVM (0x...) and Solana addresses

stringOptionalPattern: ^0x[a-fA-F0-9]{40}$

or

stringOptional

limitinteger · min: 1 · max: 100Optional

Maximum number of transactions to return

Default: 20

cursorstringOptional

Header parameters

0x-api-keystringRequired

Visit dashboard.0x.org to get your API Key

Responses

200

Successful response

application/json

zidstringRequired

The unique ZeroEx identifier for tracking this cross-chain request

400

400 error response

application/json

404

404 error response

application/json

500

500 error response

application/json

get

/cross-chain/tx-history-beta

HTTPcURLJavaScriptPython

GET /cross-chain/tx-history-beta?user=text HTTP/1.1
Host: api.0x.org
0x-api-key: text
Accept: */*

{
  "transactions": [
    {
      "originChain": 1,
      "originTx": "text",
      "destinationChain": 1,
      "destinationTx": "text",
      "status": "text",
      "bridge": "text"
    }
  ],
  "pagination": {
    "limit": 1,
    "nextCursor": "text",
    "hasMore": true
  },
  "zid": "text"
}

streamQuotes

get

Stream cross-chain quotes as they become available

Query parameters

originChainstringRequired

The source chain from which the cross-chain swap will originate. Can be specified as chain ID or name. See here for the list of supported chains

Example: 8453

destinationChainstringRequired

The destination chain where tokens will be received after the cross-chain swap. Can be specified as chain ID or name. See here for the list of supported chains

Example: 42161

sellTokenstringRequired

The contract address of the token to sell on the origin chain. Format varies by chain type (EVM address for EVM chains, token mint address for Solana)

Example: 0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf

buyTokenstringRequired

The contract address of the token to buy on the destination chain. Format varies by chain type (EVM address for EVM chains, token mint address for Solana)

Example: 0xaf88d065e77c8cc2239327c5edb3a432268e5831

sellAmountstringRequired

The amount of sellToken (in sellToken's base units) to sell on the origin chain

Example: 2570Pattern: ^-?(0|[1-9]\d*)$

originAddressstringRequired

The wallet address on the origin chain that holds the sellToken balance and will initiate the cross-chain transaction

Example: 0x56EB0aD2dC746540Fab5C02478B31e2AA9DdC38C

destinationAddressstringOptional

The wallet address on the destination chain that will receive the buyToken. If not specified, defaults to originAddress on the destination chain

Example: 0x56EB0aD2dC746540Fab5C02478B31e2AA9DdC38C

gasPayerstringOptional

The Solana address that will pay for transaction fees when the origin chain is Solana. Only applicable for Solana origin chains

slippageBpsinteger · max: 10000Optional

The maximum acceptable slippage for each swap or bridge step of the cross-chain swap in basis points (100 = 1%)

Default: 100

excludedBridgesstringOptional

Comma-separated list of bridge providers to exclude from routing

excludedSwapSourcesstringOptional

Comma-separated list of DEX sources to exclude from routing on both chains

feeBpsstringOptional

The trading fee amounts in basis points to charge on the origin chain (supports single or comma-separated values). Must be used together with feeRecipient. When multiple values are provided, must match the length of feeRecipient.

Default: ""

feeRecipientstringOptional

The wallet addresses to receive trading fees on the origin chain (supports single or comma-separated values). Must be used together with feeBps. When multiple values are provided, must match the length of feeBps.

Default: ""

feeTokenstringOptional

The EVM token addresses for fee collection on the origin chain (supports single or comma-separated values). Must be the same as sellToken. When multiple values are provided, must match the length of feeBps. If omitted, defaults to sellToken.

Default: ""

maxNumQuotesinteger · min: 1 · max: 10Optional

The maximum number of cross-chain quotes to return, between 1 and 10. Each quote represents a different combination of bridges and DEXs

Default: 5

Header parameters

0x-api-keystringRequired

Visit dashboard.0x.org to get your API Key

Responses

200

Successful response

application/json

A Server-Sent Event containing cross-chain quote information as it becomes available

zidstringRequired

The unique ZeroEx identifier for tracking this cross-chain request

eventany ofRequired

The streaming event containing either quote data or final result

or

400

400 error response

application/json

500

500 error response

application/json

get

/cross-chain/quotes/stream

HTTPcURLJavaScriptPython

GET /cross-chain/quotes/stream?originChain=text&destinationChain=text&sellToken=text&buyToken=text&sellAmount=text&originAddress=text HTTP/1.1
Host: api.0x.org
0x-api-key: text
Accept: */*

{
  "zid": "0xbed7b45844099af94219ba8c",
  "event": {
    "type": "quote",
    "data": {
      "quote": {
        "sellAmount": "2570",
        "buyAmount": "2972100",
        "minBuyAmount": "2942339",
        "fees": {
          "integratorFee": null,
          "zeroExFee": {
            "amount": "6",
            "token": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
            "type": "volume"
          },
          "bridgeNativeFee": null
        },
        "gasCosts": {
          "chainType": "evm",
          "gasPrice": "11550962",
          "gasLimit": "672945",
          "totalNetworkFee": "7790577030769"
        },
        "steps": [
          {
            "type": "swap",
            "chainId": 8453,
            "sellToken": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
            "buyToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
            "sellAmount": "2564",
            "buyAmount": "2979865",
            "minBuyAmount": "2950101",
            "estimatedTimeSeconds": 0
          },
          {
            "type": "bridge",
            "originChainId": 8453,
            "destinationChainId": 42161,
            "sellToken": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
            "buyToken": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
            "sellAmount": "2979865",
            "buyAmount": "2972100",
            "minBuyAmount": "2942339",
            "provider": "across_v3",
            "estimatedTimeSeconds": 3
          }
        ],
        "transaction": {
          "chainType": "evm",
          "details": {
            "to": "0x0000000000001ff3684f28c67538d4d072c22734",
            "data": "0x2213bc0b...",
            "gas": "672945",
            "gasPrice": "0",
            "value": "0"
          }
        },
        "estimatedTimeSeconds": 3,
        "issues": {
          "allowance": null,
          "balance": {
            "token": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
            "actual": "0",
            "expected": "2570"
          },
          "simulationIncomplete": false
        },
        "quoteId": "0xbed7b45844099af94219ba8c00000001"
      },
      "allowanceTarget": "0x0000000000001ff3684f28c67538d4d072c22734"
    }
  }
}