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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://qiedex.qie.digital/how-to-trade.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.