Get Quotes for Pair
GET/v3/pairs/:pairId/quotesDescription
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 |
| App-Platform | Client platform: desktop, mobile, or browser | no | browser |
| 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 swappingtoAmount- Object containing the asset ID and value you will receiveid- Quote ID (can be used for tracking)pairId- The pair for this quoteexpiry- Timestamp when the quote expires (milliseconds since epoch)
Try it
Press on the 'Send' button to try this request.
