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

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

By passing in the params, you will receive all available quotes for the trade from our supported DEXes

get

/v1/{chainId}/quote/single

Path parameters

chainIdnumber · enumrequired

Chain id of the network

Example: 56

Options: 1, 137, 56, 43114, 250, 10, 42161, 8453

Query parameters

fromTokenAddressstringrequired

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

Example: 0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c

toTokenAddressstringrequired

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

Example: 0x55d398326f99059fF775485246999027B3197955

amountstringrequired

Amount of tokens being traded

Example: 1000000000000000000

senderstring

The address of the sender, if you want to estimate gas

Example: 0x54c47034887C582Fc1Af4a9a3b68180a8a9eF2d2

slippagenumber

The maximum slippage allowed for the quote, in decimal form. Defaults to 0.005, which means 0.5% slippage.

Example: 0.005

deadlinenumber

The timestamp of the transaction deadline.

Example: 1684459981

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, with 2 decimals

Example:

slippageProtectionPercentagenumber

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

Example: 0.5

disableEstimateboolean

Disable estimate gas, by default, is set to true. If you want to obtain estimated gas for the quote in this API, set disableEstimate to false. NOTE: The estimated gas value provided here may not be accurate and should only be used for displaying predicted gas on the UI. For sending transactions, please use the estimateGas function in the /swap API.

isSplitboolean

Whether split trade is enabled. Default is true.

isExactOutboolean

Whether it is an exact out trade.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/trade/v1/{chainId}/quote/single?fromTokenAddress=text&toTokenAddress=text&amount=text'

200

200

[
  {
    "fromTokenAmount": "1000000000000000000",
    "toTokenAmount": "275769482468993100000",
    "deltaAmount": "274390635056648134500",
    "tradeType": 0,
    "nativeValue": "0",
    "gasPrice": "56442235035",
    "estimateGas": "11231133211313",
    "estimateGasError": "Execution reverted",
    "protocol": [
      {
        "name": "0x",
        "logo": "https://s2.coinmarketcap.com/static/img/exchanges/64x64/1107.png",
        "percentage": 100,
        "route": [
          "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
          "0x55d398326f99059ff775485246999027b3197955"
        ]
      }
    ],
    "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 best quote for the given trade parameters.