Get swap quote
Returns a persisted quote for swapping tokens on same or different chains, including Pods Ramp fiat rails (originChain or destinationChain of fiat). Brazil Pix supports Pix↔USDC on base/monad, Pix↔BRLA on polygon, Pix↔BRS on solana, and Pix↔Morpho hyperUSDCa on monad (see Ramp guides). Provide either originChain + destinationChain or chainIdIn + chainIdOut. Provide exactly one of amountIn or amountOut. When originAddress is provided with destinationAddress (crypto / fiat onramp) or pixKey (fiat offramp), the response also includes executable fields (transactionData, paymentInstructions, id) — preferred for new integrations instead of POST /v2/swap/bytecode. Quotes expire after 5 minutes; quote.deadline is a Unix timestamp in seconds and quote.deadlineDate is an ISO 8601 string (UTC).
Authorizations
API key for authentication. Obtain from your Pods dashboard.
Query Parameters
Origin blockchain network name. Use with destinationChain.
"ethereum"
Origin chain ID. Alternative to originChain.
1
Destination blockchain network name. Use with originChain.
"polygon"
Destination chain ID. Alternative to destinationChain.
137
Input token contract address
"0xb794F5eA0ba39494cE839613fffBA74279579268"
Output token contract address
"0xb794F5eA0ba39494cE839613fffBA74279579268"
Input amount (in token smallest unit). Provide either amountIn or amountOut, not both.
"1000000000000000000"
Desired output amount (in token smallest unit). Provide either amountIn or amountOut, not both.
"1000000000000000000"
Recipient on the destination chain (checksummed EVM or Solana public key). Omit for quote-only requests; use pixKey instead for fiat destinations.
"EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj"
PIX key for fiat off-ramp destinations. Use instead of destinationAddress when destinationChain is fiat.
Set to true for PIX off-ramp quotes paid to a third party. The value must match the bytecode request.
false
Sender address on the origin chain (checksummed EVM or Solana public key). When provided with destinationAddress or pixKey, the response also includes executable payload fields.
"EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj"
Address for refunds if swap fails
"0xb794F5eA0ba39494cE839613fffBA74279579268"
Response format when both originAddress and destinationAddress are provided. Defaults to bytecode. userOperation and fireblocks are EVM-origin only. instructions is Solana-origin only.
bytecode, userOperation, fireblocks, instructions Fireblocks vault account ID. Required when output=fireblocks.
"12"
Request fee sponsorship on eligible Pods bridge routes
false
Registered provider name to force when eligible for the route
"relay"
Slippage tolerance as a fraction of 1. Valid range is 0.0001 to 0.5.
"0.01"
Transfer speed for CCTP cross-chain swaps
fast, standard "fast"
Optional per-quote webhook endpoint. When set, quote lifecycle webhooks are delivered to this URL instead of the customer default webhookURL.
"https://example.com/webhooks/swap-quote"
Response
Quote generated successfully
Freshly generated swap quote returned by GET /v2/swap/quote
Action ID for execution tracking when bytecode is included
Origin chain ID when bytecode is included
Transaction data for execution
- object[]
- object
ERC-4337 user operation when output=userOperation and both addresses are provided
Solana instructions when output=instructions (Solana-origin only)
Solana lookup tables keyed by address when output=instructions