Quotes

Get the Best Quote

Retrieve the best available swap quote for a given source token, destination token, and amount. This endpoint returns pricing details, limits, and metadata required to proceed with a swap.

Quotes are time-limited and must be executed before they expire.

HTTP request

POST /v1/quotes

Request

Header parameters

Requires authentification.

Body parameters

Name	Type	Required	Description
from	Object	Required	Base token information for receiveing quote.
token_id	Number	Conditional required	Part of from object. Required only if network_id and token are not provided. For receiveing token_id use the GET /v1/tokens endpoint.
network_id	Number	Conditional required	Part of from object. Required only if token_id is not provided. For receiveing network_id use the GET /v1/networks endpoint.
token	String	Conditional required	Part of from object. Required only if token_id is not provided.
to	Object	Required	Quote token information for receiveing quote.
token_id	Number	Conditional required	Part of to object. Required only if network_id and token are not provided. For receiveing token_id use the GET /v1/tokens endpoint.
network_id	Number	Conditional required	Part of to object. Required only if token_id is not provided. For receiveing network_id use the GET /v1/networks endpoint.
token	String	Conditional required	Part of to object. Required only if token_id is not provided.
amount	Number	Required	Amount to swap, must be specified in decimal-adjusted format.
slippage_bps	String	Required	Slippage expressed in basis points.

Sample request

application/json

{
  "from": {
    "token_id": 1
  },
  "to": {
    "token_id": 4
  },
  "amount": 100,
  "slippage_bps": "50"
}

Response

Sample response

application/json

{
  "id": "bea66e69-64c3-4b88-96ac-29f1ce7d454d",
  "from": {
    "network_id": 1,
    "token": "0xdac17f9********13d831ec7",
    "token_id": 1,
    "amount_lots": 100000000,
    "amount_decimals": 6
  },
  "mid": {
    "token_id": null,
    "token": null,
    "token_min_amount": null,
    "token_max_amount": null,
    "token_decimals": null
  },
  "to": {
    "network_id": 4,
    "token": "0xdac17f9********13d831ec7",
    "token_id": 4,
    "min_amount_lots": 857382336,
    "max_amount_lots": 861690790,
    "amount_decimals": 9
  },
  "slippage_bps": "50",
  "expires_at": 1769777954084
}

Error response

Check the error response schema.

Quote Expiry

The expires_at field is a Unix timestamp in milliseconds (ms since epoch). After this timestamp, the quote is no longer valid and must be refreshed. Quotes should always be executed before expiry to guarantee pricing.

Middle Token Routing

If the user attempts to swap a volatile token, the system may automatically route the swap through a highly liquid intermediate token, typically USDC, to improve execution reliability and manage price volatility. All fields prefixed within mid response object describe this routing behavior and the token used internally.

Affiliate fees

To set your reward amount, please contact your manager or reach out to us at [email protected].

---