Skip to main content
Privy enables your app to support token swaps on supported EVM chains and Solana directly from a wallet. Swaps execute as wallet actions, and Privy automates token approvals and transaction submission.
Swaps are executed on third-party decentralized protocols. Privy does not have discretion over how a swap is routed to the protocol or the price at which the swap is ultimately executed by the blockchain network. Swap rates may differ from quoted estimates due to market volatility, liquidity conditions, and slippage. These materials are for general information purposes only and are not investment advice or a recommendation or solicitation to engage in any specific transaction. Privy does not provide investment, financial, legal, or tax advice.

​
How it works

1

Setup

Enable swaps in the Privy Dashboard and configure gas sponsorship for your app.
2

Get a quote

Call the quote endpoint with the token pair, chain, and amount. The response includes estimated output amounts and a gas estimate.
3

Execute the swap

Call the swap endpoint with the same parameters. The response is a wallet action that can be polled for confirmation.

​
Supported chains

Swaps are available on the following chains.
ChainChain IDCAIP-2 identifierNative token
Ethereum1eip155:1ETH
Optimism10eip155:10ETH
BNB Smart Chain56eip155:56BNB
Unichain130eip155:130ETH
Polygon137eip155:137POL
Monad143eip155:143MON
World Chain480eip155:480ETH
Tempo4217eip155:4217None
Base8453eip155:8453ETH
Arbitrum42161eip155:42161ETH
Tempo does not have a native token. Specify token contract addresses for Tempo swaps.
ChainCAIP-2 identifierNative token
Solana mainnetsolana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpSOL
ChainChain IDCAIP-2 identifierNative token
Unichain Sepolia1301eip155:1301ETH
Monad Testnet10143eip155:10143MON
Sepolia11155111eip155:11155111ETH
Base Sepolia84532eip155:84532ETH

​
Token addresses

Specify token addresses as ERC-20 contract addresses (for EVM chains), TIP-20 contract addresses (for Tempo), or SPL token mint addresses (for Solana). Use "native" only on chains with native token support (e.g., ETH on Ethereum or SOL on Solana). The input_token and output_token must be different.
Token addresses are chain-specific. Ensure that the addresses provided for input_token and output_token correspond to token contracts deployed on the chain specified in the caip2 field. The same token (e.g., USDC) may have different contract addresses on different chains. Use a resource like Token Lists to source correct addresses for your target chain.

​
Fees

The following fees may apply when executing a swap. Fees are subject to change.
FeeDescription
Privy swap feePrivy charges up to 0.25% on each swap, calculated from the input token amount. This fee is included in the swap rate.
Protocol feeUnderlying DEX protocols charge a fee on each swap. For EVM chains, Uniswap liquidity pools typically charge 0.3% for V2 pools and 0.01%–1% for V3/V4 pools depending on the pool’s fee tier. This fee is included in the swap rate.
Network fee (gas)Blockchain transaction processing fees paid to the network. Gas sponsorship is required for swaps, meaning Privy sponsors these fees from your app’s gas credits. This includes any token approval transactions required for the swap (e.g., the first time a wallet swaps a given ERC-20 or TIP-20 token). Gas fees fluctuate based on network congestion and transaction complexity.
Relayer fee(Cross-chain only) Paid to the bridge provider for routing the swap across chains. Varies with network conditions and liquidity. Included in estimated_fees on the quote response.
Developer fee(Cross-chain only) A configurable fee allocated to your app. Requires a custom fees configuration. Set via the fee_configuration parameter on the quote and swap endpoints. Included in estimated_fees on the quote response.
The estimated output amounts returned by the quote endpoint reflect the swap rate after Privy and protocol fees. The gas_estimate field provides a separate estimate of the network fee.

​
Slippage

Slippage is the difference between the quoted price of a swap and the price at which it executes. Because token prices can change quickly, especially during periods of high volatility or low liquidity, the final execution price may differ from the quoted price. The slippage_bps parameter sets the maximum slippage tolerance in basis points (e.g., 50 for 0.5%). This controls the maximum percentage difference your app is willing to accept between the quoted price and the execution price.
  • If the maximum slippage is set too low, the swap may fail if the price moves beyond the specified tolerance.
  • If the maximum slippage is set higher, the swap is more likely to succeed, but the wallet may receive a less favorable price if the market moves significantly.
  • If a swap fails due to slippage, the wallet is still responsible for any network fees incurred.
Privy enables the use of auto-slippage by omitting the slippage_bps parameter. When omitted, an appropriate slippage tolerance is automatically determined based on the tokens being swapped and current market conditions. Your app can also set a specific slippage_bps value and use the minimum_output_amount from the quote response to verify the minimum tokens received before executing.

​
Cross-chain swaps

Privy’s swap API supports swapping tokens across different chains. A cross-chain swap routes output tokens to a destination chain — for example, swapping ETH on Base and receiving ETH on Arbitrum, or swapping USDC on Ethereum and receiving SOL on Solana. Cross-chain swaps use a source and destination object format with separate caip2 identifiers for each side. See the get a quote and execute a swap pages for usage. Supported cross-chain routes mirror those for transfers:
Source chainSupported destination chains
EthereumBase, Tempo, Arbitrum, Polygon, Solana
BaseEthereum, Tempo, Arbitrum, Polygon, Solana
TempoEthereum, Base, Arbitrum, Polygon, Solana
ArbitrumEthereum, Base, Tempo, Polygon, Solana
PolygonEthereum, Base, Tempo, Arbitrum, Solana
SolanaEthereum, Base, Tempo, Arbitrum, Polygon
Cross-chain swaps are subject to relayer fees, slippage, and current liquidity conditions. Quotes expire — use the expires_at field to detect stale quotes and fetch a fresh one before executing.

​
Next steps

Setup

Enable swaps and configure routing in the Privy Dashboard.

Get a quote

Fetch a price quote before executing a swap.

Execute a swap

Execute a token swap from a wallet.

Errors

Error reference for swap APIs.