# Swapping tokens

Swapping is the simplest thing you can do on Kumbaya. Pick the token you have, pick the token you want, click swap. The whole flow is designed to feel instant — most swaps confirm in well under a second.

![The Swap page on kumbaya.xyz](https://1036133404-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrOI1bPl9o59ZMxH6wevx%2Fuploads%2Fgit-blob-c5c4d36798a751e306a379dc3586aea5711d67be%2Fswap.png?alt=media)

## Make your first swap

1. Go to [**kumbaya.xyz/#/swap**](https://kumbaya.xyz/#/swap) (or click **Swap** in the top nav).
2. In the top field, pick the token you're paying with and enter an amount.
3. In the bottom field, pick the token you want to receive. The amount fills in automatically based on the current best route.
4. Review the **rate**, **price impact**, and **minimum received** lines.
5. If this is your first time swapping with that token, you'll see an **Approve** button — click it and confirm the approval in your wallet. (You only do this once per token.)
6. Click **Swap** and confirm in your wallet.

That's the whole flow.

## Reading the swap details

Before you confirm, expand the swap card to see:

* **Rate** — how much of the destination token you get per unit of source token.
* **Price impact** — how much your trade is moving the market price. Under 1% is normal; over 5% means the pool is thin and you might want a smaller trade.
* **Minimum received** — the absolute least you'll get back, accounting for slippage.
* **Network fee (gas)** — what you'll pay in ETH to MegaETH for processing the transaction.
* **Route** — which pools the trade is going through. Sometimes the best price comes from hopping through an intermediate token like ETH or USDC.

## Slippage

Slippage is the difference between the price you saw and the price you actually got. It exists because the pool moves with every trade, including yours.

* The default tolerance is **0.5%** for most tokens — fine for blue chips.
* For new or low-liquidity tokens, you may need to bump it to **1–3%**.
* Click the gear icon ⚙️ in the swap card to change it.

If your swap fails with a **"Slippage exceeded"** error, it usually means the price moved more than your tolerance allowed between clicking and confirming. Try again with a slightly higher tolerance or a smaller size.

For more, see [**Slippage and gas explained**](https://docs.kumbaya.xyz/trading/slippage-and-gas).

## Finding the right token

Most tokens you'd want to trade show up in the picker without any setup:

* **Verified tokens** (curated by Kumbaya) appear by default and carry a **Verified** badge.
* **Launchpad tokens** show up automatically as soon as they're launched — you don't need to import them. You can also go to the launch page (`kumbaya.xyz/#/launch/<address>`) and use the swap panel right there.

The only time you'd manually import is for an arbitrary on-chain token that isn't on Kumbaya's lists and didn't launch through the launchpad. To do that:

1. Click the token picker.
2. Paste the token's contract address into the search box.
3. Kumbaya looks it up on-chain and lets you select it. Once imported it carries an **Imported** badge.

### ⚠️ Unknown tokens carry real risk

Tokens that aren't on Kumbaya's verified list show up with an **Unknown** badge (golden, tooltip: *"This token is not on our token list or launchpad"*). Treat these with caution. Anyone can deploy an ERC-20 with any name and symbol, and an Unknown token can:

* **Be a scam impersonator** — same name/symbol as a popular token but a different address that nobody has audited.
* **Be a honeypot** — designed to let you buy but not sell, trapping your funds.
* **Have admin transfer/freeze powers** — the contract owner may be able to move tokens out of your wallet, blacklist your address, or pause transfers entirely.
* **Have hidden taxes** — fees on every transfer that drain value out of holders.

Before swapping into an Unknown token:

* Verify the contract address is the one you expect — check the block explorer ([megaeth.blockscout.com](https://megaeth.blockscout.com/)) and the project's official channels.
* Start with a tiny amount and try selling it back before scaling in.
* Read the contract source on the explorer if you can — look for `onlyOwner` modifiers on transfer functions, blocklists, or taxable transfers.
* When in doubt, skip it. Kumbaya can't recover funds lost to a malicious token contract.

## Wrap and unwrap ETH

ETH and WETH are interchangeable on Kumbaya. The app wraps and unwraps automatically when needed for a swap, so you don't have to think about it. If you ever want to manually wrap/unwrap, do an ETH ↔ WETH swap — the rate is always 1:1 with no fees.

## Common swap errors

| Error                  | What it means                         | Fix                                |
| ---------------------- | ------------------------------------- | ---------------------------------- |
| Slippage exceeded      | Price moved more than your tolerance  | Increase slippage or reduce size   |
| Insufficient gas       | Not enough ETH to pay the network fee | Top up your ETH balance            |
| Insufficient allowance | Token approval was too small          | Approve again with a higher amount |
| Pool not found         | No pool exists for that pair          | Try routing through ETH or USDC    |

### "Transaction failed on chain"

If your swap submitted, then the UI showed **"Transaction failed on chain. Please try again."**, the transaction reached MegaETH but reverted. The Kumbaya UI doesn't always surface the underlying revert reason — to see it, **open the transaction on the block explorer** ([megaeth.blockscout.com](https://megaeth.blockscout.com/)) by clicking the tx hash in the failed-swap notification (or by pasting the hash into the explorer's search). The explorer shows the contract-level error message, which usually points straight at the cause:

* `Too little received` → slippage exceeded; bump tolerance or reduce size.
* `STF` → token allowance too low; re-approve.
* A revert from the token contract itself (e.g. `transfer paused`, `blocklisted`) → the token has admin restrictions; see the [**Unknown tokens warning**](#-unknown-tokens-carry-real-risk) above.
* No reason given → usually a bad path or a token with non-standard transfer behaviour.

If something else goes wrong, check [**Troubleshooting**](https://docs.kumbaya.xyz/help/troubleshooting).

## Where to next?

* [**Adding liquidity →**](https://docs.kumbaya.xyz/liquidity/add-liquidity) to earn fees on your tokens
* [**Discovering tokens →**](https://docs.kumbaya.xyz/launchpad/discover) on the launchpad


---

# Agent Instructions: 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:

```
GET https://docs.kumbaya.xyz/trading/swap.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.