> For the complete documentation index, see [llms.txt](https://hertzflow.gitbook.io/hertzflow-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hertzflow.gitbook.io/hertzflow-docs/trade-on-hertzflow/swap.md).

# Spot Swap

## Overview

HertzFlow's built-in Swap lets you convert BSC tokens directly on the platform, so you can get the USDT you need for trading or liquidity provision without going to an external exchange.

## Supported Tokens

Swap supports any searchable BSC token that has a valid routing path. The token selector includes:

* **Quick Access:** USDT, BNB, BTC, ETH
* **Your Tokens:** Tokens held in your wallet, sorted by USD value. Assets worth less than $1 are grouped under a collapsible section to keep the list clean.
* **Recommended:** A curated list of popular BSC tokens
* **Search:** Search by token symbol, name, or paste a contract address

{% hint style="info" %}
Swap currently operates on BNB Chain only. The chain indicator is shown in the token selector and cannot be switched.
{% endhint %}

## How Swap Works

1. **Select your pay token** and enter the amount you want to swap.
2. **Review the quote**, including the exchange rate, minimum received, price difference, and route.
3. **Confirm the swap.** For ERC-20 tokens, you will need to approve the token first, then sign the swap transaction. Native BNB skips the approval step.

Quotes auto-refresh every 10 seconds while you have a valid amount entered. If a quote becomes stale due to input changes, the old values are greyed out and cannot be submitted until a fresh quote arrives.

When you close a position, the received asset will always be the same as the asset used to open the position. Swap does not affect the settlement asset of your position.

### Swap Details

The Swap Details panel shows key information about your quote:

| Field                | What It Means                                                                       |
| -------------------- | ----------------------------------------------------------------------------------- |
| **Rate**             | The exchange rate between your pay and receive tokens, based on the current quote   |
| **Minimum Received** | The minimum amount you will receive, protected by your slippage setting             |
| **Price Difference** | How much the swap's estimated execution price differs from the Pyth reference price |
| **Route**            | The DEX routing path your swap will take, including intermediate hops               |

You can expand the Route to see the full path, including all protocols and hops involved.

## Slippage

Slippage tolerance controls how much price movement you are willing to accept. If the execution price moves beyond your tolerance, the swap reverts and your tokens are returned.

Default slippage is 0.5%, adjustable from 0.01% to 5.00%. Preset options are 0.3%, 0.5%, and 1.0%. You can also enter a custom value with up to two decimal places.

{% hint style="warning" %}
**Low slippage** (below 0.3%) may cause your swap to fail while still incurring gas fees. **High slippage** (above 1.0%) may result in an unfavorable execution price and increase exposure to MEV.
{% endhint %}

## Price Difference

Price Difference compares your swap's estimated execution price against the Pyth Network reference price. This helps you assess whether the rate you are getting is fair.

When the price difference exceeds 0.5%, the Swap Details panel auto-expands and shows a warning. If it reaches 10% or higher, a warning banner appears and the button changes to **Confirm Swap**, requiring you to acknowledge the rate before proceeding.

{% hint style="info" %}
Reference price source: Pyth Network.
{% endhint %}

***

Swap routing is powered by [Peach](https://docs.peach.ag/documentation).


---

# 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://hertzflow.gitbook.io/hertzflow-docs/trade-on-hertzflow/swap.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.
