GET /trade/v1/{chainId}/quote/cross

Find all available quotes for cross-chain trade via Unizen DEX Aggregator

Get the best quote for a cross chain trade.

get

/v1/{chainId}/quote/cross

Authorizations

Path parameters

chainIdnumber · enumrequired

The chain ID of the chain to quote on.

Example: 137

Options: 1, 137, 56, 43114, 250, 10, 42161, 8453, -3980891822, -174457306, -33463083, -3143381382

Query parameters

fromTokenAddressstringrequired

The address of the token being traded. If native, use address zero.

Example: 0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270

toTokenAddressstringrequired

The address of the token to receive in exchange. If native, use address zero.

Example: 0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7

amountstringrequired

Amount of tokens being traded

Example: 10000000000000000000

destinationChainIdnumber · enumrequired

The chain ID of the destination network.

Example: 43114

Options: 1, 137, 56, 43114, 250, 10, 42161, 8453, -3980891822, -174457306, -33463083, -3143381382

senderstringrequired

The address of the sender.

Example: 0x54c47034887C582Fc1Af4a9a3b68180a8a9eF2d2

receiverstring

The address of the receiver of the funds.

Example: bc1qf7cd6pvs9sqnkr0nadsuhgecy8prnc9t8k0jny

slippagenumber

The maximum slippage percentage allowed.

Example: 0.005

deadlinenumber

The timestamp of the transaction deadline.

Example: 1685541105

excludedDexesstring

List of dexes excluded by chain

Example: {"1":["0x0000000000000"]}

priceImpactProtectionPercentagenumber

The percentage of price impact protection, from 0 to 1

Example: 0.5

feePercentagenumber

The fee percentage, from 0 to 1

Example:

slippageProtectionPercentagenumber

The percentage of slippage protection, from 0 to 1, default 0.5

Example: 0.5

disableEstimateboolean

Disable estimate gas, default is true.

isExactOutboolean

Whether it is an exact out trade.

isSplitboolean

Whether split trade is enabled. Default is true.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/trade/v1/{chainId}/quote/cross?fromTokenAddress=text&toTokenAddress=text&amount=text&destinationChainId=1&sender=text' \
  --header 'Authorization: Bearer Bearer'

200

200

[
  {
    "transactionData": {},
    "nativeValue": "29422186306758765852",
    "nativeFee": "1070050644652846329",
    "processingTime": 1000,
    "tradeProtocol": "CROSS_CHAIN_CELER",
    "crossChainTradeQuotesType": "TRADE_ON_BOTH",
    "sourceChainId": 137,
    "destinationChainId": 43114,
    "contractVersion": "V1",
    "estimateGas": "11231133211313",
    "estimateGasError": "Execution reverted",
    "gasPrice": "56442235035",
    "srcTradeList": [
      {}
    ],
    "dstTradeList": [
      {}
    ],
    "providerInfo": {
      "name": "Celer",
      "contractVersion": "v2",
      "logo": "https://api.zcx.com/data/logo/interoperability-provider/cbridge.svg"
    },
    "srcTrade": {
      "fromTokenAmount": "26031659637168024367",
      "toTokenAmount": "26031659637168024367",
      "deltaAmount": "26083722956442360416",
      "protocol": [
        {}
      ],
      "tokenFrom": {
        "name": "ZCX",
        "symbol": "ZCX",
        "decimals": 18,
        "contractAddress": "0xc52c326331e9ce41f04484d3b5e5648158028804",
        "priceInUsd": 0.1,
        "chainId": 1,
        "buyTax": 0,
        "sellTax": 0
      },
      "tokenTo": {
        "name": "ZCX",
        "symbol": "ZCX",
        "decimals": 18,
        "contractAddress": "0xc52c326331e9ce41f04484d3b5e5648158028804",
        "priceInUsd": 0.1,
        "chainId": 1,
        "buyTax": 0,
        "sellTax": 0
      },
      "transactionData": {
        "call": [
          "text"
        ],
        "info": {
          "amountIn": "26031659637168024367",
          "amountOutMin": "26031659637168024367",
          "amountInMax": "26083722956442360416",
          "amountOut": "26083722956442360416",
          "actualQuote": "26083722956442360416",
          "srcToken": "text",
          "dstToken": "text",
          "uuid": "text",
          "apiId": "text",
          "userPSFee": 0,
          "deadline": 1684251,
          "tradeType": 0,
          "slippage": 0.1,
          "feePercent": 0,
          "sharePercent": 0,
          "tokenHasTaxes": false,
          "v3Path": false,
          "path": false
        },
        "amountInfo": {
          "amount": "26031659637168024367",
          "actualQuote": "26031659637168024367"
        }
      }
    },
    "dstTrade": {
      "fromTokenAmount": "26031659637168024367",
      "toTokenAmount": "26031659637168024367",
      "deltaAmount": "26083722956442360416",
      "protocol": [
        {}
      ],
      "tokenFrom": {
        "name": "ZCX",
        "symbol": "ZCX",
        "decimals": 18,
        "contractAddress": "0xc52c326331e9ce41f04484d3b5e5648158028804",
        "priceInUsd": 0.1,
        "chainId": 1,
        "buyTax": 0,
        "sellTax": 0
      },
      "tokenTo": {
        "name": "ZCX",
        "symbol": "ZCX",
        "decimals": 18,
        "contractAddress": "0xc52c326331e9ce41f04484d3b5e5648158028804",
        "priceInUsd": 0.1,
        "chainId": 1,
        "buyTax": 0,
        "sellTax": 0
      },
      "transactionData": {
        "call": [
          "text"
        ],
        "info": {
          "amountIn": "26031659637168024367",
          "amountOutMin": "26031659637168024367",
          "amountInMax": "26083722956442360416",
          "amountOut": "26083722956442360416",
          "actualQuote": "26083722956442360416",
          "srcToken": "text",
          "dstToken": "text",
          "uuid": "text",
          "apiId": "text",
          "userPSFee": 0,
          "deadline": 1684251,
          "tradeType": 0,
          "slippage": 0.1,
          "feePercent": 0,
          "sharePercent": 0,
          "tokenHasTaxes": false,
          "v3Path": false,
          "path": false
        },
        "amountInfo": {
          "amount": "26031659637168024367",
          "actualQuote": "26031659637168024367"
        }
      }
    }
  }
]

The response is an array of objects, with each object representing one provider. Currently, we support two interoperable providers for cross-chain transactions: Stargate, Celer