Symbiosis Documentation
Symbiosis NestDeveloper ToolsGo to Bridge & Swap
  • Getting Started with Symbiosis
  • Symbiosis: Frequently Asked Questions
  • Main concepts
    • Glossary
    • Symbiosis SIS Token
    • Symbiosis sTokens
    • Symbiosis: Cross-Chain Swaps
      • Symbiosis: To/From BTC
      • Symbiosis: To/From TON
    • Cross-Chain Zaps
    • Symbiosis as Interchain Communication Protocol
    • Symbiosis & Fees
    • Security Audits
    • Bug Bounty Program
  • Governance
    • 🚩Governing Symbiosis
  • User Guide (WebApp)
    • Symbiosis WebApp
    • Bridge with Symbiosis: sUSDC, sWETH, sWBTC
    • Swap & Bridge with Symbiosis
    • Swap & Bridge To and From Bitcoin
    • Swap & Bridge To and From Tron
    • Stuck Transactions
    • Bridging SIS Token
    • Symbiosis Liquidity Pools
    • Withdrawing from Symbiosis Octopool
    • Cross-Chain Zaps
    • Common Issues and Solutions
    • Where are My Tokens?
    • Symbiosis Explorer
    • More about Slippage Tolerance
  • Reward Programs
    • Symbiosis Reward Programs
    • Farming on Octopools
    • SIS LP Farming
    • veSIS
  • Cross-chain liquidity engine
    • Symbiosis Core Smart Contracts
    • Symbiosis Mint-Burn Process
    • Symbiosis BridgeV2 Contract
    • Symbiosis Routing Contracts
    • Symbiosis & Emergencies
    • Symbiosis Octopools
  • Relayers network
    • Symbiosis Relayers Network
    • Symbiosis PoS Staking & Symbiotic Staking
      • Symbiosis X Symbiotic: SIS Restaking Vault User Guide
    • Relayers Network: Architecture and Operations
    • Symbiosis Relayer Node
    • Symbiosis Relayers Network: Emergencies
  • Developer Tools
    • Symbiosis Developer Tools
    • Symbiosis API
    • Symbiosis JS SDK
      • JS SDK Types
      • JS SDK Configuration
  • Miscellaneous
    • Symbiosis on Testnet
    • Symbiosis Multisig Address on Scroll
    • Symbiosis v1 vs. v2
    • Gasless Crypto Exchanges
  • Follow Us
  • Symbiosis | X
  • Symbiosis | Telegram
  • Symbiosis | Blog
  • Symbiosis | Publish0x
  • Symbiosis | Discord
  • Symbiosis | Linkedin
  • Symbiosis | Github
Powered by GitBook
On this page
  • Understanding Swap Details
  • Customizing Swap Settings
  • How to Perform a Swap
  • Tracking and Troubleshooting Swaps
  • Guaranteed USDC / USDT / WETH / WBTC
  • Managing Your Token List
  • Getting Support

Was this helpful?

  1. User Guide (WebApp)

Swap & Bridge with Symbiosis

Symbiosis guide: Swaps

PreviousBridge with Symbiosis: sUSDC, sWETH, sWBTCNextSwap & Bridge To and From Bitcoin

Last updated 8 hours ago

Was this helpful?

This guide covers settings, fees for on-chain and cross-chain operations, and how to swap tokens using the . You’ll also find tips on tracking and troubleshooting your swaps.

  • For Tron-related swaps, see Swap & Bridge To and From Tron

  • For Bitcoin-related swaps, check Swap & Bridge To and From Bitcoin

  • For common questions and solutions, check out our

Understanding Swap Details

Before making a swap in the Symbiosis WebApp, take a moment to review the details carefully. This guide breaks them down for you step by step.

Customizing Swap Settings

You can adjust the settings by clicking the cogwheel icon. Here’s what you can configure:

Slippage Tolerance

  • What it does: This is the percentage of the trade value you’re willing to accept as a price change.

  • Default value: 2%

  • Tips:

    • For stablecoin swaps, you can set a lower slippage tolerance for better accuracy.

    • Be cautious: a low slippage tolerance may result in higher transaction fees, processing delays, or even transaction failure.

    • Learn More about Slippage Tolerance

Trade Deadline

  • What it does: Automatically cancels the swap if it exceeds the specified time limit.

  • Defaults:

    • On-chain swaps: 20 minutes.

    • Cross-chain swaps: 24 hours (this value is fixed and cannot be changed).

How to Adjust Settings:

  1. Click the cogwheel icon in the interface.

  2. Enter a new value for slippage tolerance or the trade deadline (on-chain swaps only).

  3. Press the Save Changes button.

Done ∎

How to Perform a Swap

Requirements:

  • Ensure you have enough native assets in your wallet to pay for transaction fees on the source network.

Steps to Perform a Cross-Chain Swap:

  1. Connect your wallet.

  2. — (3) Estimated Time: Approximate swap duration.

    — (4) Price Impact: Shows how much the trade size affects the estimated price compared to the market rate.

    — (7) Price: Conversion rate for the swap.

    — (8) Slippage Tolerance: Percentage of the trade value you’re willing to accept as a price change. Adjust this by clicking the gear icon.

    — (9) Minimum Received: The guaranteed minimum tokens you’ll receive.

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.

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

About Symbiosis Explorer

Symbiosis Explorer collects and analyzes data from cross-chain operations performed via the Symbiosis protocol across all supported networks. It provides a detailed status of each operation, helping you track your transactions.

Stuck: What Does It Mean?

The "Stuck" status on a cross-chain swap indicates that the operation is taking longer than usual but is still likely to be completed.

However, if the operation cannot be completed, it will be reverted automatically or manually, depending on when it was initiated:

  • After February 9, 2025: Cross-chain swaps labeled "Stuck" are automatically reverted within 12 hours.

  • Before February 8, 2025: You will need to manually revert the swap by following this guide: Stuck Transactions

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. Repeat Step 2 for every taken you want to add to your token list.

  2. 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.

Navigate to the .

Choose Source Network and Token: in the Transfer from field, select the source network and token you want to swap:

Enter an amount you'd like to exchange (e.g., 0.005 ETH on zkSync Era)

Select Destination Network and Token: in the Transfer to field, select the destination network and token you'd like to receive (e.g. ETH on Optimism):

Wait for Swap Details: The WebApp will find the best rates for your selected token pair and displays details: If you encounter any messages or errors, see Common Issues and Solutions

Review Swap Details: click Show more to review all swap details carefully. Let's review the swap details of our example together: — (1) To Receive: Estimated tokens you’ll get after fees. The final amount may vary slightly based on slippage tolerance. — (2) Route: Intermediate swaps ensuring the best price.

— (5) Discount: Cross-chain fee reduction if you hold tokens. — (6) Fee: The total fees for the swap.

Set Recipient Address (Optional) By default, the recipient’s address matches the sender’s. To send assets to another address, slide the Receive assets to another wallet switch and enter the recipient’s address: !! Use self-custodial wallets only! Avoid exchange or third-party service addresses.

Switch Network (If Prompted) If prompted, click Switch network to… and confirm the action in your wallet:

Approve Tokens (If Required) If you see the Approve [Token Name] button, approve the token for use by confirming the transaction in your wallet. Note: No approval is needed for native assets like ETH.

To initiate the swap, press the Swap button:

Check and confirm the transaction in your connected wallet (e.g., Metamask):

Wait a bit the operation to be completed (you can close the window and perform other swaps in the meantime): Block confirmation: Block confirmations indicate progress, with the number of blocks varying by blockchain.

If you stay in the Symbiosis WebApp you will get a confirmation:

To check the history of your cross-chain operations, please use .

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

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

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

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

If you have any questions or encounter any issue, please contact .

For common questions and solutions, check out our

Symbiosis WebApp
veSIS
Symbiosis Explorer
Symbiosis Explorer
our support team on Discord
FAQ and Troubleshooting Guide

When you sign a transaction in your wallet, all the details you see in the interface are included in the transaction. Learn More about Slippage Tolerance

(1) To Receive: The estimated number of tokens you'll receive, including all fees. The final amount may vary slightly based on slippage tolerance. For instance, if 1,000 tokens are displayed as "to receive" with a 3% slippage tolerance, the final amount will be between 970 and 1,000. Always check the Minimum Received value. (2) Route: Pathway of intermediate swaps ensuring the best price.

Example route: - ETH -> USDC (on Ethereum) via OpenOcean - Bridging to BNB Chain via Symbiosis - USDC -> BNB token (on BNB chain) via OpenOcean

(3) Estimated Time: Approximate time to complete the swap based on network conditions.

(4) Price Impact: Shows how much the trade size affects the estimated price compared to the market rate.

(5) Fee: The total fees for your swap.

(6) Price: Conversion rate for your swap, influenced by trade size.

(7) Slippage Tolerance: Percentage of the trade value you’re willing to accept as a price change. Adjust this by clicking the gear icon.

(8) Minimum Received: The minimum guaranteed amount you'll receive after the swap, based on current rates and settings.

Symbiosis WebApp
FAQ and Troubleshooting Guide