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

Authorizations

X-Api-Key

HTTPRequired

[just text field] Please enter token in following format: Bearer

Path parameters

chainIdnumber · enumRequired

The chain ID of the chain to quote on.

Example: 137Possible values:

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: 43114Possible values:

senderstringRequired

The address of the sender.

Example: 0x54c47034887C582Fc1Af4a9a3b68180a8a9eF2d2

receiverstringOptional

The address of the receiver of the funds.

Example: bc1qf7cd6pvs9sqnkr0nadsuhgecy8prnc9t8k0jny

slippagenumberOptional

The maximum slippage percentage allowed.

Example: 0.005

deadlinenumberOptional

The timestamp of the transaction deadline.

Example: 1685541105

excludedDexesstringOptional

List of dexes excluded by chain

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

priceImpactProtectionPercentagenumberOptional

The percentage of price impact protection, from 0 to 1

Example: 0.5

feePercentagenumberOptional

The fee percentage, from 0 to 1

slippageProtectionPercentagenumberOptional

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

Example: 0.5

disableEstimatebooleanOptional

Disable estimate gas, default is true.

isExactOutbooleanOptional

Whether it is an exact out trade.

isSplitbooleanOptional

Whether split trade is enabled. Default is true.

Responses

200

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

application/json

get

/v1/{chainId}/quote/cross

HTTPcURLJavaScriptPython

GET /trade/v1/{chainId}/quote/cross?fromTokenAddress=text&toTokenAddress=text&amount=text&destinationChainId=1&sender=text HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

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

[
  {
    "srcTradeList": [
      {}
    ],
    "dstTradeList": [
      {}
    ],
    "srcTrade": {
      "fromTokenAmount": "26031659637168024367",
      "toTokenAmount": "26031659637168024367",
      "deltaAmount": "26083722956442360416",
      "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
      },
      "protocol": [
        {}
      ],
      "transactionData": {
        "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,
          "path": false,
          "v3Path": false
        },
        "amountInfo": {
          "amount": "26031659637168024367",
          "actualQuote": "26031659637168024367"
        },
        "call": [
          "text"
        ]
      }
    },
    "dstTrade": {
      "fromTokenAmount": "26031659637168024367",
      "toTokenAmount": "26031659637168024367",
      "deltaAmount": "26083722956442360416",
      "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
      },
      "protocol": [
        {}
      ],
      "transactionData": {
        "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,
          "path": false,
          "v3Path": false
        },
        "amountInfo": {
          "amount": "26031659637168024367",
          "actualQuote": "26031659637168024367"
        },
        "call": [
          "text"
        ]
      }
    },
    "transactionData": {},
    "nativeValue": "29422186306758765852",
    "nativeFee": "1070050644652846329",
    "processingTime": 1000,
    "tradeProtocol": "CROSS_CHAIN_CELER",
    "crossChainTradeQuotesType": "TRADE_ON_BOTH",
    "sourceChainId": 137,
    "destinationChainId": 43114,
    "contractVersion": "V1",
    "providerInfo": {
      "name": "Celer",
      "contractVersion": "v2",
      "logo": "https://api.zcx.com/data/logo/interoperability-provider/cbridge.svg"
    },
    "estimateGas": "11231133211313",
    "estimateGasError": "Execution reverted",
    "gasPrice": "56442235035"
  }
]