Body The source token and chain. CAIP-2 identifier for the source chain (e.g., `eip155:8453` for Base). See [supported chains](/wallets/actions/swap/overview#supported-chains). Token address to sell, or `"native"` for the chain’s native token. The destination token and chain. Token address to receive, or `"native"` for the chain’s native token. CAIP-2 identifier for the destination chain. Omit for a same-chain swap. Set to a different chain for a cross-chain swap. See [supported routes](/wallets/actions/swap/overview#cross-chain-swaps). Address to receive the output tokens on the destination chain. Required when swapping between different chain types (e.g. EVM and Solana). Defaults to the source wallet address otherwise. Amount in base units (e.g., wei for ETH, lamports for SOL, or the token’s smallest unit). Whether `base_amount` refers to the input or output token. Defaults to `exact_input`. Maximum slippage tolerance in basis points (e.g., `50` for 0.5%). If omitted, auto-slippage is used. Optional developer fee configuration. Only applies to cross-chain swaps. The fee model to apply. Currently only `total_fee_bps` is supported. Total fee cap in basis points (0–10000). Relayer and developer fees must fit within this cap. For example, `80` represents 0.8%. Swap quotes reflect real-time market conditions and can change quickly. Fetch a fresh quote before executing a swap to ensure your app displays accurate pricing. For cross-chain quotes, quoted output amounts and fees are best-effort estimates — small deviations are possible if market conditions shift between quote and execution. Response CAIP-2 identifier for the source chain. Token address being sold. Token address being bought. Amount of input token in base units. Estimated amount of output token in base units, after fees. Minimum output amount accounting for slippage, in base units. Use this to verify the swap terms before executing. Estimated gas cost in base units of the native token. For cross-chain swaps, see `estimated_gas` for a structured breakdown. CAIP-2 identifier for the destination chain. Present for cross-chain swaps only. Fee breakdown for the swap. Each item has a `type` (`relayer`, or `developer`) and an `amount` in USD. Items of type `developer` include a `recipient` address. Present for cross-chain swaps only. Structured gas estimate. Present for cross-chain swaps only. Gas cost in the native token’s smallest unit. Gas cost as a human-readable decimal string. Symbol of the gas token (e.g., `"ETH"`). Unix timestamp (in seconds) after which the quote is no longer valid. Present for cross-chain swaps only. Fetch a fresh quote if executing after this time. Examples ```bash theme={"system"} curl -X POST https://api.privy.io/v1/wallets/{wallet_id}/swap/quote \ -u ":" \ -H "privy-app-id: " \ -H "Content-Type: application/json" \ -d '{ "source": { "caip2": "eip155:8453", "asset_address": "native" }, "destination": { "asset_address": "0x" }, "base_amount": "1000000000000000000", "amount_type": "exact_input" }' ``` ```json Example response theme={"system"} { "caip2": "eip155:8453", "input_token": "native", "output_token": "0x", "input_amount": "1000000000000000000", "est_output_amount": "2000000000", "minimum_output_amount": "1980000000", "gas_estimate": "150000" } ``` ```bash theme={"system"} curl -X POST https://api.privy.io/v1/wallets/{wallet_id}/swap/quote \ -u ":" \ -H "privy-app-id: " \ -H "Content-Type: application/json" \ -d '{ "source": { "caip2": "eip155:8453", "asset_address": "native" }, "destination": { "caip2": "eip155:42161", "asset_address": "native" }, "base_amount": "1000000000000000000", "amount_type": "exact_input" }' ``` ```json Example response theme={"system"} { "caip2": "eip155:8453", "input_token": "native", "output_token": "native", "input_amount": "1000000000000000000", "est_output_amount": "998000000000000000", "minimum_output_amount": "993010000000000000", "destination_caip2": "eip155:42161", "estimated_fees": [{ "type": "relayer", "amount": "0.50" }], "estimated_gas": { "base_amount": "210000000000000", "amount": "0.00021", "gas_asset": "ETH" }, "expires_at": 1715200060 } ```

​Usage

Usage