Skip to main content
GET
Get swap quote

Authorizations

x-api-key
string
header
required

API key for authentication. Obtain from your Pods dashboard.

Query Parameters

originChain
string

Origin blockchain network name. Use with destinationChain.

Example:

"ethereum"

chainIdIn
number

Origin chain ID. Alternative to originChain.

Example:

1

destinationChain
string

Destination blockchain network name. Use with originChain.

Example:

"polygon"

chainIdOut
number

Destination chain ID. Alternative to destinationChain.

Example:

137

tokenIn
string
required

Input token contract address

Example:

"0xb794F5eA0ba39494cE839613fffBA74279579268"

tokenOut
string
required

Output token contract address

Example:

"0xb794F5eA0ba39494cE839613fffBA74279579268"

amountIn
string

Input amount (in token smallest unit). Provide either amountIn or amountOut, not both.

Example:

"1000000000000000000"

amountOut
string

Desired output amount (in token smallest unit). Provide either amountIn or amountOut, not both.

Example:

"1000000000000000000"

destinationAddress
string

Recipient address on destination chain

Example:

"0xb794F5eA0ba39494cE839613fffBA74279579268"

originAddress
string

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).

Example:

"0xb794F5eA0ba39494cE839613fffBA74279579268"

refundAddress
string

Address for refunds if swap fails

Example:

"0xb794F5eA0ba39494cE839613fffBA74279579268"

output
enum<string>
default:bytecode

Response format when both originAddress and destinationAddress are provided. Defaults to bytecode. userOperation and fireblocks are EVM-origin only.

Available options:
bytecode,
userOperation,
fireblocks
accountId
string

Fireblocks vault account ID. Required when output=fireblocks.

Example:

"12"

feeSponsorship
boolean

Request fee sponsorship on eligible Pods bridge routes

Example:

false

preferredProvider
string

Registered provider name to force when eligible for the route

Example:

"relay"

slippage
string

Slippage tolerance as a fraction of 1. Valid range is 0.0001 to 0.5.

Example:

"0.01"

transferSpeed
enum<string>

Transfer speed for CCTP cross-chain swaps

Available options:
fast,
standard
Example:

"fast"

webhookURL
string<uri>

Optional per-quote webhook endpoint. When set, quote lifecycle webhooks are delivered to this URL instead of the customer default webhookURL.

Example:

"https://example.com/webhooks/swap-quote"

Response

Quote generated successfully

quote
object
required

Freshly generated swap quote returned by GET /v2/swap/quote

id
string

Action ID for execution tracking when bytecode is included

chainId
number

Origin chain ID when bytecode is included

transactionData
object

Transaction data for execution

userOperation
any | null

ERC-4337 user operation when output=userOperation and both addresses are provided