Skip to main content
GET
Get quotes

Query Parameters

userOps
enum<string>[]
required

Requested user operation types. Use a comma-separated value or repeat the query param. Allowed values: tx, deposit, cex-withdraw.

Available options:
tx,
deposit,
cex-withdraw
Example:
destinationChainId
string
default:8453
required

Destination chain ID.

Example:

"8453"

inputToken
string
default:0xaf88d065e77c8cc2239327c5edb3a432268e5831
required

Input token address on originChainId, or token symbol when userOps is cex-withdraw and originChainId is omitted.

Example:

"0xaf88d065e77c8cc2239327c5edb3a432268e5831"

inputAmount
string
default:1000000
required

Input amount in token base units. HyperCore origins accept decimal strings.

Example:

"1000000"

outputToken
string
default:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
required

Output token address on destinationChainId.

Example:

"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"

receiverAddress
string
default:0x3e8cB4bd04d81498aB4b94a392c334F5328b237b
required

Destination receiver address. Final recipient for plain routes; executor/contract receiver when destinationPayload is set.

Example:

"0x3e8cB4bd04d81498aB4b94a392c334F5328b237b"

originChainId
string
default:42161
required

Origin chain ID. Required for tx and deposit userOps; optional for cex-withdraw.

Example:

"42161"

userAddress
string
default:0x3e8cB4bd04d81498aB4b94a392c334F5328b237b
required

Origin wallet address. Required for tx userOp. Used as the default refund address unless refundAddress is set.

Example:

"0x3e8cB4bd04d81498aB4b94a392c334F5328b237b"

slippage
string

Slippage tolerance percentage.

refundAddress
string

Address to refund funds to. Required for deposit and cex-withdraw userOps.

contractCaller
string

Intermediate contract that will call AllowanceHolder.exec on behalf of userAddress (e.g. an integrator bridge contract), for direct tx routes. userAddress remains the default refund address unless refundAddress is set. Pass this only when a contract — not the user's own wallet — is the AllowanceHolder caller, otherwise the transaction reverts (CallerNotSignedUser).

feeBps
string

Affiliate fee in basis points. Must be provided together with feeTakerAddress.

feeTakerAddress
string

Address that receives the affiliate fee. Must be provided together with feeBps.

refuel
enum<string>

Whether to request gas refuel. Must be exactly true or false.

Available options:
true,
false
destinationPayload
string

Hex payload to execute on the destination receiver. Requires destinationGasLimit when set.

destinationGasLimit
string

Gas limit for destination payload execution. Requires destinationPayload when set.

includeProvider
string

Comma-separated provider IDs to include. Same-chain routes treat these as DEX IDs; cross-chain routes treat these as public bridge IDs.

excludeProvider
string

Comma-separated provider IDs to exclude. Same-chain routes treat these as DEX IDs; cross-chain routes treat these as public bridge IDs.

exchange
string

CEX exchange ID. Required for cex-withdraw userOp.

includeQuoteRejections
enum<string>

When true, include per-provider rejection reasons for cross-chain tx quotes that returned no route.

Available options:
true,
false
private
enum<string>

When true, only privacy-capable direct tx providers are quoted.

Available options:
true,
false
simulatedQuotesRequired
enum<string>

When true, return only same-chain DEX routes that passed on-chain simulation, with output amounts replaced by simulated values.

Available options:
true,
false
solanaSponsorAddress
string

Solana sponsor address for gasless same-chain swaps. When set, the sponsor pays tx fees and ATA rent (DFlow sponsored swap). Solana origin only.

Response

200 - application/json

V3 swap quote routes.