Skip to main content
GET
Get a live derived quote (not persisted)
This endpoint returns a live derived quote. Quotes are not persisted as entities. For quoting semantics, see Quote.

Authorizations

Authorization
string
header
required

Basic Auth (assumed at gateway for MVP)

Query Parameters

chainId
integer<uint64>
required
Example:

1

tokenIn
string
required
Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f5fE4b"

tokenOut
string
required
Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f5fE4b"

tradeType
enum<string>
required
Available options:
EXACT_IN,
EXACT_OUT
amount
string
required

Amount (smallest units) as string. Interpretation depends on tradeType.

slippageBps
integer
default:50
Required range: 0 <= x <= 5000

Response

Quote

asOf
object
required
expiresAt
string<date-time>
required
chainId
integer<uint64>
required
Example:

1

tokenIn
string
required
Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f5fE4b"

tokenOut
string
required
Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f5fE4b"

tradeType
enum<string>
required
Available options:
EXACT_IN,
EXACT_OUT
amountIn
string
required

Exact input amount (smallest units as a string)

Example:

"1000000"

amountOut
string
required

Exact output amount (smallest units as a string)

Example:

"999000"

fees
object

Fee breakdown (protocol, gas estimate, etc.)

route
object

Router/path details (implementation-defined)