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/trade/v1/{chainId}/quote/single

Path parameters

chainId*enum

Chain id of the network

Example: 56

1137564311425010421618453

Query parameters

Response

200

The best quote for the given trade parameters.

Body

application/json

fromTokenAmount*string

The amount of the token being traded

Example: "1000000000000000000"

toTokenAmount*string

The amount of the token to receive in exchange

Example: "275769482468993100000"

deltaAmount*string

For exact in trades, deltaAmount is the minimum received amount. For exact out trades, deltaAmount is the maximum input amount.

Example: "274390635056648134500"

tokenFrom*all of

An object containing information about the token being traded

tokenTo*all of

An object containing information about the token being received in exchange

tradeType*number

A number representing the type of trade being made

Example: 0

protocol*array of ProtocolDto (object)

An array of objects containing information about the protocols used for the trade

transactionData*all of

An object containing data about the transaction

nativeValue*string

Native currency amount will be used for this trade.

Example: "0"

gasPrice*object

Gas Price

Example: "56442235035"

estimateGas*object

the estimated amount of gas needed for the transaction, if sender address query parameters are provided and disableEstimate is set to false

Example: "11231133211313"

estimateGasError*object

the estimate gas error, returned from RPC, if sender address query parameters are provided and disableEstimate is set to false

Example: "Execution reverted"

Request

JavaScriptCurlPython

const response = await fetch('/trade/v1/{chainId}/quote/single?fromTokenAddress=text&toTokenAddress=text&amount=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

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