BTC on Bitcoin to USDT on Asset Hub Swap API
BTC on Bitcoin to USDT on Polkadot Asset Hub swap API: a working BaaS quote request for btc.btc to usdt.hub, the source minimum, a captured example or the recorded quote availability, fees including your commission, and the deposit and refund rules for Bitcoin.
Pair at a glance
| Item | Value |
|---|---|
| Source asset | btc.btc |
| Source ticker | BTC |
| Source network | Bitcoin |
| Source decimals | 8 |
| Source contract | — |
| Destination asset | usdt.hub |
| Destination ticker | USDT |
| Destination network | Asset Hub |
| Destination decimals | 6 |
| Destination contract | 1984 |
| Source minimum | 0.0004 BTC (40000) |
| Quote at capture | quoted on 2026-11-18 |
| Recommended retry | 300 blocks, at capture |
| Vault swaps | Supported from Bitcoin (needs the partner's affiliate broker SS58) |
| Boost | Available for Bitcoin deposits |
Quote request
curl --location 'https://chainflip-broker.io/quotes-native?apiKey=87517a91d5f34dbabfc1e410946a3a3c&sourceAsset=btc.btc&destinationAsset=usdt.hub&amount=315110'
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.0031511 BTC (315110 native units) from btc.btc to usdt.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": "btc.btc",
"ingressAmount": 0.0031511,
"ingressAmountNative": "315110",
"intermediateAsset": "usdc.eth",
"intermediateAmount": 199.586847,
"intermediateAmountNative": "199586847",
"egressAsset": "usdt.hub",
"egressAmount": 199.55136,
"egressAmountNative": "199551360",
"includedFees": [
{
"type": "ingress",
"asset": "btc.btc",
"amount": 0.00000156,
"amountNative": "156"
},
{
"type": "network",
"asset": "usdc.eth",
"amount": 0.5,
"amountNative": "500000"
},
{
"type": "broker",
"asset": "usdc.eth",
"amount": 0.399974,
"amountNative": "399974"
},
{
"type": "egress",
"asset": "usdt.hub",
"amount": 0.015529,
"amountNative": "15529"
},
{
"type": "liquidity",
"asset": "btc.btc",
"amount": 0,
"amountNative": "0"
},
{
"type": "liquidity",
"asset": "usdc.eth",
"amount": 0,
"amountNative": "0"
}
],
"recommendedSlippageTolerancePercent": 2.25,
"recommendedRetryDurationInBlocks": 300,
"recommendedLivePriceSlippageTolerancePercent": 0.75,
"estimatedDurationSeconds": 1009,
"estimatedDurationsSeconds": {
"deposit": 906,
"swap": 12,
"egress": 91
},
"lowLiquidityWarning": false
}
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.
minimumPriceandrefundAddressare required.retryDurationInBlocksis 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'srecommendedRetryDurationInBlocks.- 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 Bitcoin. The deposit address is a Bitcoin address, and refundAddress must be valid on Bitcoin. See the Bitcoin chain page for address formats and deposit details.
Route notes
- Chainflip recommends
300blocks (30 minutes) when BTC is on either side and50blocks (5 minutes) otherwise, so300blocks on this route; use the quote'srecommendedRetryDurationInBlocks. - Source deposits and refunds use Bitcoin addresses; see the Bitcoin chain page.
destinationAddressmust be valid on Asset Hub; see the Asset Hub chain page.- Vault swaps are supported from Bitcoin source assets and require the partner's affiliate broker SS58; otherwise
/tx-payload/*answers 400Partner is not yet set up for vault swaps.See Vault Swap Transaction Payloads. - Bitcoin deposits can use Boost:
boostFeeis the maximum accepted Boost fee in basis points (0–100 bps, 0–1%), advised 30 bps; a boosted deposit is pre-witnessed after one block when Boost liquidity is available, and the Boost fee is not refunded. See Asking for a Quote and Starting a Swap. - Asset Hub destination addresses are 64-hex (optional
0x) or Polkadot-prefix-0SS58;/swapconverts SS58 to hex. Other SS58 prefixes are rejected. See the Asset Hub chain page.
FAQ
What is the minimum BTC amount?
The minimum btc.btc deposit is 0.0004 BTC (40000 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 it take?
The example quote captured on 2026-11-18 estimated about 16 minutes 49 seconds (1009 seconds). Chainflip split it into deposit 906, swap 12 and egress 91 seconds. This is an example, not a promise: use the estimatedDurationSeconds of your own quote.
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.