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

# Swap

Trade any token pair on a single chain at the best available on-chain price — Novamp finds the route, your wallet signs.

{% hint style="info" %}
Swap routes through **third-party providers** — Uniswap and 0x on EVM chains, and Jupiter on Solana. Novamp compares them and picks the best net output; you always keep custody.
{% endhint %}

## Overview

Swap is Novamp's same-chain exchange. Pick a **from** and **to** asset, enter an amount, and Novamp quotes the best route across integrated providers, then builds a transaction for your wallet to sign. It works on `🟢 Robinhood Chain (4663)`, `🔵 Base (8453)`, `🟡 BNB Chain (56)`, `⚪ Ethereum (1)`, `🟪 Solana`, and `🟣 HyperEVM (999)`.

* **EVM** — best-price execution across the aggregator (Uniswap `/api/uniswap/*`, 0x `/api/zerox/*`, and direct v3 pools), ranked by net output.
* **HyperEVM** — prefers a **direct HyperSwap** route (classic `SwapRouter`, not `SwapRouter02`) over 0x whenever it nets more; 0x is the secondary route.
* **Solana** — routed through Jupiter's meta-aggregator (`/api/jupiter/*`).

{% hint style="warning" %}
Uniswap, 0x, and Jupiter are independent third-party providers. Their pricing, routing, and any provider fees apply to your swap; Novamp discloses the route and the quote before you confirm.
{% endhint %}

## How it works

```mermaid
flowchart LR
  A[Pick chain] --> B[Select from + to assets]
  B --> C[Enter amount]
  C --> D[Novamp quotes best route]
  D --> E[Review: receive, min received, fee]
  E --> F[Approve if needed]
  F --> G[Sign in wallet]
  G --> H[Confirm + balances update]
```

1. **Choose the chain** from the chain tabs.
2. **Select assets** with the asset picker (icons, balances, search, or paste a contract as an advanced fallback).
3. **Enter an amount** — or tap 25% / 50% / 75% / MAX (MAX on a native asset keeps a small gas buffer aside).
4. Novamp fetches a **live quote** and shows the winning route (e.g. "Best price · Uniswap", "Best price · 0x", or a direct pool with its fee tier).
5. **Review** you receive, minimum received (after slippage), and the network fee. Quotes **auto-refresh** on a countdown.
6. **Confirm** — approve the token if needed, then sign.

## How to use it

* **Set slippage** from the presets (0.5% / 1% / 3% / 5%). See [📉 Slippage & Price Impact](/traders/slippage-and-price-impact.md).
* **Reverse** the pair with the ⇅ button.
* Watch the **quote freshness** timer — if it lapses, the quote refreshes before you can execute.
* On EVM, first-time trades of a token may need a one-time **approval** ("enable instant trading") before the swap.

## Important details

| Detail             | Behavior                                                                            |
| ------------------ | ----------------------------------------------------------------------------------- |
| Routing (EVM)      | Uniswap + 0x + direct v3, ranked by net output                                      |
| Routing (HyperEVM) | Direct **HyperSwap** (classic `SwapRouter`) preferred over 0x, ranked by net output |
| Routing (Solana)   | Jupiter meta-aggregator; **0.5%** Novamp fee shown in quote                         |
| Quote lifetime     | Auto-refreshes on a countdown; stale quotes re-fetch                                |
| MAX on native      | Leaves a small native-gas buffer so the tx can pay for itself                       |
| Token tax          | If the token taxes transfers, a warning shows in the review                         |
| Custody            | Non-custodial — your wallet signs every step                                        |

## What happens next?

1. On EVM you sign the approval (if required) and then the swap; the review modal walks Approve → Authorize → Confirm.
2. On Solana, Jupiter builds the order and your Solana wallet signs.
3. On success, balances update optimistically and a toast confirms `FROM → TO`.
4. The swap is recorded in your in-app trade history and appears in your [Portfolio](/portfolio-and-analytics/portfolio.md) activity.

{% hint style="info" %}
Swap is **same-chain** only. To move assets between chains, use [🌉 Bridge](/traders/bridge.md).
{% endhint %}

## Troubleshooting

| Symptom                                 | Likely cause                      | What to do                                                                         |
| --------------------------------------- | --------------------------------- | ---------------------------------------------------------------------------------- |
| "Route briefly unavailable — tap Retry" | Provider hiccup / thin liquidity  | Retry; try a smaller size or different pair                                        |
| "Insufficient {asset}"                  | Amount exceeds balance            | Lower the amount; keep gas aside                                                   |
| CTA stuck on "Finding route…"           | Quote still loading               | Wait for the countdown, then confirm                                               |
| Approval keeps reappearing              | Allowance too low / not yet mined | Let the approval confirm before the swap                                           |
| High price impact warning               | Trade large vs. liquidity         | Reduce size — see [Slippage & Price Impact](/traders/slippage-and-price-impact.md) |

## Continue exploring

* [🌉 Bridge](/traders/bridge.md)
* [📉 Slippage & Price Impact](/traders/slippage-and-price-impact.md)
* [⛽ Gas & Network Fees](/traders/gas-and-fees.md)
* [🆘 Transaction Troubleshooting](/traders/troubleshooting.md)


---

# 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://docs.novamp.io/traders/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.