> For the complete documentation index, see [llms.txt](https://docs.blackhole.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blackhole.xyz/protocol-design/how-to-swap.md).
# How to Swap
From the main Swap menu, there are three options you can choose:
* Swap
* TWAP
* Limit
1. For regular swaps, click on the swap icon:
2. Select the token you want to swap and the token you want to receive.:
3. Enter the swap amount manually or use the buttons to automatically select 25%, 50%, 75% or Max amount you have available in your wallet:
4. On the right hand side you see the swap details, showing the exchange rate found, the slippage applied, minimum amount to be received and the price impact. You can adjust the slippage according to the expected price impact:
5. Before you can proceed you need to give approval the Blackhole protocol to access your token before the swap can be executed. Click on Allow and sign the transaction:
6. After the approval transaction has been committed, the SWAP button appears so you can initiate the swap transaction:
7. After successful completion of the swap transaction a toast message will appear showing that the swap executed succesfully. You can click on the icon to show the transaction details on the block explorer.
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.blackhole.xyz/protocol-design/how-to-swap.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
