Swap Tokens

General walkthrough: How to swap tokens across supported blockchains using the Symbiosis WebApp.

This guide shows how to swap tokens between different blockchains using Symbiosis.

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

• For Bitcoin-related swaps, check Swap Bitcoin

Steps to Perform a Cross-Chain Swap

Symbiosis WebApp is available at https://app.symbiosis.finance/

Before you start: Make sure you have enough native tokens (gas) on the source network to pay transaction fees.

1. Select your From and To tokens and chains.

2. Enter the amount of tokens you want to swap (From).

3. Review swap details: Do not skip this step Symbiosis automatically finds the best route for your selected token pair and amount. Always review the output before confirming the swap. Key values to check:

   1. The estimated amount to receive (1)

   2. USD values (2)

   3. Minimum received (4)

   Swap details complete explanation:

(1) To amount: Estimated amount you will receive on the destination network. The final amount may vary slightly due to slippage. (2) USD values: Approximate USD value of the selected amounts. Useful for comparison.

(3) Receive to another wallet: The recipient address is taken from the connected wallet. You can specify a different address here.

(4) Minimum received: The minimum guaranteed amount you will receive after the swap, based on current rates and settings.

(5) Price: Current conversion rate for your swap, influenced by trade size.

(6) Slippage Tolerance: Percentage of the trade value you’re willing to accept as a price change. It can be adjusted via the settings icon.

(7) Estimated time: Expected time to complete the cross-chain swap, based on historical data. (8) Price impact: How much this swap affects the market price. (9) Fee: Total estimated fee for the swap. (10) Route: The path your swap takes across tokens and blockchains to get the best price.

1. Connect wallet & switch network Connect your wallet and switch to the required source network when prompted.

2. Approve token (if needed)

   1. Native tokens (ETH, BNB, etc.) do not require approval.

   2. Non-native tokens (USDC, USDT, etc.) require Approve.

   Approval gives Symbiosis permission to use the selected token for the swap.

3. Confirm the swap Click Swap and confirm the transaction in your wallet.

4. Wait for completion Cross-chain swaps usually take 1–3 minutes. Swaps involving the Bitcoin network may take longer.

5. Track your swap You can track the status and history of your swaps using Symbiosis Explorer.

Done ∎

Tracking and Troubleshooting Swaps

There are two types of swaps that you can perform through Symbiosis WebApp:

On-Chain Swap

• Definition: You exchange tokens on the same blockchain. Example: Swapping ETH for USDC on Ethereum is an on-chain swap.

• How to Check:

  • Copy the transaction hash from your wallet.

  • Use the block explorer of the blockchain where the swap was performed (e.g., Etherscan for Ethereum).

Cross-Chain Swap

• Definition: You exchange tokens across different blockchains. Example: Swapping ETH on Ethereum for USDC on the BNB chain is a cross-chain swap.

• How to Check:

  • Copy the transaction hash or address from your wallet.

  • Use the Symbiosis Explorer to track your cross-chain operation. Note: Symbiosis Explorer does not collect information about on-chain swaps.

  • Cross-chain swaps involve several transactions across chains, so checking only one transaction won’t give you the full picture.

Stuck: What Does It Mean?

The “Stuck” status on a cross-chain swap in the Symbiosis Explorer at https://explorer.symbiosis.finance/ indicates that the operation is taking longer than usual, but is still likely to be completed.

If the operation cannot be completed, it will be reverted automatically within one hour. In some rare cases, you may need to contact our team to complete or revert a stalling cross-chain operation. See contact information below: Getting Support

Guaranteed USDC / USDT / WETH / WBTC

In rare cases, you may receive stablecoins (USDC, USDT), WETH, or WBTC on the destination network, even if you selected a different token as the destination token.

Why Does This Happen?

Cross-chain swaps involve exchanging assets between different blockchains, and these operations are not instantaneous. If the exchange rate on the destination network changes during the processing time and the new conditions no longer meet the stated ones, the Symbiosis protocol will deliver a stablecoin, WETH, or WBTC instead of the originally selected token.

Why stablecoins, WETH, or WBTC tokens?

Stablecoins, WETH and WBTC tokens have the same face value across different networks, making them ideal transit tokens for routing cross-chain operations within the Symbiosis protocol.

Previous Approach vs. Current Approach

• Old Flow: Stuck Cross-Chain Operations Previously, if the exchange rate on the destination network changed and the swap couldn’t meet the stated conditions:

  • The operation was halted and the user had to send an additional transaction to revert the funds.

  • Tokens were refunded on the source network, meaning: users received tokens back on the source chain. Transaction and cross-chain fees were spent, even though the operation wasn’t completed.

• Current Flow: Guaranteed Tokens on the Destination Network To improve user experience, Symbiosis introduced a new approach: if the swap cannot meet the stated conditions due to rate changes, then stablecoins, WETH, or WBTC are delivered directly to the destination network. This eliminates the need for users to send additional transactions or pay extra fees to recover their funds.

Managing Your Token List

With the Symbiosis WebApp, you can create and manage your own custom token list. This feature is especially useful in the following scenarios:

• The token you need isn’t included in the default token list.

• You frequently swap a few specific tokens and want quick access to them instead of searching through the general list every time.

Steps to Add Tokens to the Custom Token List

1. To open your custom token list, expand the default token list: the Transfer from or Transfer to section and click on the cogwheel icon:

2. Add Token: Enter the token address (1) and click the "+" sign to add the token to your custom token list (2):

3. Repeat Step 2 for every taken you want to add to your token list.

4. Next time you go to your custom token list you will see all added tokens:

5. To remove a token, click the bin icon next to the token in your token list.

Done ∎

Getting Support

Remember, never share your pass phrases or any other sensitive information with anyone.

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

The following information will help us resolve the matter faster:

• The transaction hash or a link to the transaction in the appropriate block explorer or in the Symbiosis Explorer.

• The sender's wallet address.

• Relative screenshots.

For common questions and solutions, check out our FAQ and Troubleshooting Guide