> ## Documentation Index
> Fetch the complete documentation index at: https://quantumfinance.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Convert Tokens via the Built-In Quantum Swap Feature

> Use the built-in DEX integration to convert between BNB, USDT, USDC, ETH, SOL, XRP, and SUI directly from your Wallet tab on BNB Chain.

Quantum Swap is the built-in token conversion feature that routes trades through PancakeSwap on BNB Chain. You can convert between any supported tokens without leaving the app. In Demo mode the swap is simulated and logged to your history; in Real mode a live DEX transaction is broadcast to the chain.

## Access Quantum Swap

Open the **Wallet tab**, then click the **Convert** quick-action button. The Quantum Swap modal opens.

## Execute a swap

<Steps>
  <Step title="Select the token you are swapping from">
    In the **From** panel, choose a token from the dropdown. The modal shows all tokens that have a balance in your wallet. You can click **Max Available** to pre-fill the input with your full balance of that token.
  </Step>

  <Step title="Enter the amount">
    Type the amount you want to swap in the input field on the right side of the From panel. The USD equivalent updates instantly below the input.
  </Step>

  <Step title="Select the token you are swapping to">
    In the **To (Estimated)** panel, choose the destination token. The estimated output amount is calculated using live prices and displayed in green.

    <Tip>
      Click the orange arrow button between the two panels to flip the From and To tokens.
    </Tip>
  </Step>

  <Step title="Review and execute">
    Check the estimated output, then click **Execute Swap**. In Real mode, your wallet prompts you to confirm the on-chain transaction.
  </Step>
</Steps>

## Supported tokens

You can swap between any combination of the following tokens, provided your wallet holds a balance of the source token:

BNB, USDT, USDC, ETH, SOL, XRP, SUI

## Demo mode vs Real mode

<Tabs>
  <Tab title="Demo mode">
    The swap is simulated using live price data to calculate the output amount. No transaction is sent to the chain. The conversion is logged to your Recent Activity feed and deducted from your demo balance. Use Demo mode to test swap flows without spending real funds.
  </Tab>

  <Tab title="Real mode">
    The swap is executed as a live transaction on BNB Chain through PancakeSwap. The app fetches a real price quote from the router, applies a 1% slippage tolerance, and broadcasts the transaction. On success, you receive a transaction hash you can verify on [BscScan](https://testnet.bscscan.com).
  </Tab>
</Tabs>

## Gas requirements

All Real mode swaps require a small amount of BNB to pay network gas fees.

* **Swapping from BNB** — at least **0.01 BNB** must remain in your wallet after the swap to cover fees. The app automatically adjusts your swap amount if needed.
* **Swapping from a token** — your wallet must hold at least **0.005 BNB** for gas before the swap can proceed.

<Warning>
  Ensure you hold enough BNB for gas before initiating a swap. If your BNB balance is too low, the transaction will fail with a gas error.
</Warning>

## Slippage and liquidity

The swap uses a **1% slippage tolerance**. If the price moves more than 1% between when you request a quote and when the transaction confirms, the transaction will revert.

<Note>
  PancakeSwap testnet liquidity pools may be thin or empty for some pairs. If there is no liquidity for a pair, the swap will fail with a liquidity error. In that case, switch to Demo mode to test the swap flow, or try a different token pair.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.