# Bitcoin to Asset Hub Swap API

BTC to DOT swap API: BaaS quotes and swaps from Bitcoin 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

| Item | Value |
| --- | --- |
| Source network | [Bitcoin](https://docs.chainflip-broker.io/chains/bitcoin/) |
| Destination network | [Asset Hub](https://docs.chainflip-broker.io/chains/asset-hub/) |
| Source assets | 1 enabled |
| Destination assets | 3 enabled |
| Anchor pair | `btc.btc` to `dot.hub` |
| Native source minimum | 0.0004 BTC (`40000`) |
| Recommended retry | `300` blocks, at capture, 2026-11-18 |
| Asset pairs | 3, 3 quoted at capture |
| Vault swaps | Supported from Bitcoin (needs the partner's affiliate broker SS58) |
| Boost | Available for Bitcoin deposits |

## Assets and minimums

### Source: Bitcoin

| Asset | id | Decimals | Minimum | Native minimum | Contract |
| --- | --- | ---: | ---: | --- | --- |
| BTC | `btc.btc` | 8 | 0.0004 BTC | `40000` | — |

### Destination: Asset Hub

| Asset | id | Decimals | Contract |
| --- | --- | ---: | --- |
| DOT | `dot.hub` | 10 | — |
| USDC | `usdc.hub` | 6 | `1337` |
| USDT | `usdt.hub` | 6 | `1984` |

Snapshot captured on 2026-11-17 from the production [/assets](https://docs.chainflip-broker.io/features/view-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](https://docs.chainflip-broker.io/features/error-codes/).

## Quote request

```bash
curl --location 'https://chainflip-broker.io/quotes-native?apiKey=87517a91d5f34dbabfc1e410946a3a3c&sourceAsset=btc.btc&destinationAsset=dot.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](https://docs.chainflip-broker.io/environments/testing/).

A successful request returns an array of quotes, which can be empty (`[]`); a failure carries a machine-readable `code`, listed in [Error Codes](https://docs.chainflip-broker.io/features/error-codes/). See [Asking for a Quote](https://docs.chainflip-broker.io/features/ask-quote/) for every field and [Starting a Swap](https://docs.chainflip-broker.io/features/start-swap/#slippage-protection) 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 `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.

```json
{
  "type": "regular",
  "ingressAsset": "btc.btc",
  "ingressAmount": 0.0031511,
  "ingressAmountNative": "315110",
  "intermediateAsset": "usdc.eth",
  "intermediateAmount": 199.40686,
  "intermediateAmountNative": "199406860",
  "egressAsset": "dot.hub",
  "egressAmount": 249.5233405116,
  "egressAmountNative": "2495233405116",
  "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.399613,
      "amountNative": "399613"
    },
    {
      "type": "egress",
      "asset": "dot.hub",
      "amount": 0.019745,
      "amountNative": "197450000"
    },
    {
      "type": "liquidity",
      "asset": "btc.btc",
      "amount": 0,
      "amountNative": "0"
    },
    {
      "type": "liquidity",
      "asset": "usdc.eth",
      "amount": 0,
      "amountNative": "0"
    }
  ],
  "recommendedSlippageTolerancePercent": 2.25,
  "recommendedRetryDurationInBlocks": 300,
  "estimatedDurationSeconds": 1009,
  "estimatedDurationsSeconds": {
    "deposit": 906,
    "swap": 12,
    "egress": 91
  },
  "lowLiquidityWarning": true
}
```

## Asset pairs on this route

| Source asset | Destination asset | Quote at capture | Page |
| --- | --- | --- | --- |
| `btc.btc` | `dot.hub` | quoted | [BTC to DOT](https://docs.chainflip-broker.io/routes/bitcoin-to-asset-hub/btc-to-dot/) |
| `btc.btc` | `usdc.hub` | quoted | [BTC to USDC](https://docs.chainflip-broker.io/routes/bitcoin-to-asset-hub/btc-to-usdc/) |
| `btc.btc` | `usdt.hub` | quoted | [BTC to USDT](https://docs.chainflip-broker.io/routes/bitcoin-to-asset-hub/btc-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](https://docs.chainflip-broker.io/resources/pricing/), [View Earned Fees](https://docs.chainflip-broker.io/features/view-fees/) and [Starting a Swap](https://docs.chainflip-broker.io/features/start-swap/#custom-commission-bps).

## Deposit and refund rules

A [`/swap`](https://docs.chainflip-broker.io/features/start-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](https://docs.chainflip-broker.io/features/start-swap/#slippage-protection) and [live price protection](https://docs.chainflip-broker.io/features/start-swap/#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](https://docs.chainflip-broker.io/chains/bitcoin/) 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 Bitcoin addresses; see the [Bitcoin chain page](https://docs.chainflip-broker.io/chains/bitcoin/).
* `destinationAddress` must be valid on Asset Hub; see the [Asset Hub chain page](https://docs.chainflip-broker.io/chains/asset-hub/).
* Vault swaps are supported from Bitcoin 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](https://docs.chainflip-broker.io/features/tx-payload/).
* Bitcoin deposits can use Boost: `boostFee` is 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](https://docs.chainflip-broker.io/features/ask-quote/#boost) and [Starting a Swap](https://docs.chainflip-broker.io/features/start-swap/#boost).
* 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](https://docs.chainflip-broker.io/chains/asset-hub/).

## FAQ

### What is the minimum source amount for BTC to DOT?

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 a Bitcoin to Asset Hub swap take?

The example quote for `btc.btc` to `dot.hub`, 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, 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](https://docs.chainflip-broker.io/resources/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](https://docs.chainflip-broker.io/features/start-swap/#custom-commission-bps).

## Related

- [All swap routes](https://docs.chainflip-broker.io/routes/)
- [Bitcoin chain page](https://docs.chainflip-broker.io/chains/bitcoin/)
- [Asset Hub chain page](https://docs.chainflip-broker.io/chains/asset-hub/)
- [Asking for a Quote](https://docs.chainflip-broker.io/features/ask-quote/)
- [Starting a Swap](https://docs.chainflip-broker.io/features/start-swap/)
- [View Available Assets](https://docs.chainflip-broker.io/features/view-assets/)
- [View Available Networks](https://docs.chainflip-broker.io/features/view-networks/)
- [Pricing](https://docs.chainflip-broker.io/resources/pricing/)
- [Error Codes](https://docs.chainflip-broker.io/features/error-codes/)
