Skip to main content

Ethereum to Asset Hub Swap API

ETH to DOT swap API: BaaS quotes and swaps from Ethereum to Polkadot Asset Hub 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 networkEthereum
Destination networkAsset Hub
Source assets6 enabled
Destination assets3 enabled
Anchor paireth.eth to dot.hub
Native source minimum0.01 ETH (10000000000000000)
Recommended retry50 blocks, at capture, 2026-11-18
Asset pairs18, 18 quoted at capture
Vault swapsSupported from Ethereum (needs the partner's affiliate broker SS58)
BoostNot applicable (Boost applies only to Bitcoin deposits)

Assets and minimums​

Source: Ethereum​

AssetidDecimalsMinimumNative minimumContract
CBBTCcbbtc.eth80.0004 CBBTC400000xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf
ETHeth.eth180.01 ETH10000000000000000—
FLIPflip.eth184 FLIP40000000000000000000x826180541412D574cf1336d22c0C0a287822678A
USDCusdc.eth620 USDC200000000xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
USDTusdt.eth620 USDT200000000xdAC17F958D2ee523a2206206994597C13D831ec7
WBTCwbtc.eth80.0004 WBTC400000x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599

Destination: Asset Hub​

AssetidDecimalsContract
DOTdot.hub10—
USDCusdc.hub61337
USDTusdt.hub61984

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=eth.eth&destinationAsset=dot.hub&amount=113093386864203116'

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.113093386864203116 ETH (113093386864203116 native units) from eth.eth to dot.hub. 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": "eth.eth",
"ingressAmount": 0.11309338686420312,
"ingressAmountNative": "113093386864203116",
"intermediateAsset": "usdc.eth",
"intermediateAmount": 199.516287,
"intermediateAmountNative": "199516287",
"egressAsset": "dot.hub",
"egressAmount": 249.6599615708,
"egressAmountNative": "2496599615708",
"includedFees": [
{
"type": "ingress",
"asset": "eth.eth",
"amount": 0.00002165175744,
"amountNative": "21651757440000"
},
{
"type": "network",
"asset": "usdc.eth",
"amount": 0.5,
"amountNative": "500000"
},
{
"type": "broker",
"asset": "usdc.eth",
"amount": 0.399832,
"amountNative": "399832"
},
{
"type": "egress",
"asset": "dot.hub",
"amount": 0.019745,
"amountNative": "197450000"
},
{
"type": "liquidity",
"asset": "eth.eth",
"amount": 0,
"amountNative": "0"
},
{
"type": "liquidity",
"asset": "usdc.eth",
"amount": 0,
"amountNative": "0"
}
],
"recommendedSlippageTolerancePercent": 1.5,
"recommendedRetryDurationInBlocks": 50,
"estimatedDurationSeconds": 163,
"estimatedDurationsSeconds": {
"deposit": 60,
"swap": 12,
"egress": 91
},
"lowLiquidityWarning": true
}

Asset pairs on this route​

Source assetDestination assetQuote at capturePage
cbbtc.ethdot.hubquotedCBBTC to DOT
cbbtc.ethusdc.hubquotedCBBTC to USDC
cbbtc.ethusdt.hubquotedCBBTC to USDT
eth.ethdot.hubquotedETH to DOT
eth.ethusdc.hubquotedETH to USDC
eth.ethusdt.hubquotedETH to USDT
flip.ethdot.hubquotedFLIP to DOT
flip.ethusdc.hubquotedFLIP to USDC
flip.ethusdt.hubquotedFLIP to USDT
usdc.ethdot.hubquotedUSDC to DOT
usdc.ethusdc.hubquotedUSDC to USDC
usdc.ethusdt.hubquotedUSDC to USDT
usdt.ethdot.hubquotedUSDT to DOT
usdt.ethusdc.hubquotedUSDT to USDC
usdt.ethusdt.hubquotedUSDT to USDT
wbtc.ethdot.hubquotedWBTC to DOT
wbtc.ethusdc.hubquotedWBTC to USDC
wbtc.ethusdt.hubquotedWBTC to USDT

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 Ethereum. The deposit address is a Ethereum address, and refundAddress must be valid on Ethereum. See the Ethereum 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 Ethereum addresses; see the Ethereum chain page.
  • destinationAddress must be valid on Asset Hub; see the Asset Hub chain page.
  • Vault swaps are supported from Ethereum 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 Ethereum 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.
  • Asset Hub destination addresses are 64-hex (optional 0x) or Polkadot-prefix-0 SS58; /swap converts SS58 to hex. Other SS58 prefixes are rejected. See the Asset Hub chain page.

FAQ​

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

The minimum eth.eth deposit is 0.01 ETH (10000000000000000 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 Ethereum to Asset Hub swap take?​

The example quote for eth.eth to dot.hub, captured on 2026-11-18, estimated about 2 minutes 43 seconds (163 seconds). Chainflip split it into deposit 60, swap 12 and egress 91 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.