> For the complete documentation index, see [llms.txt](https://qiedex.qie.digital/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://qiedex.qie.digital/how-to-trade.md).

# How to Trade

## 📘 QIEDEX User Guide

Welcome to **QIEDEX**, a decentralized exchange (DEX) with some custom features specific to the **QIE ecosystem**. This guide will help you understand how to use QIEDEX step by step.

***

### 🧩 Overview

QIEDEX has 4 core sections:

1. **Native Swap** – Swap between native QIE coin and WQIE token (wrapped QIE).
2. **Add Liquidity** – Provide liquidity using **WQIE** and **QIE-20 tokens or QIE-20 tokens to QIE-20 tokens.**
3. **Swap** – Trade any QIE-20 token with another QIE-20 token (using WQIE if necessary).
4. **Add Token** – Add your custom QIE-20 token to make it available for swap and liquidity features.

***

### 🔁 1. Native Swap (QIE ↔ WQIE)

#### Purpose:

* Convert **QIE (native coin)** to **WQIE (wrapped QIE token)** and vice versa.
* Required because QIEDEX operates with **tokens only**, not native coins.

#### Steps:

1. Go to the **Native Swap** section.
2. Select **QIE → WQIE** (or WQIE → QIE).
3. Enter the amount you want to convert.
4. Confirm the transaction in your wallet.

✅ Now you have **WQIE**, which can be used for swapping or providing liquidity.

***

### 💧 2. Add Liquidity

#### Note:

* Liquidity can only be added between **WQIE** and **QIE-20 tokens or QIE-20 tokens and QIE-20 tokens.**
* **QIE native coin cannot be used directly**. Convert to WQIE first.

#### Steps:

1. If you only have QIE, first go to **Native Swap** and convert it to WQIE.
2. Go to the **Add Liquidity** section.
3. Choose **WQIE** and another **QIE-20 token**.
4. Enter the amounts you want to provide.
5. Confirm the transaction in your wallet.

✅ You are now providing liquidity and earning a share of swap fees.

***

### 📤 Remove Liquidity

#### Note

* Liquidity can only be removed from existing liquidity pools you have already provided to.
* You will receive both tokens back based on your share of the pool.
* Removing liquidity may be affected by slippage depending on pool conditions.

#### Steps

1. Go to the **Liquidity** section.
2. Select the **Remove** tab.
3. Choose the liquidity pair you want to remove.
4. Use the **LP Value** slider to select how much liquidity you want to withdraw (0–100%).
5. Review the token amounts you will receive, displayed after selecting the LP value.
6. Adjust **slippage tolerance** if needed.
7. Confirm the transaction in your wallet.

✅ **Your liquidity is removed and the underlying tokens are returned to your wallet.**

***

### 🔄 4. Swap (QIE-20 ↔ QIE-20)

#### Note:

* Swapping works between **QIE-20 tokens only**.
* If you want to swap QIE (native coin), first convert it to WQIE using **Native Swap**.

#### Steps:

1. Go to the **Swap** section.
2. Choose the token pair (e.g. WQIE ↔ MyToken).
3. Enter the amount you want to swap.
4. Confirm the transaction in your wallet.

✅ You’ve successfully swapped your tokens.

***

### ➕ 5. Add Token

#### Important:

Only tokens added through this section will appear in **Swap** and **Add Liquidity** options.

#### Steps:

1. Go to the **Add Token** section.
2. Enter your **QIE-20 token contract address and verify**.
3. Add logo and Submit.

✅ Your token is now visible and usable in QIEDEX.

***

### 🔄 Summary Workflow

**To Swap or Add Liquidity with QIE coin:**

1. Go to **Native Swap**.
2. Convert **QIE → WQIE**.
3. Use WQIE in the **Swap** or **Add Liquidity** section.

***

### ℹ️ Notes

* **WQIE** is a wrapped version of QIE (1:1 value).
* All trading and liquidity interactions use **WQIE + QIE-20 tokens**, not QIE directly.
* Make sure your token is added via **Add Token** before using it.