Interface BuildSwapTransactionRequest

Sell-token amount in the token's smallest unit (positive integer string, no decimals).

Override approve amount (smallest unit, positive integer string). Defaults to the swap amount.

When "true", signatureData includes the spender address and approve calldata so the client can submit it before the swap. Defaults to false.

When "true", slippage is auto-derived from market data and overrides slippagePercent. Either slippagePercent or autoSlippage=true must be provided — omitting both returns a parameter error. Defaults to "false".

Unique chain identifier (e.g. "56"=BSC, "1"=Ethereum, "CT_501"=Solana).

Solana only — maximum compute units the transaction may consume (analogous to EVM gasLimit). Applies only when binanceChainId=CT_501.

Solana only — priority fee per compute unit (micro-lamports), analogous to EVM gasPrice. When omitted, the platform computes a value dynamically. Applies only when binanceChainId=CT_501.

Custom fee (referral fee / Add Fee) percentage as a decimal string. Must be paired with exactly one of fromTokenReferrerWalletAddress or toTokenReferrerWalletAddress (the two referrer addresses are mutually exclusive).

Range by chain:* (0, 5] for EVM chains (BSC, Ethereum, Base, etc.) and (0, 10] for Solana (CT_501) — greater than 0, up to the chain-specific maximum inclusive, max 2 decimal places. "1.5" means 1.5%. Values exceeding 2 decimal places are rejected with INVALID_FEE_PERCENT (40466).

four.meme tokens are not supported* — do not pass fee parameters when either side of the pair is a four.meme token.

Sell-token contract address.

Wallet address that receives the fee deducted from the sell token (FROM_TOKEN direction). Mutually exclusive with toTokenReferrerWalletAddress — providing both returns CONFLICT_REFERRER_PARAMS (40468). Address format depends on the chain: EVM chains require 0x + 40 hex chars; Solana (CT_501) requires a Base58 pubkey. An invalid format returns INVALID_REFERRER_ADDRESS (40467). Must be paired with feePercent.

Gas price tier. Defaults to "average".

Gas limit override (positive integer string). EVM only.

Cap on auto-derived slippage (only applies when autoSlippage=true).

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Maximum allowed price impact percentage (0–100). Defaults to 90; set to 100 to disable.

quoteId returned from /quote for the route to execute. TTL ~30s; expired entries return QUOTE_EXPIRED (40401).

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Maximum slippage tolerance as a percentage string. Required unless autoSlippage=true.

Range by chain:*

• EVM chains (BSC, Ethereum, Base, etc.): 0 to 100 (inclusive)
• Solana (CT_501): 0 to less than 100 (i.e. < 100)

Range by vendor:*

• 1inch, PancakeSwap: 0 to 50 (values above 50 are rejected)
• LiFi, LiquidMesh: 0 to 100 (EVM) or 0 to < 100 (Solana)
• Jupiter (Solana): 0 to less than 100; the value is converted to basis points (slippageBps = ceil(slippagePercent × 100)) and applied to the on-chain swap

"0.5" means 0.5% maximum slippage. When autoSlippage=true this field is overridden by the auto-computed value.

Solana only — Jito tips in SOL for MEV protection. Valid range [0.000000001, 2] (minimum 1 lamport). When specified, it is recommended to set computeUnitPrice=0. Applies only when binanceChainId=CT_501.

Buy-token contract address.

Wallet address that receives the fee deducted from the buy-token output (TO_TOKEN direction). Mutually exclusive with fromTokenReferrerWalletAddress — providing both returns CONFLICT_REFERRER_PARAMS (40468). Address format depends on the chain: EVM chains require 0x + 40 hex chars; Solana (CT_501) requires a Base58 pubkey. An invalid format returns INVALID_REFERRER_ADDRESS (40467). Must be paired with feePercent. On Solana, the referrer must already be activated (funded with some SOL) or the request returns REFERRER_NOT_ACTIVATED (40469).

User wallet address (transaction sender).