Skip to main content

Arbitrum to Bitcoin Swap API

ETH to BTC swap API: BaaS quotes and swaps from Arbitrum to Bitcoin 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 networkArbitrum
Destination networkBitcoin
Source assets3 enabled
Destination assets1 enabled
Anchor paireth.arb to btc.btc
Native source minimum0.0039 ETH (3900000000000000)
Recommended retry300 blocks, at capture, 2026-11-18
Asset pairs3, 3 quoted at capture
Vault swapsSupported from Arbitrum (needs the partner's affiliate broker SS58)
BoostNot applicable (Boost applies only to Bitcoin deposits)

Assets and minimums​

Source: Arbitrum​

AssetidDecimalsMinimumNative minimumContract
ETHeth.arb180.0039 ETH3900000000000000—
USDCusdc.arb610 USDC100000000xaf88d065e77c8cC2239327C5EDb3A432268e5831
USDTusdt.arb610 USDT100000000xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9

Destination: Bitcoin​

AssetidDecimalsContract
BTCbtc.btc8—

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.arb&destinationAsset=btc.btc&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.arb to btc.btc. 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.arb",
"ingressAmount": 0.11309338686420312,
"ingressAmountNative": "113093386864203116",
"intermediateAsset": "usdc.eth",
"intermediateAmount": 199.332532,
"intermediateAmountNative": "199332532",
"egressAsset": "btc.btc",
"egressAmount": 0.00313914,
"egressAmountNative": "313914",
"includedFees": [
{
"type": "ingress",
"asset": "eth.arb",
"amount": 0.0000012,
"amountNative": "1200000000000"
},
{
"type": "network",
"asset": "usdc.eth",
"amount": 0.5,
"amountNative": "500000"
},
{
"type": "broker",
"asset": "usdc.eth",
"amount": 0.399464,
"amountNative": "399464"
},
{
"type": "egress",
"asset": "btc.btc",
"amount": 0.00000386,
"amountNative": "386"
},
{
"type": "liquidity",
"asset": "eth.arb",
"amount": 0,
"amountNative": "0"
},
{
"type": "liquidity",
"asset": "usdc.eth",
"amount": 0,
"amountNative": "0"
}
],
"recommendedSlippageTolerancePercent": 2.5,
"recommendedRetryDurationInBlocks": 300,
"recommendedLivePriceSlippageTolerancePercent": 1,
"estimatedDurationSeconds": 408.65,
"estimatedDurationsSeconds": {
"deposit": 6.65,
"swap": 12,
"egress": 390
},
"lowLiquidityWarning": false
}

Asset pairs on this route​

Source assetDestination assetQuote at capturePage
eth.arbbtc.btcquotedETH to BTC
usdc.arbbtc.btcquotedUSDC to BTC
usdt.arbbtc.btcquotedUSDT to BTC

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 Arbitrum. The deposit address is a Arbitrum address, and refundAddress must be valid on Arbitrum. See the Arbitrum 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 300 blocks on this route; use the quote's recommendedRetryDurationInBlocks.
  • Source deposits and refunds use Arbitrum addresses; see the Arbitrum chain page.
  • destinationAddress must be valid on Bitcoin; see the Bitcoin chain page.
  • Vault swaps are supported from Arbitrum 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 Arbitrum 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 ETH to BTC?​

The minimum eth.arb deposit is 0.0039 ETH (3900000000000000 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 Arbitrum to Bitcoin swap take?​

The example quote for eth.arb to btc.btc, captured on 2026-11-18, estimated about 6 minutes 49 seconds (408.65 seconds). Chainflip split it into deposit 6.65, swap 12 and egress 390 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.