App Kit SDK: Swap

The App Kit SDK includes the Swap capability that lets you swap two tokens in a few lines of code. Swap supports many stablecoins (including USDC, EURC, USDT, USDe, DAI, and PYUSD) and native tokens on supported blockchains. A kit key from the Circle Console is optional but recommended for production. Without one, requests run against a rate limit. If you hit rate limit errors or expect high request volume, configure a kit key.

Among testnets, only Arc Testnet supports Swap (USDC, EURC, and cirBTC only). Use mainnet for Swap on any other blockchains.

Quick look

Same-chain swap
Crosschain swap

This example swaps 1 USDC for EURC on Arc Testnet:

TypeScript

const result = await kit.swap({
  from: { adapter: viemAdapter, chain: "Arc_Testnet" },
  tokenIn: "USDC",
  tokenOut: "EURC",
  amountIn: "1.00",
});

See Swap tokens on a blockchain for a full working example.

This example swaps 1 USDC on Base for native POL delivered on Polygon in a single call:

TypeScript

const result = await kit.swap({
  from: { adapter: viemAdapter, chain: "Base" },
  tokenIn: "USDC",
  tokenOut: "NATIVE",
  amountIn: "1.00",
  to: {
    chain: "Polygon",
    recipientAddress: "0xYourRecipientAddress",
  },
});

See Swap tokens across blockchains for a full working example.

Installation

Install the App Kit SDK to use Swap. If you only need to swap and don’t want to install the full App Kit SDK, install the standalone Swap Kit for your preferred adapter below.

Viem
Ethers
Solana
Circle Wallets

npm install @circle-fin/swap-kit @circle-fin/adapter-viem-v2 viem

yarn add @circle-fin/swap-kit @circle-fin/adapter-viem-v2 viem

npm install @circle-fin/swap-kit @circle-fin/adapter-ethers-v6 ethers

yarn add @circle-fin/swap-kit @circle-fin/adapter-ethers-v6 ethers

npm install @circle-fin/swap-kit @circle-fin/adapter-solana-kit @solana/kit @solana/web3.js

yarn add @circle-fin/swap-kit @circle-fin/adapter-solana-kit @solana/kit @solana/web3.js

npm install @circle-fin/swap-kit @circle-fin/adapter-circle-wallets

yarn add @circle-fin/swap-kit @circle-fin/adapter-circle-wallets

Send

Bridge

Swap

Unified Balance

App Kit SDK: Swap

Quick look

Installation

​Quick look

​Installation

Quick look

Installation