Get swap quote
Returns a persisted quote for swapping tokens on same or different chains. Provide either originChain + destinationChain or chainIdIn + chainIdOut. Provide exactly one of amountIn or amountOut. 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 address on destination chain
"0xb794F5eA0ba39494cE839613fffBA74279579268"
Sender address on origin chain. When provided together with destinationAddress, the response also includes executable payload fields (id plus transactionData, userOperation, or Fireblocks data depending on output).
"0xb794F5eA0ba39494cE839613fffBA74279579268"
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.
bytecode, userOperation, fireblocks 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