Skip to main content

BNB Smart Chain to Ethereum Swap API

BNB to ETH swap API: BaaS quotes and swaps from BNB Smart Chain (BSC) to Ethereum across Chainflip. The tables below list every enabled asset on each side, the source minimum, a working quote request and a real example response, every asset pair on the route, the fee and commission rules, and the deposit and refund rules for the source chain.

Route at a glance​

ItemValue
Source networkBNB Smart Chain
Destination networkEthereum
Source assets2 enabled
Destination assets6 enabled
Anchor pairbnb.bsc to eth.eth
Native source minimum0.02 BNB (20000000000000000)
Recommended retry50 blocks, at capture, 2026-11-18
Asset pairs12, 12 quoted at capture
Vault swapsSupported from BNB Smart Chain (needs the partner's affiliate broker SS58)
BoostNot applicable (Boost applies only to Bitcoin deposits)

Assets and minimums​

Source: BNB Smart Chain​

AssetidDecimalsMinimumNative minimumContract
BNBbnb.bsc180.02 BNB20000000000000000—
USDTusdt.bsc1810 USDT100000000000000000000x55d398326f99059fF775485246999027B3197955

Destination: Ethereum​

AssetidDecimalsContract
CBBTCcbbtc.eth80xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf
ETHeth.eth18—
FLIPflip.eth180x826180541412D574cf1336d22c0C0a287822678A
USDCusdc.eth60xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
USDTusdt.eth60xdAC17F958D2ee523a2206206994597C13D831ec7
WBTCwbtc.eth80x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599

Snapshot captured on 2026-11-17 from the production /assets endpoint. The minimums above are Chainflip's source (ingress) minimum deposit amounts; destination egress minimums are gas-dependent and not in /assets. Query /assets for live values. The tables reflect the enabled and direction flags of /assets, not live quote availability: a listed pair can still answer insufficient_liquidity, egress_below_minimum or egress_fee_not_covered. Query /quotes for current availability; see Error Codes.

Quote request​

curl --location 'https://chainflip-broker.io/quotes-native?apiKey=87517a91d5f34dbabfc1e410946a3a3c&sourceAsset=bnb.bsc&destinationAsset=eth.eth&amount=341798543938202824'

Replace the example key with your own production key. To try it first, use https://perseverance.chainflip-broker.io with a separate testnet key; see Testing.

A successful request returns an array of quotes, which can be empty ([]); a failure carries a machine-readable code, listed in Error Codes. See Asking for a Quote for every field and Starting a Swap for turning the quote into a swap with slippage protection.

Example response​

Example response captured on 2026-11-18 for 0.341798543938202824 BNB (341798543938202824 native units) from bnb.bsc to eth.eth. Selected fields from a regular quote; estimatedPrice, poolInfo, the DCA quote and any Boost quote are omitted. The *Native strings are exact; decimal amounts are shown as JSON numbers. Values change with liquidity and fees; run the request for current values. This is not a live quote.

{
"type": "regular",
"ingressAsset": "bnb.bsc",
"ingressAmount": 0.3417985439382028,
"ingressAmountNative": "341798543938202824",
"intermediateAsset": "usdc.eth",
"intermediateAmount": 199.347627,
"intermediateAmountNative": "199347627",
"egressAsset": "eth.eth",
"egressAmount": 0.11256324009489786,
"egressAmountNative": "112563240094897862",
"includedFees": [
{
"type": "ingress",
"asset": "bnb.bsc",
"amount": 0.000007,
"amountNative": "7000000000000"
},
{
"type": "network",
"asset": "usdc.eth",
"amount": 0.5,
"amountNative": "500000"
},
{
"type": "broker",
"asset": "usdc.eth",
"amount": 0.399494,
"amountNative": "399494"
},
{
"type": "egress",
"asset": "eth.eth",
"amount": 0.000040704305964,
"amountNative": "40704305964000"
},
{
"type": "liquidity",
"asset": "bnb.bsc",
"amount": 0,
"amountNative": "0"
},
{
"type": "liquidity",
"asset": "usdc.eth",
"amount": 0,
"amountNative": "0"
}
],
"recommendedSlippageTolerancePercent": 1.25,
"recommendedRetryDurationInBlocks": 50,
"estimatedDurationSeconds": 115.125,
"estimatedDurationsSeconds": {
"deposit": 7.125,
"swap": 12,
"egress": 96
},
"lowLiquidityWarning": false
}

Asset pairs on this route​

Source assetDestination assetQuote at capturePage
bnb.bsccbbtc.ethquotedBNB to CBBTC
bnb.bsceth.ethquotedBNB to ETH
bnb.bscflip.ethquotedBNB to FLIP
bnb.bscusdc.ethquotedBNB to USDC
bnb.bscusdt.ethquotedBNB to USDT
bnb.bscwbtc.ethquotedBNB to WBTC
usdt.bsccbbtc.ethquotedUSDT to CBBTC
usdt.bsceth.ethquotedUSDT to ETH
usdt.bscflip.ethquotedUSDT to FLIP
usdt.bscusdc.ethquotedUSDT to USDC
usdt.bscusdt.ethquotedUSDT to USDT
usdt.bscwbtc.ethquotedUSDT to WBTC

Fees and your commission​

BaaS adds a 5 bps operating fee to every swap. You set your own broker commission in the dashboard, and the quote includes it automatically. commissionBps is optional and defaults to your configured commission; a value below your configured commission is silently raised to it, not rejected, and a value outside 0–995 is a 400. The broker entry in includedFees is the total broker fee Chainflip charges: your commission plus BaaS's 5 bps. includedFees also lists the ingress, network, egress and liquidity fees. The earned fees of an account with an affiliate exclude the operating fee. See Pricing, View Earned Fees and Starting a Swap.

Deposit and refund rules​

A /swap call opens a deposit channel and returns the address the user sends the source asset to.

  • Deposit channels close after 24 hours. Open a new channel for every deposit-channel swap and send the deposit immediately.
  • minimumPrice and refundAddress are required.
  • retryDurationInBlocks is optional: omitted or negative, it is the 150-block (15-minute) default, and a value above Chainflip's current runtime limit is lowered to that limit. Use the quote's recommendedRetryDurationInBlocks.
  • If the minimum price or live price protection is not met within the retry window, the source asset is refunded to refundAddress. For DCA, only unexecuted chunks are refunded; executed chunks still pay out to the destination.

See slippage protection and live price protection in Starting a Swap.

The source chain is BNB Smart Chain. The deposit address is a BNB Smart Chain address, and refundAddress must be valid on BNB Smart Chain. See the BNB Smart Chain chain page for address formats and deposit details.

Route notes​

  • Chainflip recommends 300 blocks (30 minutes) when BTC is on either side and 50 blocks (5 minutes) otherwise, so 50 blocks on this route; use the quote's recommendedRetryDurationInBlocks.
  • Source deposits and refunds use BNB Smart Chain addresses; see the BNB Smart Chain chain page.
  • destinationAddress must be valid on Ethereum; see the Ethereum chain page.
  • Vault swaps are supported from BNB Smart Chain source assets and require the partner's affiliate broker SS58; otherwise /tx-payload/* answers 400 Partner is not yet set up for vault swaps. See Vault Swap Transaction Payloads.
  • boostFee is accepted and validated (0–100) for BNB Smart Chain source assets but has no effect; Boost applies only to Bitcoin deposits.
  • EVM gas can push the egress fee above the output; a quote can answer egress_fee_not_covered or egress_below_minimum. Try a larger amount or retry; see Error Codes.
  • BNB Smart Chain uses Ethereum's 0x address format, so the same address is valid on Ethereum and Arbitrum: confirm the user controls it on BNB Smart Chain. See the BNB Smart Chain chain page.

FAQ​

What is the minimum source amount for BNB to ETH?​

The minimum bnb.bsc deposit is 0.02 BNB (20000000000000000 native units), from the /assets snapshot of 2026-11-17. Destination egress minimums are gas-dependent and not in /assets; a quote for your amount is authoritative.

How long does a BNB Smart Chain to Ethereum swap take?​

The example quote for bnb.bsc to eth.eth, captured on 2026-11-18, estimated about 1 minutes 55 seconds (115.125 seconds). Chainflip split it into deposit 7.125, swap 12 and egress 96 seconds. This is an example, not a promise: use the estimatedDurationSeconds of your own quote, and allow for the source chain's confirmations.

What fees will I pay?​

BaaS's 5 bps operating fee plus your configured broker commission, and Chainflip's own ingress, network, egress and liquidity fees. The quote's includedFees lists every fee for your amount; its broker entry is your commission plus the 5 bps. See Pricing.

Can I set my own commission?​

Yes: set your broker commission in the dashboard. commissionBps can raise it for one request; a lower value is silently raised to your configured commission, and a value outside 0–995 is a 400. See Starting a Swap.