> For the complete documentation index, see [llms.txt](https://osige.gitbook.io/osige-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://osige.gitbook.io/osige-docs/trading/swap.md).
# Swap
A swap trades one token for another through one or more liquidity pools.\
When Osige prepares a transaction, your connected wallet signs it and submits it to GIWA.
Osige swap panel with sell and buy token inputs, slippage, and wallet actions
## Trade workspace
The [Trade page](https://osige.exchange/trade) is a workspace, not just a simple swap form.\
You can freely arrange the following docked panels around the order panel:
* **Chart:** Candlestick and TradingView-style charts for the selected market
* **Holders:** Holder information for the selected token
* **Community:** Community activity for that market
* **Market:** The latest swaps from the pool
Drag panels to arrange them in the layout you prefer.
## Execute a swap
1. Select the token you will pay and the token you will receive.
2. Enter an amount. Osige quotes the best available route.
3. Review the quote details below.
4. If your wallet requests it, approve the input token. Approval is a separate permission transaction.
5. Select **Swap** and confirm.
6. Check the final status in the [GIWA Explorer](https://sepolia-explorer.giwa.io).
## Understanding a quote
Osige Swap quote
**Route:** The sequence of pools used to exchange the input token for the output token. A direct route uses one pool (a one-hop route). If it is expected to provide a better result, the swap may use multiple pools or split across multiple routes. Each pool in the route applies its own LP fee and hook policy, so review the complete route before signing.
**Fees:** Three separate costs may apply:
* *LP fee* — Charged by each pool in the route and paid to that pool's liquidity providers. A pool may use a fixed fee or a dynamic fee set by a hook, such as a discount for `up.id` holders. See [Identity Features](/osige-docs/osige-features/identity.md).
* *Protocol fee* — A separately configured share of swap fees that varies by pool.
* *Network fee (gas)* — Paid in ETH to GIWA Sepolia and unrelated to Osige.
**Price impact:** An estimate of how much your trade will move the pool price. The impact increases with a larger trade or shallower liquidity. Price impact can be substantial in limited-liquidity testnet markets.
**Minimum received / maximum paid:** The worst execution condition allowed before the transaction reverts. This boundary is set by your slippage tolerance.
**Slippage tolerance:** Defines how far execution may deviate from the quote. It is a safeguard, not a fee:
* Too low: The transaction may fail even during normal price movement.
* Too high: The swap may execute at a price much worse than expected.
Adjust it from the settings icon in the order panel. Use the lowest value suitable for current market conditions.
## If a swap fails
Common causes, in order:
* The quote expired or the price moved beyond the slippage limit. Get a fresh quote and try again.
* Token approval is missing or the approved amount is too low.
* Insufficient token balance or gas ETH.
* The wallet is on the wrong network. It must be GIWA Sepolia, `91342`.
* Insufficient liquidity along the route.
* A pool hook rejected the action.
* An RPC or wallet connection issue.
Even failed transactions can consume gas. Check the error and the prior transaction status before submitting again.
For more cases, see [FAQ and Troubleshooting](/osige-docs/reference/faq.md).
{% hint style="info" %}
Chart data and market cards are display surfaces that refresh on their own schedules. The quote in the order panel is the source of truth for execution.
{% endhint %}
---
# 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://osige.gitbook.io/osige-docs/trading/swap.md?ask=&goal=
```
`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.