Class RestAPI

Broadcast a client-signed transaction to the chain via the Binance Web3 API relay. Returns the transaction hash and an internal orderId you can use to track on-chain status via the post-transaction service. Optional MEV protection (EVM chains only) routes the transaction through a private mempool to mitigate front-running and sandwich attacks.

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.

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.

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.

Return all token balances held by an address across one or more chains, with pagination support. Set excludeRiskToken=true to filter out airdrop-risk and honeypot tokens (honeypot detection currently applies only to ETH / BSC / SOL / BASE).

Look up broadcast orders previously submitted via /pre-transaction/broadcast-transaction. Filter by txStatus or orderId, paginate with cursor.

Return candlestick (K-line) data for a token.

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

Estimate the gas limit (or compute-unit ceiling on Solana) for an unsigned transaction. Provide either evmTx for EVM chains or solTx for Solana, matching the value of binanceChainId.

Query the current network gas price for the specified chain. The response shape varies by chain family:

• EVM chains return both evmLegacyGasPrice (legacy gasPrice) and eip1559GasPrice (baseFee + priority/max fees) when EIP-1559 is supported.
• Solana returns solanaGasPrice (compute-unit prices and Jito tips). Fields not applicable to the chain family are returned as null.

Return the holders ranking list for a token, including holding amount, holding percentage, native-token balance, average buy/sell price, realized PnL, and funding source. Up to 100 records. Pagination is not supported.

Get hot token ranking list. Supports sorting by volume, price change, market cap, etc., with filters for holding distribution, developer behavior, liquidity, and more.

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

Return the list of blockchains supported by the market service.

Return comprehensive metrics for a token, including creator and launch info, holding percentages by address type (smart money, KOL, sniper, bundler, fresh wallet, etc.), and token tags.

Return token balances for a specific list of (chain, contract) pairs. Up to 20 entries per request. Set excludeRiskToken="0" to exclude risk-flagged tokens (default), or "1" to include them.

Return basic metadata for a token: name, symbol, logo, decimals, creator address, creation time, and tag info.

Get the latest price for tokens. Supports batch queries, up to 100 tokens per request.

Return on-chain trade history for a token. Supports tag filtering and wallet address filtering.

Get token price and trading data (volume, transactions, market cap, holders, etc.). Supports batch queries for up to 100 tokens.

Return the top liquidity pools for a token, including pool name, protocol, liquidity in USD, pool address, and per-token composition.

Return the top profit-making addresses for a token, ranked by realized PnL descending. Includes holding amount, average buy/sell price, realized PnL, and funding source. Up to 100 records. Pagination is not supported.

Look up the full on-chain transaction detail by binanceChainId + txHash. Returns one or more entries describing transaction inputs, outputs, internal calls, and token transfers.

Return on-chain transaction history for a wallet address across one or more chains. Results are limited to the most recent 6 months and sorted by time (descending). Supports cursor pagination, time-range filtering, and token-contract filtering.

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.

Return the blockchain networks supported by the Transaction service for gas estimation, simulation, and broadcasting. The list is dynamically configured server-side and may change over time.

Return blockchain networks for which the Wallet service can return balances. The supported list is dynamically configured server-side and may change over time. Pass binanceChainId to filter to a single chain; omit to get the full list.

Search tokens by symbol or contract address.

Generic function to send a request.

Generic function to send a signed request.

Simulate transaction execution off-chain to predict its outcome before broadcasting. The response includes the predicted execution status, balance changes per affected account/token, and ERC-20 allowance changes (EVM chains). Provide either evmTx (EVM chains) or solTx (Solana) matching binanceChainId.

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.