---
title: "Get the best route for an order"
method: GET
path: "/v1/quote"
---

# Get the best route for an order

`GET /v1/quote`

## Request

- Base URL: `https://qmax.exchange/api`
- URL: `https://qmax.exchange/api/v1/quote`
- Auth: none declared

Prices a whole order across the QX order book and the QSwap pool and splits it where that pays more. Use side=sell to find what a holding would fetch and side=buy for what a purchase would cost: no wallet is needed, and a big order's price impact is already in the total. The `summary` field says the result in words (total, average, where each part goes, what the split is worth); `route` has each leg's exact figures and the limits to sign against.

## Query parameters

- `side` 'buy' | 'sell', required
- `asset` string, required
- `qty` integer, required
- `slippageBps` integer
- `split` boolean

## Response `200`

Route quote, with a plain-language `summary`

## Other responses

- `400`: Invalid input
- `404`: Unknown asset

---

[API](https://skmtc.dev/qmax/apis/qmax-api.md) · [All operations](https://skmtc.dev/qmax/apis/qmax-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qmax/apis/qmax-api/revisions/af70e2813a7a?raw)
