DEV Community

Merissa Stemler
Merissa Stemler

Posted on

How to use KyberSwap for a token swap

KyberSwap lets you swap tokens on one network by connecting a wallet, choosing the network and tokens, reviewing the quote and minimum received, approving the token if prompted, and confirming the swap in your wallet. Open KyberSwap to find a route for the pair you want to trade. The KyberSwap Aggregator finds routes across liquidity sources; your wallet authorizes each action.

What must be ready before using KyberSwap?

A KyberSwap swap needs a self-custody wallet, the token you want to sell, and some of the network’s native token to pay gas. Gas is the network fee for recording a transaction. You need enough for the swap and, if your sell token requires an on-chain approval, that separate transaction too.

Choose the network where your sell token already sits, then make sure the app and wallet show the same network. The aggregator supports networks including Ethereum, BNB Chain, Polygon, Arbitrum and Base. ETH pays gas on Ethereum, Arbitrum and Base; each network requires its own native-token balance. Having ETH on Ethereum, for instance, does not supply gas for a swap on Base.

Have the buy token’s contract address ready from a source you trust. A ticker is only a short name: different contracts can use the same one. Matching the contract address and network helps you avoid selecting a copycat token.

How do you complete the swap and read each wallet prompt?

A same-chain swap moves from a wallet connection to a quote, a possible token approval, and a final swap transaction. Read the prompt at each stage for the permission it actually requests.

  1. Open the official site and connect your wallet. Select your wallet, such as MetaMask, and review the account and network in its connection request. Connecting lets the app see your selected public address and suggest transactions. It does not itself authorize a token transfer. Keep the wallet open for later prompts; a connection alone has not started the trade.
  2. Select the network. Match it to the network holding your sell token and native gas balance. If the wallet asks to switch networks, read the requested destination before accepting. A same-chain swap starts and ends on this selected network.
  3. Choose the sell token, buy token and amount. Compare each token’s contract address with the address you intended to use, especially when several results share a ticker. Say you hold USDC on Base and want to receive another token there. Select the Base version of each token, enter the amount of USDC to sell, and leave enough ETH on Base for gas.
  4. Review the quote and slippage tolerance. The route shows where the aggregator expects to source liquidity. Compare the expected output with the estimated gas: a route offering more tokens can also cost more to execute. Price impact describes how much your trade size moves the market price. Slippage tolerance is the adverse price movement you allow before execution. Minimum received is the quoted output reduced by that tolerance; if the trade would return less, it should revert rather than complete at that rate. A higher tolerance permits a worse result, so choose one you can accept. The Aggregator user guide explains these quote fields and the approval and confirmation stages.
  5. Approve the sell token if prompted. An approval gives a specified smart contract permission to spend that token up to an allowance. In the wallet prompt, inspect the token, the contract receiving permission, the spending cap and any gas fee. A cap equal to this trade limits the allowance; a larger cap can cover later trades. Approval does not execute the swap. An on-chain approval is its own transaction, so wait for it to confirm before continuing. Some tokens instead offer a permit: a signed message granting an allowance without a separate gas payment. If an existing allowance is sufficient, you may see no approval prompt. You may need to approve again if a later trade exceeds the remaining allowance.
  6. Confirm the swap separately. Review the latest output and minimum received before sending the trade; a refreshed route or price can change the quote. Then read the wallet’s transaction request, particularly its network and gas estimate, and confirm it. This prompt submits the swap transaction. The wallet may describe a contract interaction rather than spell out the token pair, which is why the app’s final trade details matter. If the amount or network is wrong, reject the prompt and correct the trade first.
  7. Wait for confirmation and verify the result. Open the swap transaction hash on that network’s block explorer. A submitted transaction can still be pending; look for a successful transaction and the received token transfer to your address. Then view the new token balance in your wallet on the same network. If the explorer shows success but the wallet omits the token, add its verified contract address to the wallet’s token list. The swap is complete when the explorer shows success and the wallet shows the received balance.

Related questions

Is KyberSwap safe to connect a wallet to?

Connecting a wallet gives the app access to your selected public address; token spending requires a separate approval. Verify that you opened the official site, and treat an unexpected approval or signature request as a reason to stop. Review the allowance amount carefully: disconnecting a site does not revoke an approval already recorded on-chain.

Does KyberSwap need an account or KYC?

A standard same-chain wallet swap does not require you to create an account or complete an identity check in the swap flow. Your wallet supplies the address and confirms the transactions.

How to add the received token to the wallet?

In MetaMask, select the network used for the swap and import the token using its verified contract address if the balance is missing. MetaMask Support explains how to display a token by address. Use the explorer’s successful transfer as the first check that the token reached your wallet.

Top comments (0)