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
Setup
Enable swaps in the Privy Dashboard and configure gas
sponsorship for your app.
Get a quote
Call the quote endpoint with the token pair, chain, and
amount. The response includes estimated output amounts and a gas estimate.
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.EVM mainnet chains
EVM mainnet chains
| Chain | Chain ID | CAIP-2 identifier | Native token |
|---|---|---|---|
| Ethereum | 1 | eip155:1 | ETH |
| Optimism | 10 | eip155:10 | ETH |
| BNB Smart Chain | 56 | eip155:56 | BNB |
| Unichain | 130 | eip155:130 | ETH |
| Polygon | 137 | eip155:137 | POL |
| Monad | 143 | eip155:143 | MON |
| World Chain | 480 | eip155:480 | ETH |
| Base | 8453 | eip155:8453 | ETH |
| Arbitrum | 42161 | eip155:42161 | ETH |
Solana
Solana
| Chain | CAIP-2 identifier | Native token |
|---|---|---|
| Solana mainnet | solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp | SOL |
EVM testnet chains
EVM testnet chains
| Chain | Chain ID | CAIP-2 identifier | Native token |
|---|---|---|---|
| Unichain Sepolia | 1301 | eip155:1301 | ETH |
| Monad Testnet | 10143 | eip155:10143 | MON |
| Sepolia | 11155111 | eip155:11155111 | ETH |
| Base Sepolia | 84532 | eip155:84532 | ETH |
Token addresses
Specify token addresses as ERC-20 contract addresses (for EVM chains) or SPL token mint addresses (for Solana), or use"native" for the chain’s native token (e.g., ETH on Ethereum, SOL on Solana). The input_token and output_token must be different.
Fees
The following fees may apply when executing a swap. Fees are subject to change.| Fee | Description |
|---|---|
| Privy swap fee | Privy charges up to 0.25% on each swap, calculated from the input token amount. This fee is included in the swap rate. |
| Protocol fee | Underlying 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 token on EVM). Gas fees fluctuate based on network congestion and transaction complexity. |
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. Theslippage_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.
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.
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.