Skip to main content

Asset Hub to Ethereum Swap API

DOT to ETH swap API: BaaS quotes and swaps from Polkadot Asset Hub 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 networkAsset Hub
Destination networkEthereum
Source assets3 enabled
Destination assets6 enabled
Anchor pairdot.hub to eth.eth
Native source minimum4 DOT (40000000000)
Recommended retry50 blocks, at capture, 2026-11-18
Asset pairs18, 18 quoted at capture
Vault swapsNot supported from Asset Hub; use a /swap deposit channel
BoostNot applicable (Boost applies only to Bitcoin deposits)

Assets and minimums​

Source: Asset Hub​

AssetidDecimalsMinimumNative minimumContract
DOTdot.hub104 DOT40000000000—
USDCusdc.hub620 USDC200000001337
USDTusdt.hub620 USDT200000001984

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

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 4 DOT (40000000000 native units) from dot.hub 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": "dot.hub",
"ingressAmount": 4,
"ingressAmountNative": "40000000000",
"intermediateAsset": "usdc.eth",
"intermediateAmount": 2.207315,
"intermediateAmountNative": "2207315",
"egressAsset": "eth.eth",
"egressAmount": 0.001219260546863323,
"egressAmountNative": "1219260546863323",
"includedFees": [
{
"type": "ingress",
"asset": "dot.hub",
"amount": 0.01973,
"amountNative": "197300000"
},
{
"type": "network",
"asset": "usdc.eth",
"amount": 0.5,
"amountNative": "500000"
},
{
"type": "broker",
"asset": "usdc.eth",
"amount": 0.004423,
"amountNative": "4423"
},
{
"type": "egress",
"asset": "eth.eth",
"amount": 0.000028441360332,
"amountNative": "28441360332000"
},
{
"type": "liquidity",
"asset": "dot.hub",
"amount": 0,
"amountNative": "0"
},
{
"type": "liquidity",
"asset": "usdc.eth",
"amount": 0,
"amountNative": "0"
}
],
"recommendedSlippageTolerancePercent": 0.5,
"recommendedRetryDurationInBlocks": 50,
"estimatedDurationSeconds": 117,
"estimatedDurationsSeconds": {
"deposit": 9,
"swap": 12,
"egress": 96
},
"lowLiquidityWarning": true
}

Asset pairs on this route​

Source assetDestination assetQuote at capturePage
dot.hubcbbtc.ethquotedDOT to CBBTC
dot.hubeth.ethquotedDOT to ETH
dot.hubflip.ethquotedDOT to FLIP
dot.hubusdc.ethquotedDOT to USDC
dot.hubusdt.ethquotedDOT to USDT
dot.hubwbtc.ethquotedDOT to WBTC
usdc.hubcbbtc.ethquotedUSDC to CBBTC
usdc.hubeth.ethquotedUSDC to ETH
usdc.hubflip.ethquotedUSDC to FLIP
usdc.hubusdc.ethquotedUSDC to USDC
usdc.hubusdt.ethquotedUSDC to USDT
usdc.hubwbtc.ethquotedUSDC to WBTC
usdt.hubcbbtc.ethquotedUSDT to CBBTC
usdt.hubeth.ethquotedUSDT to ETH
usdt.hubflip.ethquotedUSDT to FLIP
usdt.hubusdc.ethquotedUSDT to USDC
usdt.hubusdt.ethquotedUSDT to USDT
usdt.hubwbtc.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 Asset Hub. The deposit address is a Asset Hub address, and refundAddress must be valid on Asset Hub. See the Asset Hub 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 Asset Hub addresses; see the Asset Hub chain page.
  • destinationAddress must be valid on Ethereum; see the Ethereum chain page.
  • Vault swaps are not supported for Asset Hub source assets; use /swap deposit channels and see Vault Swap Transaction Payloads.
  • boostFee is accepted and validated (0–100) for Asset Hub 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.

FAQ​

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

The minimum dot.hub deposit is 4 DOT (40000000000 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 Asset Hub to Ethereum swap take?​

The example quote for dot.hub to eth.eth, captured on 2026-11-18, estimated about 1 minutes 57 seconds (117 seconds). Chainflip split it into deposit 9, 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.