v1

latestOpenAPI 3.1.02026-07-2643416.7 KB

quote

Price a swap and return a routePlan

post/quote

Request body

chainIdinteger required

EVM chain id. 8453 for Base (current Phase-1 target).

tokenInstring required

20-byte hex address. The sentinel 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE (or the zero address) signals the chain's native asset (ETH on Base) and is recognized in tokenIn/tokenOut.

tokenOutstring required

20-byte hex address. The sentinel 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE (or the zero address) signals the chain's native asset (ETH on Base) and is recognized in tokenIn/tokenOut.

amountInstring required

Non-negative integer encoded as a decimal string (wei).

slippageBpsinteger required

maxHopsinteger

splitEnabledboolean

enforcePoolDisjointboolean

allowedDexesDexId[]

feeBpsinteger

Integrator fee in bps, charged out of the output amount.

takerstring

20-byte hex address. The sentinel 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE (or the zero address) signals the chain's native asset (ETH on Base) and is recognized in tokenIn/tokenOut.

timeBudgetMsinteger

Per-request override of the optimizer's wall-clock budget. Omit to inherit the engine default.

Response

Quote produced

quoteIdstring required

SHA-256 (or HMAC-SHA256 if the server has O1_QUOTE_SIGNING_KEY set) of the quote payload. Echo this on /submit.

expiresAtinteger required

Unix epoch milliseconds at which the cached quote drops.