Trading API

Endpointhttps://web3.binance.com/build

Get Aggregator Supported Chains

Return blockchain networks supported by the DEX aggregator. The supported list is dynamically configured server-side and may change over time. Pass binanceChainId to filter to a single chain; omit it to get the full list.

GET

/api/v1/dex/aggregator/supported/chain

https://web3.binance.com/build

Get Aggregator Supported Chains › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Aggregator Supported Chains › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

Get Aggregator Supported Chains › Query Parameters

binanceChainId

string

Optional chain identifier (e.g. "1"=Ethereum, "56"=BSC, "CT_501"=Solana). When set, only that chain is returned.

Example: 56

Get Aggregator Supported Chains › Responses

Supported chains returned successfully.

code

integer · int32

Business status code. 0 indicates success; any non-zero value indicates a business error.

Example: 0

msg

string

Status description message.

Example: success

object[]

List of supported blockchain networks.

timestamp

integer · int64

Server response timestamp in milliseconds.

Example: 1748601600000

success

boolean

Convenience flag derived from code == 0.

Example: true

Get ERC-20 Approve Transaction

Build the on-chain transaction data needed to approve the DEX router to spend a user's ERC-20 token before a swap. Calldata is encoded per the ERC-20 ABI standard (approve() selector + spender + amount).

GET

/api/v1/dex/aggregator/approve-transaction

https://web3.binance.com/build

Get ERC-20 Approve Transaction › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get ERC-20 Approve Transaction › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

Get ERC-20 Approve Transaction › Query Parameters

binanceChainId

string · required

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

Example: 1

tokenContractAddress

string · required

ERC-20 token contract address to approve (0x + 40 hex chars).

Example: 0xdAC17F958D2ee523a2206206994597C13D831ec7

approveAmount

string · required

Approval amount in the token's smallest unit (positive integer string). Example "1000000" = 1 USDT (decimals=6).

Example: 1000000

vendor

string

RFQ vendor name. Required for equity / RWA tokens (Ondo, BStock); pass the vendorName from the /quote response (e.g. InchFusion, CowSwap, PcsXRfq). When provided, the backend returns approve calldata targeting the vendor-specific spender contract (e.g. 1inch Router, PcsX Permit2, CowSwap VaultRelayer) instead of the default DEX router.

For regular (non-RWA) tokens, this parameter is optional. If omitted, the backend uses the standard DEX router. If a valid RFQ vendor is passed, the backend resolves that vendor's spender — used when buying Ondo/BStock with a stablecoin, where the from-token (e.g. USDT) itself is not an RFQ token but must be approved to the RFQ vendor's router.

Example: PcsXRfq

Get ERC-20 Approve Transaction › Responses

Approve transaction data returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object[]

Approve transaction(s) to submit before the swap.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/aggregator/approve-transaction

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/aggregator/approve-transaction?binanceChainId=%3Cstring%3E&tokenContractAddress=%3Cstring%3E&approveAmount=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "data": "0x095ea7b3000000000000000000000000c67879f4065d3b9fe1c09ee990b891aa8e3a4c2f0000000000000000000000000000000000000000000000000000000000f4240",
      "dexContractAddress": "0xc67879F4065d3B9fe1C09EE990B891Aa8E3a4c2f",
      "gasLimit": "50000",
      "gasPrice": "110000000"
    }
  ],
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Aggregated Quote

Query multiple DEX vendors in parallel and return the priced routes sorted by toTokenAmount (descending). Each route carries an independent quoteId (TTL ~30s) that the swap endpoint consumes to construct calldata for the chosen route.

GET

/api/v1/dex/aggregator/quote

https://web3.binance.com/build

Get Aggregated Quote › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Aggregated Quote › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

Get Aggregated Quote › Query Parameters

binanceChainId

string · required

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

Example: 56

amount

string · required

Sell-token amount in the token's smallest unit (positive integer string, no decimals). Example "1000000" = 1 USDT (decimals=6).

Example: 1000000

fromTokenAddress

string · required

Sell-token contract address. EVM chains require 0x + 40 hex chars; non-EVM chains use the chain's native address format.

Example: 0x55d398326f99059fF775485246999027B3197955

toTokenAddress

string · required

Buy-token contract address. Must differ from fromTokenAddress.

Example: 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d

vendor

string · enum

Optional vendor selector. When provided, only the specified vendor is queried through the single-vendor fast path; the request bypasses the multi-vendor dual-window, early-return, and price-check logic. Values are case-sensitive and must be one of LiquidMesh, Pancake, or Jupiter. The vendor must also support the requested chain. An unsupported value or unavailable vendor/chain returns PARAM_ERROR (40001). When omitted, the API queries all applicable vendors in parallel and returns the aggregated routes.

Enum values:

LiquidMesh

Pancake

Jupiter

Example: LiquidMesh

userWalletAddress

string

User wallet address. Required when quoting RFQ routes (equity / RWA tokens such as Ondo and BStock). This address is used as the receiver in the RFQ order and must match the wallet that signs rfq.typedDataToSign in the subsequent /swap call.

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

feePercent

string

Custom fee (referral fee / Add Fee) percentage as a decimal string. Must be paired with feeSource — either both present or both absent.

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.

Example: 1.5

feeSource

string · enum

Fee deduction direction. FROM_TOKEN = deduct the fee from the sell token (the amount passed to the DEX is reduced to a net amount); TO_TOKEN = deduct the fee from the buy-token output (the user's actual received amount is reduced). Must be paired with feePercent.

Enum values:

FROM_TOKEN

TO_TOKEN

Example: FROM_TOKEN

Get Aggregated Quote › Responses

Quote routes returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object[]

One route per vendor that returned a valid quote, sorted by toTokenAmount descending.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/aggregator/quote

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/aggregator/quote?binanceChainId=%3Cstring%3E&amount=%3Cstring%3E&fromTokenAddress=%3Cstring%3E&toTokenAddress=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "quoteId": "a1b2c3d4e5f64a8b9c0d1e2f3a4b5c6d",
      "vendorName": "Lifi",
      "binanceChainId": "56",
      "fromTokenAmount": "1000000",
      "toTokenAmount": "998500000000000000",
      "tradeFee": "0.12",
      "estimateGasFee": "150000",
      "priceImpactPercent": "-0.01",
      "router": "0x55d3...--0xbb4C...--0x8AC7...",
      "fromToken": {
        "tokenContractAddress": "0x55d398326f99059fF775485246999027B3197955",
        "tokenSymbol": "USDT",
        "tokenUnitPrice": "1.0002",
        "decimal": "18",
        "isHoneyPot": false,
        "taxRate": "0"
      },
      "toToken": {
        "tokenContractAddress": "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
        "tokenSymbol": "BTCB",
        "tokenUnitPrice": "67000.5",
        "decimal": "18",
        "isHoneyPot": false,
        "taxRate": "0"
      },
      "dexRouterList": [
        {
          "dexProtocol": {
            "dexName": "Uniswap V3",
            "percent": "85.99"
          },
          "fromToken": {
            "tokenContractAddress": "0x55d398326f99059fF775485246999027B3197955",
            "tokenSymbol": "USDT"
          },
          "fromTokenIndex": "0",
          "toToken": {
            "tokenContractAddress": "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
            "tokenSymbol": "BTCB"
          },
          "toTokenIndex": "1"
        }
      ],
      "executionMode": "SWAP",
      "approveTarget": "0xc67879F4065d3B9fe1C09EE990B891Aa8E3a4c2f",
      "isBest": true,
      "feeAmount": "15000",
      "feeToken": "0x55d398326f99059fF775485246999027B3197955",
      "actualSwapAmount": "985000"
    }
  ],
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Build Swap Transaction

Build the on-chain swap calldata for a previously quoted route. The request is matched against the cached quote by quoteId (TTL ~30s); if the entry has expired, QUOTE_EXPIRED (40401) is returned, and if the request parameters disagree with the cached quote, SWAP_QUOTE_MISMATCH (40462) is returned.

GET

/api/v1/dex/aggregator/swap

https://web3.binance.com/build

Build Swap Transaction › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Build Swap Transaction › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

Build Swap Transaction › Query Parameters

binanceChainId

string · required

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

Example: 56

amount

string · required

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

Example: 1000000

fromTokenAddress

string · required

Sell-token contract address.

Example: 0x55d398326f99059fF775485246999027B3197955

toTokenAddress

string · required

Buy-token contract address.

Example: 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d

userWalletAddress

string · required

User wallet address (transaction sender).

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

quoteId

string · required

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

Example: a1b2c3d4e5f64a8b9c0d1e2f3a4b5c6d

slippagePercent

string

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.

Example: 0.5

approveTransaction

string · enum

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

Enum values:

true

false

Example: false

approveAmount

string

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

Example: 1000000

gasLimit

string

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

Example: 200000

gasLevel

string · enum

Gas price tier. Defaults to "average".

Enum values:

slow

average

fast

Example: average

priceImpactProtectionPercent

string

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

Example: 90

autoSlippage

string · enum

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".

Enum values:

true

false

Example: false

maxAutoSlippagePercent

string

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

Example: 3

computeUnitLimit

string

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

Example: 1400000

computeUnitPrice

string

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.

Example: 1000

tips

string

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.

Example: 0.001

feePercent

string

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).

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

Example: 1.5

fromTokenReferrerWalletAddress

string

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.

Example: 0xCbF2B6E6e3D7e9e4e4e4e4e4e4e4e4e4e4e4e4e4

toTokenReferrerWalletAddress

string

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).

Example: 0xCbF2B6E6e3D7e9e4e4e4e4e4e4e4e4e4e4e4e4e4

Build Swap Transaction › Responses

Swap transaction data returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/aggregator/swap

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/aggregator/swap?binanceChainId=%3Cstring%3E&amount=%3Cstring%3E&fromTokenAddress=%3Cstring%3E&toTokenAddress=%3Cstring%3E&userWalletAddress=%3Cstring%3E&quoteId=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "routerResult": {
      "binanceChainId": "56",
      "vendorName": "Lifi",
      "fromTokenAmount": "1000000",
      "toTokenAmount": "998500000000000000",
      "tradeFee": "0.12",
      "estimateGasFee": "150000",
      "router": "0x55d3...--0xbb4C...--0x8AC7...",
      "priceImpactPercent": "-0.01",
      "dexRouterList": [
        {
          "dexProtocol": {
            "dexName": "Uniswap V3",
            "percent": "85.99"
          },
          "fromToken": {
            "tokenContractAddress": "0x55d398326f99059fF775485246999027B3197955",
            "tokenSymbol": "USDT"
          },
          "fromTokenIndex": "0",
          "toToken": {
            "tokenContractAddress": "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
            "tokenSymbol": "BTCB"
          },
          "toTokenIndex": "1"
        }
      ],
      "fromToken": {
        "tokenContractAddress": "0x55d398326f99059fF775485246999027B3197955",
        "tokenSymbol": "USDT",
        "tokenUnitPrice": "1.0002",
        "decimal": "18",
        "isHoneyPot": false,
        "taxRate": "0"
      },
      "toToken": {
        "tokenContractAddress": "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
        "tokenSymbol": "BTCB",
        "tokenUnitPrice": "67000.5",
        "decimal": "18",
        "isHoneyPot": false,
        "taxRate": "0"
      },
      "feeAmount": "15000",
      "feeToken": "0x55d398326f99059fF775485246999027B3197955",
      "actualSwapAmount": "985000"
    },
    "tx": {
      "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "to": "0x1111111254EEB25477B68fb85Ed929f73A960582",
      "data": "0x12aa3caf...",
      "value": "0",
      "gas": "200000",
      "gasPrice": "5000000000",
      "maxPriorityFeePerGas": "1000000000",
      "minReceiveAmount": "993507500000000000",
      "slippagePercent": "0.5",
      "signatureData": [
        "0xc67879F4065d3B9fe1C09EE990B891Aa8E3a4c2f"
      ],
      "computeUnitPrice": "1000",
      "computeUnitLimit": "1400000"
    },
    "executionMode": "SWAP",
    "rfq": {
      "vendor": "PcsXRfq",
      "txType": "EIP712",
      "typedDataToSign": "0x1901...",
      "signingScheme": "EIP712",
      "signatureData": [
        "{\"approveContract\":\"0xc67879F4065d3B9fe1C09EE990B891Aa8E3a4c2f\",\"approveTxCalldata\":\"0x095ea7b3...\"}"
      ]
    }
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Quote and Build Swap Transaction (Flash API)

Combines quoting and swap-transaction construction into a single call. Unlike the two-step /quote + /swap flow, this endpoint does not require a prior /quote call or a quoteId — it returns the executable calldata / swapTransaction directly, eliminating one HTTP round-trip. Use this endpoint for latency-sensitive trading when the vendor is known upfront. The response shape is identical to /swap, so clients can reuse the same response parsing logic for both endpoints.

GET

/api/v1/dex/aggregator/quote-and-swap

https://web3.binance.com/build

Quote and Build Swap Transaction (Flash API) › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Quote and Build Swap Transaction (Flash API) › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

Quote and Build Swap Transaction (Flash API) › Query Parameters

binanceChainId

string · required

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

Example: 56

amount

string · required

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

Example: 1000000

fromTokenAddress

string · required

Sell-token contract address.

Example: 0x55d398326f99059fF775485246999027B3197955

toTokenAddress

string · required

Buy-token contract address.

Example: 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d

userWalletAddress

string · required

User wallet address (transaction sender). For Solana, a Base58 system-account address with sufficient SOL for gas.

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

vendor

string · enum · required

Swap vendor to use for this request. Required — case-sensitive; must match one of the enum values. Any other value returns PARAM_ERROR (40001). For multi-vendor aggregation, use /swap with a quoteId instead.

Enum values:

LiquidMesh

Example: LiquidMesh

slippagePercent

string

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)

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

Example: 0.5

approveTransaction

string · enum

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

Enum values:

true

false

Example: false

approveAmount

string

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

Example: 1000000

gasLimit

string

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

Example: 200000

gasLevel

string · enum

Gas price tier. Defaults to "average".

Enum values:

slow

average

fast

Example: average

priceImpactProtectionPercent

string

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

Example: 90

autoSlippage

string · enum

Enum values:

true

false

Example: false

maxAutoSlippagePercent

string

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

Example: 3

computeUnitLimit

string

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

Example: 1400000

computeUnitPrice

string

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.

Example: 1000

tips

string

Example: 0.001

feePercent

string

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

Example: 1.5

fromTokenReferrerWalletAddress

string

Example: 0xCbF2B6E6e3D7e9e4e4e4e4e4e4e4e4e4e4e4e4e4

toTokenReferrerWalletAddress

string

Example: 0xCbF2B6E6e3D7e9e4e4e4e4e4e4e4e4e4e4e4e4e4

Quote and Build Swap Transaction (Flash API) › Responses

Swap transaction data returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/aggregator/quote-and-swap

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/aggregator/quote-and-swap?binanceChainId=%3Cstring%3E&amount=%3Cstring%3E&fromTokenAddress=%3Cstring%3E&toTokenAddress=%3Cstring%3E&userWalletAddress=%3Cstring%3E&vendor=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "routerResult": {
      "binanceChainId": "56",
      "vendorName": "Lifi",
      "fromTokenAmount": "1000000",
      "toTokenAmount": "998500000000000000",
      "tradeFee": "0.12",
      "estimateGasFee": "150000",
      "router": "0x55d3...--0xbb4C...--0x8AC7...",
      "priceImpactPercent": "-0.01",
      "dexRouterList": [
        {
          "dexProtocol": {
            "dexName": "Uniswap V3",
            "percent": "85.99"
          },
          "fromToken": {
            "tokenContractAddress": "0x55d398326f99059fF775485246999027B3197955",
            "tokenSymbol": "USDT"
          },
          "fromTokenIndex": "0",
          "toToken": {
            "tokenContractAddress": "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
            "tokenSymbol": "BTCB"
          },
          "toTokenIndex": "1"
        }
      ],
      "fromToken": {
        "tokenContractAddress": "0x55d398326f99059fF775485246999027B3197955",
        "tokenSymbol": "USDT",
        "tokenUnitPrice": "1.0002",
        "decimal": "18",
        "isHoneyPot": false,
        "taxRate": "0"
      },
      "toToken": {
        "tokenContractAddress": "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
        "tokenSymbol": "BTCB",
        "tokenUnitPrice": "67000.5",
        "decimal": "18",
        "isHoneyPot": false,
        "taxRate": "0"
      },
      "feeAmount": "15000",
      "feeToken": "0x55d398326f99059fF775485246999027B3197955",
      "actualSwapAmount": "985000"
    },
    "tx": {
      "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "to": "0x1111111254EEB25477B68fb85Ed929f73A960582",
      "data": "0x12aa3caf...",
      "value": "0",
      "gas": "200000",
      "gasPrice": "5000000000",
      "maxPriorityFeePerGas": "1000000000",
      "minReceiveAmount": "993507500000000000",
      "slippagePercent": "0.5",
      "signatureData": [
        "0xc67879F4065d3B9fe1C09EE990B891Aa8E3a4c2f"
      ],
      "computeUnitPrice": "1000",
      "computeUnitLimit": "1400000"
    },
    "executionMode": "SWAP",
    "rfq": {
      "vendor": "PcsXRfq",
      "txType": "EIP712",
      "typedDataToSign": "0x1901...",
      "signingScheme": "EIP712",
      "signatureData": [
        "{\"approveContract\":\"0xc67879F4065d3B9fe1C09EE990B891Aa8E3a4c2f\",\"approveTxCalldata\":\"0x095ea7b3...\"}"
      ]
    }
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Build Solana Swap Instructions

Solana-only counterpart to /swap. Shares the full quote → route → vendor buildSwapTx → priceImpact → minReceive → instruction-assembly pipeline; the only difference is the response: instead of returning a signed-and-serialized base64 transaction, this endpoint returns the uncompiled instruction list plus the address-lookup-table (ALT) address list, leaving v0-transaction compilation, signing, and submission to the caller.

Use this when the caller needs to:

prepend / append their own instructions (e.g. fee splitting, custom logging) before signing;
reuse the platform-curated route, slippage, PS-variant rewriting, ALT injection, ComputeBudget overwrite, and ATA batching while still controlling the final wire format.

Only supports binanceChainId=CT_501 (Solana). Other chains return CHAIN_NOT_SUPPORTED (40411). Parameters mirror the Solana subset of /swap (no EVM-only approveTransaction / approveAmount / gasLimit). Supports the custom-fee (Add Fee / referral fee) parameters (feePercent + fromTokenReferrerWalletAddress / toTokenReferrerWalletAddress), with the same semantics as /swap — the fee instructions are injected into the returned uncompiled instruction list.

GET

/api/v1/dex/aggregator/swap-instruction

https://web3.binance.com/build

Build Solana Swap Instructions › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Build Solana Swap Instructions › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

Build Solana Swap Instructions › Query Parameters

binanceChainId

string · enum · required

Chain identifier. Only CT_501 (Solana) is accepted; other values return CHAIN_NOT_SUPPORTED (40411).

Enum values:

CT_501

Example: CT_501

amount

string · required

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

Example: 12000000

fromTokenAddress

string · required

Sell-token mint address (Solana Base58, case-sensitive).

Example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

toTokenAddress

string · required

Buy-token mint address (Solana Base58, case-sensitive).

Example: So11111111111111111111111111111111111111112

slippagePercent

string · required

Maximum slippage as a percentage. Solana range 0 to less than 100. "0.5" means 0.5%.

Example: 0.5

userWalletAddress

string · required

User wallet address (Solana Base58); becomes the v0 transaction's feePayer.

Example: J5CBzXpcYn6WR2JBah8zU4Yxct985CAFGwXRcFaX2pbS

quoteId

string · required

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

Example: a1b2c3d4e5f64a8b9c0d1e2f3a4b5c6d

priceImpactProtectionPercent

string

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

Example: 90

autoSlippage

string · enum

When "true", slippage is auto-derived from market data and overrides slippagePercent. Defaults to false.

Enum values:

true

false

Example: false

maxAutoSlippagePercent

string

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

Example: 3

computeUnitLimit

string

Maximum compute units the transaction may consume (analogous to EVM gasLimit). Defaults to the platform value when omitted.

Example: 1400000

computeUnitPrice

string

Priority fee per compute unit (micro-lamports). When omitted, the platform computes a value either from the gasLevel tier or from chain-side defaults.

Example: 1000

gasLevel

string · enum

Priority-fee tier; consulted only when computeUnitPrice is omitted. Defaults to "average".

Enum values:

slow

average

fast

Example: average

tips

string

Jito tips in SOL for MEV protection. Valid range [0.000000001, 2] (minimum 1 lamport). When specified, it is recommended to set computeUnitPrice=0. The platform picks one of Jito's tip accounts at random per request.

Example: 0.001

feePercent

string

Range (Solana): (0, 10] — greater than 0, up to 10 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.

Example: 1.5

fromTokenReferrerWalletAddress

string

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). Solana requires a Base58 pubkey; an invalid format returns INVALID_REFERRER_ADDRESS (40467). Must be paired with feePercent.

Example: J5CBzXpcYn6WR2JBah8zU4Yxct985CAFGwXRcFaX2pbS

toTokenReferrerWalletAddress

string

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). Solana requires a Base58 pubkey; an invalid format returns INVALID_REFERRER_ADDRESS (40467). Must be paired with feePercent. The referrer must already be activated (funded with some SOL) or the request returns REFERRER_NOT_ACTIVATED (40469).

Example: J5CBzXpcYn6WR2JBah8zU4Yxct985CAFGwXRcFaX2pbS

Build Solana Swap Instructions › Responses

Uncompiled Solana instruction list and ALT addresses returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/aggregator/swap-instruction

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/aggregator/swap-instruction?binanceChainId=%3Cstring%3E&amount=%3Cstring%3E&fromTokenAddress=%3Cstring%3E&toTokenAddress=%3Cstring%3E&slippagePercent=%3Cstring%3E&userWalletAddress=%3Cstring%3E&quoteId=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "addressLookupTableAccount": [
      "AcL1Vo8oy1ULiavEcjSUcwfBSForXMudbWLPYz2gTW4D"
    ],
    "instructionLists": [
      {
        "programId": "ComputeBudget111111111111111111111111111111",
        "data": "AgY6BAA=",
        "accounts": [
          {
            "pubkey": "J5CBzXpcYn6WR2JBah8zU4Yxct985CAFGwXRcFaX2pbS",
            "isSigner": false,
            "isWritable": true
          }
        ]
      }
    ],
    "routerResult": {
      "binanceChainId": "CT_501",
      "vendorName": "Jupiter",
      "fromTokenAmount": "12000000",
      "toTokenAmount": "607402",
      "tradeFee": "0.12",
      "estimateGasFee": "1400000",
      "router": "So11...112--EPjF...DT1v",
      "priceImpactPercent": "-0.01",
      "dexRouterList": [
        {
          "dexProtocol": {
            "dexName": "Raydium",
            "percent": "100"
          },
          "fromToken": {
            "tokenContractAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
            "tokenSymbol": "USDC"
          },
          "fromTokenIndex": "0",
          "toToken": {
            "tokenContractAddress": "So11111111111111111111111111111111111111112",
            "tokenSymbol": "WSOL"
          },
          "toTokenIndex": "1"
        }
      ],
      "fromToken": {
        "tokenContractAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "tokenSymbol": "USDC",
        "decimal": "6"
      },
      "toToken": {
        "tokenContractAddress": "So11111111111111111111111111111111111111112",
        "tokenSymbol": "WSOL",
        "decimal": "9"
      },
      "feeAmount": "15000",
      "feeToken": "So11111111111111111111111111111111111111112",
      "actualSwapAmount": "985000"
    },
    "tx": {
      "from": "J5CBzXpcYn6WR2JBah8zU4Yxct985CAFGwXRcFaX2pbS",
      "to": "proVF4pMXVaYqmy4NjniPh4pqKNfMmsihgd4wdkCX3u",
      "minReceiveAmount": "604365",
      "slippagePercent": "0.5"
    }
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Transaction Status

Look up the on-chain status of a DEX swap by binanceChainId + txHash. Response semantics:

Transaction not found: data is null (not HTTP 404).
Transaction failed: status=failed with errorMsg; aggregator business fields (txType, dexRouter, fromTokenDetails, toTokenDetails) are null.
Transaction succeeded: status=success with full token details when an aggregator event is present.

GET

/api/v1/dex/aggregator/history

https://web3.binance.com/build

Get Transaction Status › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Transaction Status › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

Get Transaction Status › Query Parameters

binanceChainId

string · required

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

Example: 56

txHash

string · required

On-chain transaction hash.

Example: 0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890

Get Transaction Status › Responses

Transaction details. data is null when no record is found.

code

integer · int32

Example: 0

msg

string

Example: success

data

object | null

Transaction details. Null when the transaction is not found in any source table.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/aggregator/history

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/aggregator/history?binanceChainId=%3Cstring%3E&txHash=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "binanceChainId": "56",
    "txHash": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890",
    "height": "39812345",
    "txTime": "1748601600000",
    "status": "success",
    "fromAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "toAddress": "0x1111111254EEB25477B68fb85Ed929f73A960582",
    "errorMsg": "execution reverted: insufficient liquidity",
    "gasLimit": "200000",
    "gasUsed": "150000",
    "gasPrice": "5000000000",
    "txFee": "750000000000000",
    "priorityFee": "1000000000",
    "txType": "Swap",
    "dexRouter": "0x1111111254EEB25477B68fb85Ed929f73A960582",
    "fromTokenDetails": [
      {
        "symbol": "USDT",
        "amount": "1500000",
        "tokenAddress": "0x55d398326f99059fF775485246999027B3197955"
      }
    ],
    "toTokenDetails": [
      {
        "symbol": "BTCB",
        "amount": "22500000000000",
        "tokenAddress": "0x7130d2A12B9BCbFAe4f2634d864A1Ee1Ce3Ead9c"
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Submit RFQ Order

Submit a signed RFQ order to the backend for on-chain settlement via the corresponding vendor relayer. Only used when executionMode=RFQ (equity / RWA tokens such as Ondo and BStock).

Flow: GET /quote → pick an RFQ route → GET /swap → sign rfq.typedDataToSign with EIP-712 (eth_signTypedData_v4) → call this endpoint → poll GET /order/{orderId} until FILLED or FAILED.

Idempotency: Submitting with the same requestId within 30 minutes returns the original result without re-calling the vendor. Use a new UUID for each distinct order; reuse the same UUID when retrying.

POST

/api/v1/dex/aggregator/order/submit

https://web3.binance.com/build

Submit RFQ Order › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Submit RFQ Order › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

Submit RFQ Order › Request Body

requestId

string · required

Idempotency key (UUID v4). Within 30 minutes, re-submitting with the same requestId returns the original result without re-calling the vendor. Generate a new UUID for each new order; reuse the same UUID when retrying the same attempt.

Example: 550e8400-e29b-41d4-a716-446655440000

userSignature

string · required

EIP-712 signature of rfq.typedDataToSign from the /swap response. Must be a hex string with 0x prefix (132 chars = 0x + 65 bytes). The signing wallet must match userWalletAddress used in /quote. The backend automatically corrects Ethereum v values 00/01 to 1b/1c.

Example: 0x1234abcd...5678ef

vendor

string · enum · required

RFQ vendor name — must match rfq.vendor from the /swap response. The backend validates this against quoteId to prevent misrouted submissions.

Enum values:

InchFusion

CowSwap

PcsXRfq

Example: PcsXRfq

quoteId

string · required

rfq.orderId from the /swap response. The backend uses this to look up the vendor and chain context required to forward the signed order.

Example: a1b2c3d4e5f64a8b9c0d1e2f3a4b5c6d

signingScheme

string

Signing scheme from rfq.signingScheme in the /swap response. Optional — when omitted the backend infers the default per vendor.

Example: EIP712

Submit RFQ Order › Responses

RFQ order submitted successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object

Submitted order details.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

POST/api/v1/dex/aggregator/order/submit

curl --request POST \
  --url https://web3.binance.com/build/api/v1/dex/aggregator/order/submit \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "userSignature": "0x1234abcd...5678ef",
  "vendor": "PcsXRfq",
  "quoteId": "a1b2c3d4e5f64a8b9c0d1e2f3a4b5c6d"
}
'

Example Request Body

{
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "userSignature": "0x1234abcd...5678ef",
  "vendor": "PcsXRfq",
  "quoteId": "a1b2c3d4e5f64a8b9c0d1e2f3a4b5c6d"
}

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "orderId": "oc-o-abc123def456",
    "status": "PENDING_VENDOR",
    "createdAt": 1748601600000
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get RFQ Order Status

Query the settlement status of an RFQ order by its platform orderId (returned by POST /order/submit). Poll this endpoint until status reaches a terminal state: FILLED (settled on-chain) or FAILED (settlement failed).

GET

/api/v1/dex/aggregator/order/{orderId}

https://web3.binance.com/build

Get RFQ Order Status › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get RFQ Order Status › Path Parameters

orderId

string · required

Platform order ID returned by POST /order/submit.

Example: oc-o-abc123def456

Get RFQ Order Status › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

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

Example: 5000

X-OC-NONCE

string

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

Example: unique-nonce-string

Get RFQ Order Status › Responses

Order status returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object

Order status details.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true