Bitcoin to Tron Swap API
BTC to TRX swap API: BaaS quotes and swaps from Bitcoin to Tron 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 |
| Destination network | Tron |
| Source assets | 1 enabled |
| Destination assets | 2 enabled |
| Anchor pair | btc.btc to trx.tron |
| Native source minimum | 0.0004 BTC (40000) |
| Recommended retry | 300 blocks, at capture, 2026-11-18 |
| Asset pairs | 2, 2 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: Tron
| Asset | id | Decimals | Contract |
|---|---|---|---|
| TRX | trx.tron | 6 | — |
| USDT | usdt.tron | 6 | TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t |
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=btc.btc&destinationAsset=trx.tron&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 trx.tron. 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.40686,
"intermediateAmountNative": "199406860",
"egressAsset": "trx.tron",
"egressAmount": 633.89294,
"egressAmountNative": "633892940",
"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": "trx.tron",
"amount": 7.4016,
"amountNative": "7401600"
},
{
"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.5,
"estimatedDurationsSeconds": {
"deposit": 906,
"swap": 12,
"egress": 91.5
},
"lowLiquidityWarning": false
}
Asset pairs on this route
| Source asset | Destination asset | Quote at capture | Page |
|---|---|---|---|
btc.btc | trx.tron | quoted | BTC to TRX |
btc.btc | usdt.tron | quoted | 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, 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 Tron; see the Tron 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.
FAQ
What is the minimum source amount for BTC to TRX?
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 Tron swap take?
The example quote for btc.btc to trx.tron, captured on 2026-11-18, estimated about 16 minutes 50 seconds (1009.5 seconds). Chainflip split it into deposit 906, swap 12 and egress 91.5 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.