Swap & Bridge To and From Bitcoin
Symbiosis guide: Swaps to and from BTC
Last updated
Was this helpful?
Symbiosis guide: Swaps to and from BTC
Last updated
Was this helpful?
Symbiosis facilitates cross-chain exchanges between BTC and any token on supported blockchain networks. It allows users two ways to engage: exchanging BTC for tokens and vice versa, exchanging tokens for BTC on the Bitcoin network.
For a deeper dive into the mechanics of BTC exchanges with Symbiosis, refer to this article Symbiosis: To/From BTC
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: Have an address on the destination network that you control.
Specify Exchange Details: Open the Symbiosis WebApp and specify the details of the exchange: Amount of BTC to exchange, destination blockchain and token, destination address on the chosen blockchain
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.
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.
Navigate to Symbiosis WebApp.
Specify exchange details: (1) Select BTC as “From”, (2) Enter the BTC amount for exchange, (3) Select the destination chain and token (e.g., USDC on Ethereum), (4) Specify the destination address: - Enter the address manually into the field, or - Connect a wallet, select the desired address in the wallet, and it will be automatically used as the destination address. Important: Currently, Symbiosis WebApp doesn’t support BTC wallets.
Once all details are specified, the Symbiosis WebApp will calculate a quote for the exchange. 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. - The estimated amount is based on the exchange rates across the entire sequence of intermediary swaps needed to obtain the destination tokens. - 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.
Click the “Continue” button:
Read and follow the instructions provided in Symbiosis WebApp on the next step: You initiate the cross-chain exchange by sending the specified amount of BTC to the address in the BTC → Token exchange quote. The address will be new for each new cross-chain swap. Please don't reuse the address.
Disclaimer: If the amount sent is incorrect, the time limit has expired, or BTC tokens are sent repeatedly to the same address, the exchange will be stopped. Please refer to the Problems and Solutions section below for information on how to handle a problem if it occurs.
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 exchange for the specified tokens. If you send different BTC amount or send when time limit is over, the exchange will be stopped. Please check the Problems and Solutions section below.
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.
Keep the Swap Instructions Page Open: Once you send BTC to the specified address, the Symbiosis WebApp will automatically detect the transfer and continue displaying the swap progress on the same page. If you close the page and would like to check you swap later, please use Symbiosis Explorer.
There are two ways to track your exchange:
Keep the Swap Instructions Page Open: Once you send BTC to the specified address, the Symbiosis WebApp will automatically detect the transfer and continue displaying the swap progress on the same page.
Use Symbiosis Explorer: You can also track your exchange by entering your transaction details into Symbiosis Explorer.
To exchange a token for BTC, ensure the following:
Token Availability: The tokens you want to exchange must be available in an address you control on a supported network.
Wallet: Use a wallet that is supported in the Symbiosis WebApp, such as MetaMask or TronLink, depending on the source chain from which you are exchanging tokens.
Destination BTC Address: Have a Bitcoin network address that you control for receiving the BTC.
Connect Your Wallet: Open the Symbiosis WebApp and connect a supported wallet.
Specify Exchange Details: Specify the details of the exchange: the source token and blockchain network, the amount of tokens to exchange, BTC as the destination token, and the destination address on the Bitcoin network.
Review the Quote, Sign and Send a Transaction: After receiving the quote, review the swap details. If the terms are acceptable, sign the transaction in your connected wallet and send it to the source chain.
Receive BTC: Once the cross-chain operation is processed, BTC amount will be sent to the specified address on the Bitcoin network. Note that this process may take longer than typical cross-chain swaps between other blockchain networks.
Navigate to Symbiosis WebApp.
Connect your wallet for the source chain.
Review the swap details. If the terms are acceptable, click the “Swap” button and confirm the transaction in your wallet.
Receive BTC. Once the cross-chain operation is processed, the BTC will be sent to the specified address on the Bitcoin network. Note that this process may take longer than typical cross-chain swaps between other blockchain networks.
There are two ways to track your exchange:
Keep Symbiosis WebApp Open: Symbiosis WebApp will continue displaying the swap progress.
Use Symbiosis Explorer: You can also track your exchange by entering your transaction details into Symbiosis Explorer.
BTC Sent 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.
Stuck cross-chain swap
Issue: You see that your swap is marked as Stuck in the Symbiosis Explorer.
Why it happens: A technical issue, such as rate changes on an intermediate DEX.
Solution: Revert and swap:
Revert the transaction through the Symbiosis WebApp.
The tokens will be returned to the EVM address specified as the recipient in the BTC → Token exchange.
Once reverted, you can swap the returned tokens for any supported token or convert them back to BTC.
Received syBTC on BNB Chain
Issue: You received syBTC on BNB Chain.
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.
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.
Stuck cross-chain swap
Issue: You see that your swap is marked as Stuck in the Symbiosis Explorer.
Why it happens: A technical issue, such as rate changes on an intermediate DEX.
Solution: Revert the transaction through the Symbiosis WebApp.
Received syBTC on BNB Chain
Issue: You received syBTC on BNB Chain.
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.
Remember, never share your pass phrases or any other sensitive information with anyone.
If you have any questions, please contact our support team on Discord.
Specify exchange details: (1) Select the source chain and the token on that chain as “From” (e.g., ETH on the Ethereum network), (2) Enter the amount of tokens to exchange, (3) Select the Bitcoin network and BTC as “To”, (4) Specify the destination address on the Bitcoin network.
Once all details are specified, the Symbiosis WebApp will calculate a quote for the exchange. Review the swap details: Scroll down and expand “Show More”:
Please note that 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. - The estimated amount is based on the exchange rates across the entire sequence of intermediary swaps needed to obtain the destination tokens. - 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. Two Implementations While Exchanging a Token for BTC: Currently, the Symbiosis protocol supports two methods for exchanging a token for BTC: using the Symbiosis BTC bridge and using the ThorChain BTC bridge. For each token → BTC swap, Symbiosis WebApp compares both methods and shows the one that offers the best deal.
