> For the complete documentation index, see [llms.txt](https://docs.qwerti.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qwerti.ai/user-guideline/swaps.md).

# Swaps

The **Swap with Crypto** flow lets you exchange one token for another, on the same chain or across chains, using your connected wallet or embedded smart wallet.

**Qwerti works as an aggregator:**\
it finds a route through trusted providers (like Jupiter, Relay, 1inch, OKX and others), builds the transaction, and lets you confirm it in a few clicks.

***

### 1. What You Can Do with Swaps

With the swap flow in Qwerti, you can:

* Swap tokens **on the same chain** (e.g. **SOL → BONK** token on Solana)
* Perform **cross-chain swaps** (e.g. **PEPE on Ethereum → BONK on Solana**)
* Use either:
  * your own self-custody wallet
  * or an embedded smart wallet created via socials / email

Depending on the route, a swap can be:

* a simple **mono-chain swap**, or
* direct c**ross-chain swap**, or
* a **bridge + swap** sequence under the hood.

Qwerti hides this complexity and shows you a single, clean flow.

***

### 2. Starting a Swap

#### Step 1 — Select source chain & token

<div align="left"><figure><img src="https://3803314902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4r8jx3ygI23Ws0qagtg7%2Fuploads%2FYpMjwAYIiufPXl2g5N7K%2Fimage.png?alt=media&amp;token=7cedf634-f09a-48a5-8621-fd8a2d906698" alt="" width="563"><figcaption></figcaption></figure></div>

In the **“Swap”** section:

1. Select the **network (chain)** where your funds are located\
   (for example: Solana, Base, BNB, etc.)
2. Choose the **token** you want to spend
3. Enter the **amount** you want to swap

<div align="left"><figure><img src="https://3803314902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4r8jx3ygI23Ws0qagtg7%2Fuploads%2FfdNh3SGs9knKfqf5k56s%2Fimage.png?alt=media&amp;token=58a57dc0-b81c-4b01-bb36-8f4b731ed8a3" alt="" width="360"><figcaption></figcaption></figure></div>

Qwerti will check your balance on that chain and validate that:

* you have enough token to swap
* and you have some **native token for gas** on that chain (to pay network fees)

***

#### Step 2 — Route & Quote

<div align="left"><figure><img src="https://3803314902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4r8jx3ygI23Ws0qagtg7%2Fuploads%2FQcOQS9DTt1ZcM97E3KU7%2Fimage.png?alt=media&amp;token=1f2bcd6b-6387-48ce-8308-64c1ec8d6fc9" alt="" width="301"><figcaption></figcaption></figure></div>

After you completed step 1:

* Qwerti queries its **routing providers** (for example, DEXs and/or Bridges)
* It finds the **cheapest available route**, considering:
  * expected output amount
  * liquidity
  * slippage
  * fees and reliability

You’ll see a **quote** with:

* the **estimated amount** of the target token you will receive
* any relevant **fees** included in the route
* (optionally) a route breakdown (e.g. which aggregator / bridge is used)

> For a detailed breakdown of fees, see the [**Fees** ](https://docs.qwerti.ai/general-info/transaction-fees.md)page.

If the route doesn’t meet minimum conditions (for example, amount too small, or no liquid path), you’ll see an error or a suggestion to adjust the amount.

***

#### Step 3 — Confirm the swap

<div align="left"><figure><img src="https://3803314902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4r8jx3ygI23Ws0qagtg7%2Fuploads%2FcsQsIfGyOKV7WEeS8USo%2Fimage.png?alt=media&amp;token=b43d19aa-0dc1-41df-9b39-fb44033a1bae" alt="" width="188"><figcaption></figcaption></figure></div>

Once you’re happy with the quote:

1. Click **“Swap Tokens”** in the Qwerti UI
2. Your **wallet** (self-custody or embedded) will open a confirmation window
3. Review:
   * the transaction details
   * the network / gas cost
4. **Approve** the transaction in your wallet

If you reject the transaction in your wallet, nothing is executed.

***

#### Step 4 — Processing & Completion

After you sign:

* The transaction will show as **Processing** in Qwerti
* For mono-chain and cross-chain swaps, this usually completes quickly once the on-chain tx is confirmed.
* For bridge + swap flow, you may see **two steps**:
  1. Bridging funds to the target chain
  2. Swapping into the target token on the target chain

Once everything is done, the status will change to **Completed**, and the target token will appear in your wallet.

***

### 3. Mono-Chain vs Cross-Chain Swaps

#### 3.1 Same-chain swaps

These are swaps where:

* **source chain** = **target chain**

Example:

* SOL → BONK (both on Solana)
* USDC → ETH (both on an Base chain)

Characteristics:

* Usually **faster** and **cheaper**
* Typically a **single transaction** on one network
* Uses a DEX / aggregator route on that chain

***

#### 3.2 Cross-chain swaps

These are swaps where:

* **source chain** ≠ **target chain**

Example:

* PEPE on Ethereum → BONK on Solana

Under the hood:

1. Your assets are **bridged** from the source chain to the target chain
2. Once funds arrive on the target chain, they are **swapped** into the final token

Characteristics:

* May involve **multiple providers** (Bridge + DEX, or jest DEX, depends of cheapest route)
* Sometimes **takes longer** than single-chain swaps
* Final completion time depends on:
  * bridge confirmation
  * target chain congestion

Qwerti keeps you on a single screen with step-by-step status instead of forcing you to manually hop across different apps.

***

### 4. Fees for Swaps (Short Version)

When you use swaps in Qwerti, you typically pay:

1. **Routing / liquidity provider fee**
   * e.g. an aggregator like Jupiter charging around **0.10%**
2. **Qwerti fee: 0.10% per swap transaction**
3. **Network gas fees**
   * paid to the blockchain where the transaction is executed
   * not controlled by Qwerti

For the full explanation and examples, see the [**Fees**](https://docs.qwerti.ai/general-info/transaction-fees.md) page.

***

### 5. Slippage, Quotes & Expiry

#### 5.1 Slippage

Token prices move constantly.\
To protect you, swaps usually have a **slippage tolerance**:

* If the price moves more than this tolerance **against you** before execution, the transaction can revert.
* This prevents you from receiving significantly less than expected.

Depending on the UI, slippage may be:

* automatically set to a default value (we automatically find you a route with lowest slippage requirements)
* configurable by advanced users

***

#### 5.2 Quote expiry

Quotes are **time-sensitive**.

* If you wait too long before confirming, the quote may **expire**
* In that case, we automatically **refresh** quotes every 5-10 seconds

This is normal behavior in DeFi aggregators and helps reflect up-to-date market conditions.

***

### 6. Common Errors & How to Handle Them

Here are some common issues you might encounter:

#### “Insufficient funds / Not enough balance”

* Your source token balance is lower than the amount you’re trying to swap\
  → Reduce the amount or add more funds to your wallet.

#### “Insufficient gas”

* You don’t have enough native token (e.g. SOL, ETH) to pay for network fees\
  → Top up a small amount of native token on that chain.

#### “Route not found” or “No liquidity”

* There is no reliable route for this pair / amount right now\
  → Try:
  * lowering the amount
  * choosing another source token
  * or picking a different source chain.

***

### 7. Best Practices for Swaps

* Always double-check:
  * the **source chain & token**
  * the **target chain & token**
  * the **amount** you’re swapping
* Keep a small buffer of **native token** on each active chain for gas.
* For volatile or low-liquidity tokens:
  * be careful with **high slippage** settings
  * consider swapping smaller amounts first
* If something looks off (unexpected output, weird token, very high slippage):
  * stop and re-check before confirming.

***

#### In short:

The **Swaps** flow in Qwerti gives you a simple, aggregated interface to swap tokens within and across chains, while you stay in full control of your wallet, approvals, and risk.
