Get Quotes for Pair

GET/v3/pairs/:pairId/quotes

Description

This endpoint retrieves a quote for a specific amount on a pair. Unlike the /rates endpoint which returns multiple rate options, this endpoint provides a quote for the exact amount you specify.

Use this endpoint when you need:

Higher maximums (quotes support larger amounts than rates)
Real-time quotes for specific amounts

Floating Quote Flow: When using this endpoint to get quotes, you must create orders using POST /v3/orders/float instead of the standard /v3/orders endpoint.

Header Parameters

Name	Description	Required	Example
App-Name	App-Name for the authorization	yes	acme-inc
App-Version	App-Version for the authorization	no	23.5.5
Forwarded	If you are proxying requests to the API, you must include the "Forwarded" header with the original request IP address. This is used for geolocation availability purposes.	no
User-Agent	User-Agent for the authorization	no	AgentName/1.0.0

Path Parameters

Name	Description	Required
pairId	Pair id from the list of pairs	yes

Query Parameters

Name	Description	Required
amount	The amount you want to swap (in the "from" asset unit)	yes

Response

SUCCESSFUL QUOTE

{
  "fromAmount": {
    "assetId": "ETH",
    "value": "0.1"
  },
  "id": "bb206d2a78049b6a5c54f10c07bc32c459fd583d52e0c644e567aa34941fede3",
  "pairId": "ETH_USDC",
  "toAmount": {
    "assetId": "USDC",
    "value": "289.645"
  },
  "expiry": 1763651841481
}

Response fields:

fromAmount - Object containing the asset ID and value you’re swapping
toAmount - Object containing the asset ID and value you will receive
id - Quote ID (can be used for tracking)
pairId - The pair for this quote
expiry - Timestamp when the quote expires (milliseconds since epoch)

Try it

Press on the 'Send' button to try this request.