Swap Bitcoin

BTC walkthrough: How to swap BTC across supported blockchains using the Symbiosis WebApp

This guide shows how to swap BTC using Symbiosis.

• For Tron-related swaps, see Tron: Swap with Low Fees

• For a deeper dive into the mechanics of BTC exchanges with Symbiosis, refer to this article Symbiosis: To/From BTC

Requirements

To exchange BTC for a token, ensure the following:

• BTC Availability: BTC must be available on an address you control on the Bitcoin network.

• BTC Wallet: Use a wallet that supports network operations, such as Electrum or Trust Wallet.

• Destination Address and Refund Addresses: Use addresses that you control.

BTC Swap

Connon Flow:

1. Specify Swap Details: Open the Symbiosis WebApp and specify the swap details: a BTC amount, destination blockchain and token, destination and rufund addresses.

2. Review the Quote and send BTC: After receiving the quote, review the swap details. If the terms are acceptable, use your chosen Bitcoin wallet to send the specified BTC amount to the address provided in the quote.

3. Receive Tokens: Once the cross-chain operation is processed, the tokens will be sent to the specified address on the destination chain. Note that this process may take longer than typical cross-chain swaps between other blockchain networks.

Guide

1. Navigate to Symbiosis WebApp.

2. Specify swap details and review quated details:

(1) Select BTC and enter the BTC amount to swap

(2) Select the destination chain and token (e.g., USDT on Tron)

(3) Specify the destination address:

• Connect a wallet, select the desired address in the wallet, and it will be automatically used as the destination address.

• Enter the address manually

(4) Enter the BTC refund address: if something goes wrong on the initial stage, your BTC tokens will be automatically returned to the address

(5) Enter EVM refund address: BTC swaps are routed through EVM chains. If the destination network is non-EVM, this address will be used for refunds if the swap cannot be completed during the EVM stage. By default, the address is taken from the connected EVM wallet.

(6 & 7) Review the swap details Please note that if the specified BTC amount is sent, the exact amount you receive will fall between the estimated amount shown in the To field and the minimum received amount displayed in the swap details:

• (2) The estimated amount is based on the exchange rates across the entire sequence of intermediary swaps needed to obtain the destination tokens.

• (6) The minimum received amount is calculated from the estimated amount, taking into account the slippage tolerance set for this cross-chain operation. Both the estimated and minimum received amounts include all fees associated with the cross-chain exchange. If the terms are acceptable.

When ready, press the Continue button

1. When you press the Continue button a unique BTC address that is specific for this swap is generated. Read and follow the instructions provided in the Symbiosis WebApp on the next step: When you send the specified BTC amount to this address, it will initiate the cross-chain swap. Important: The BTC address is unique for each cross-chain swap. Please don't reuse the address. If the amount sent is incorrect, the time limit has expired, or BTC tokens are sent repeatedly to the same address, the swap will be stopped. Please refer to the Problems and Solutions section below for information on how to handle a problem if it occurs.

2. Send the specified BTC amount to the specified BTC address. For each swap a unique BTC address is generated. Sending the specified BTC amount to the provided BTC address triggers the cross-chain swap for the specified tokens.

3. Receive tokens. Once the cross-chain operation is processed, the tokens is sent to the specified address on the destination chain. Note that process may take longer than typical cross-chain swaps between other blockchain networks.

Swap Tracking

There are two ways to track your exchange:

1. Keep Symbiosis WebApp Open: Symbiosis WebApp will continue displaying the swap progress.

2. Use Symbiosis Explorer: You can also track your exchange by entering your transaction details into Symbiosis Explorer.

Problems and Solutions

1. BTC deposited but Nothing Received

   • Issue: You sent BTC to the specified address on the BTC blockchain but haven't received anything on the destination network.

   • Why it happens:

     • You sent a different BTC amount than required

     • A technical issue occurred (e.g., rates on an intermediate DEX changed).

   • Solution: To complete the exchange or to retrieve your BTC, please contact support: Support.

2. Received WBTC or USDC Instead of the Specified Token

   • Issue: You received WBTC or USDC/USDT instead of your originally selected token.

   • Why it happens: When exchanging tokens across blockchains, transactions aren't processed instantly. If the exchange rate on the destination network changes during processing, and the new conditions don't meet the original terms, you may receive WBTC or USDC/USDT instead of the token you selected. Symbiosis uses WBTC & USDC/USDT as transit tokens to process cross-chain operations.

   • Solution: WBTC/USDC/USDT can be exchanged for any other token on the supported networks.

3. Received syBTC

   • Issue: You received syBTC

   • Why it happens:

     • Rates changed on an intermediate DEX, preventing the swap from completing as expected.

     • You received syBTC after reverting a stuck swap.

   • Solution: You can swap syBTC for any supported token or unwrap it back to BTC.

Support

Never share your seed phrase, private keys, or wallet recovery information with anyone.

If you have any questions, please contact our support team on Discord.