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

Generate transaction data for single-chain trade via Unizen DEX Aggregator

Generate transaction data for single-chain trade via Unizen DEX Aggregator

POST/trade/v1/{chainId}/swap/single

Authorization

X-Api-Key

Path parameters

chainId*enum

The chain ID of the chain where the swap will be conducted

Example: 56

1137564311425010421618453

Body

application/json

Needed params, obtained from /quote/single endpoint

transactionData*string

The transactionData object obtained from the /quote API, parsed as a string.

Example: "{}"

nativeValue*string

The native currency value for this transaction, obtained from the /quote API response.

Example: "0"

account*string

The user's address that conducts the trade.

Example: "0xF0Fbf42C54Ac40dA016003baD35E5AefaC6E1CE1"

receiverstring

The wallet address that will receive the funds.

Example: "0xF0Fbf42C54Ac40dA016003baD35E5AefaC6E1CE1"

tradeType*enum

tradeType obtained from the /quote API response

Example: 0

01

Response

200

Generate transaction data for single-chain trade

Body

application/json

data*string

The data associated with the transaction

contractVersion*string

Contract version to execute the trade

Example: "v1"

estimateGas*string

the estimated amount of gas needed for the transaction

Example: "11231133211313"

estimateGasError*object

the estimate gas error, returned from RPC

Example: "Execution reverted"

nativeValue*string

The value of the transaction in the native currency.

Example: "0"

allowance*string

Allowance of the user for the involved token

Example: "56442235035"

insufficientFunds*boolean

It is true if the amount to trade exceeds user's funds

Example: false

insufficientAllowance*boolean

It is true if the there is not enough allowance for the token sold

Example: false

insufficientGas*boolean

It is true if there is not enough gas for the transaction

Example: false

maxFeePerGas*string

For EIP1559 usage

Example: "20748300881"

maxPriorityFeePerGas*string

For EIP1559 usage

Example: "maxPriorityFeePerGas"

gasPrice*string

Gas Price

Example: "56442235035"

estimateGasRawError*object

The raw error returned from RPC or our smart contract

Example: "Error: invalid BigNumber string (argument=\"value\", value=\"\", code=INVALID_ARGUMENT, version=bignumber/5.7.0)"

Request

JavaScriptCurlPython

const response = await fetch('/trade/v1/{chainId}/swap/single', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer Bearer",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "transactionData": "{}",
      "nativeValue": "0",
      "account": "0xF0Fbf42C54Ac40dA016003baD35E5AefaC6E1CE1",
      "tradeType": 0
    }),
});
const data = await response.json();

Response

200

{
  "data": {},
  "contractVersion": "v1",
  "estimateGas": "11231133211313",
  "estimateGasError": "Execution reverted",
  "nativeValue": "0",
  "allowance": "56442235035",
  "insufficientFunds": false,
  "insufficientAllowance": false,
  "insufficientGas": false,
  "maxFeePerGas": "20748300881",
  "maxPriorityFeePerGas": "maxPriorityFeePerGas",
  "gasPrice": "56442235035",
  "estimateGasRawError": "Error: invalid BigNumber string (argument=\"value\", value=\"\", code=INVALID_ARGUMENT, version=bignumber/5.7.0)"
}