Guides FAQ Troubleshooting Contact

How can we help?

Find answers, guides, and support for InstaSwap.

Guides

Getting Started with InstaSwap

Step 1

Open InstaSwap

Open World App on your phone. Navigate to the Mini Apps section and search for "InstaSwap". Tap to open the app. You'll see the InstaSwap login screen with our cheetah logo.

Step 2

Login with World ID

Tap the "Swap Now" button. World App will prompt you to sign in with your World ID. This is a one-tap login — no passwords needed. Your session is saved, so you won't need to login again.

Step 3

Select Tokens

Choose the token you want to pay with (e.g., WLD) and the token you want to receive (e.g., USDC). Tap on the token selector to see all available tokens with your wallet balances.

Step 4

Enter Amount & Swap

Type the amount you want to swap. The app will instantly fetch the best quote from Uniswap. Review the rate, then tap "Swap". Confirm in World App and your tokens will be swapped in seconds!

Step 5

View History

Tap the History tab at the bottom to see all your past swaps. Each transaction shows the tokens, amounts, and time — so you always have a complete record.

FAQ

Frequently Asked Questions

InstaSwap is a token swap mini app built for World App. It allows you to swap tokens like WLD, ETH, USDC, and BTC directly inside World App, powered by Uniswap V3 liquidity pools on World Chain.

InstaSwap itself does not charge any platform fees currently. You only pay the standard blockchain network fees (gas) and the Uniswap pool fee (typically 0.3% or 0.05% depending on the pool).

Currently supported tokens: WLD (Worldcoin), ETH (Wrapped Ether), USDC (USD Coin), and BTC (Wrapped Bitcoin) on World Chain. More tokens will be added in the future.

Most swaps complete within 2-5 seconds. World Chain's fast block times ensure near-instant settlement. You'll see the "Swap Successful ✅" message as soon as the transaction is confirmed.

Absolutely. InstaSwap never has access to your private keys. All transactions are signed within World App itself using MiniKit. The swap is executed through audited Uniswap V3 smart contracts. Your funds remain in your control at all times.

No, ORB verification is not required to use InstaSwap. Any World App user can swap tokens. However, ORB-verified users get a verified badge displayed on their profile, and may benefit from future premium features.

No. InstaSwap is a World Mini App and can only be accessed within World App. It uses World App's MiniKit SDK for authentication and transaction signing, which requires the World App environment.

Open InstaSwap and tap the History tab in the bottom navigation bar. You'll see a list of all your past swaps with token pairs, amounts, and timestamps. The deducted token is shown in red and the received token in green.

Troubleshooting

Common Issues & Fixes

This can happen due to:

  • Insufficient balance — Make sure you have enough tokens to cover the swap amount plus gas fees.
  • Price slippage — The token price changed between the time you got the quote and sent the transaction. Try again — InstaSwap fetches a fresh quote each time.
  • Low liquidity — For very large swaps, the liquidity pool may not have enough depth. Try a smaller amount.
  • Network congestion — World Chain may be experiencing high traffic. Wait a moment and try again.

The swap button shows "Insufficient Balance" when the amount you entered exceeds your wallet balance for that token. You need to either reduce the amount or add more tokens to your World App wallet before swapping.

If the confirmation popup doesn't appear in World App:

  • Make sure World App is up to date.
  • Check that you haven't accidentally dismissed a popup notification.
  • Close and reopen InstaSwap, then try the swap again.
  • If the issue persists, force close World App and reopen it.

A "—" balance means InstaSwap hasn't finished loading your balances. Wait a moment for the balances to load. If they still show "—" after 10 seconds, try refreshing the page by navigating to another tab and back.

This typically indicates a session issue. Try logging out (Profile → Log Out) and logging back in. If the error persists, make sure you're using the latest version of World App.

If you see "Swap Successful ✅" but the tokens aren't visible:

  • Wait 10-30 seconds — World Chain may need a moment to finalize.
  • Check your World App wallet directly for the received tokens.
  • Ensure you have the token added to your World App wallet's token list.
  • If the issue persists, contact us with your transaction details.
Contact

Get in Touch

Can't find what you're looking for? Send us a message.

Message Sent!

Thank you for reaching out. Our team will get back to you within 2 hours.

Response Time

We typically respond within 24 hours. For swap issues, please include your wallet address and transaction details.

List Your Token

Are you a token project team? Select "Token / Project Listing Request" in the subject dropdown and include your token's contract address and details.