Sign in

v1

latestOpenAPI 3.0.32026-07-26214048.5 KB
General

Get token rate (v2)

Public quote on a specific network. Returns buy and/or sell quotes, order type, and refund timeout.

Token + fiat: each of from / to is either an enabled fiat currency code or an enabled crypto (token) symbol on network. Exactly one must be fiat and one crypto (.../USDT/100/NGN and .../NGN/100/USDT are equivalent). amount is the crypto notional. Rates are fiat per 1 token for each side. from and to cannot both be crypto.

Ambiguous segment: if a path value matches both an enabled fiat code and an enabled crypto symbol on that network (e.g. same string), the request returns 400 unless from_source and/or to_source is set to fiat or crypto to pick the leg.

Fiat + fiat: both segments are fiat codes. The quote bridges through USDC on the same network. amount is denominated in from fiat. sell is destination fiat per 1 unit of from fiat (buy USDC with from, sell USDC for to). buy is from fiat per 1 unit of to fiat (inverse corridor; buy USDC with to, sell USDC for from)—asymmetric from sell, not a simple reciprocal.

Path order does not imply trade direction for token/fiat pairs; omitting side returns both sides when available.

For the legacy single-number response, use GET /v1/rates/{token}/{amount}/{fiat} with optional network query.

get/rates/{network}/{from}/{amount}/{to}

Path parameters

network'ethereum' | 'base' | 'bnb-smart-chain' | 'lisk' | 'scroll' | 'celo' | 'arbitrum-one' | 'polygon' | 'asset-chain' required

Blockchain network identifier (lowercase in URL).

fromstring required

Fiat code or token symbol on network (paired with to).

amountstring required

For token+fiat pairs, the token notional. For fiat+fiat pairs, the amount in from fiat.

tostring required

Fiat code or token symbol on network (paired with from).

Query parameters

side'buy' | 'sell'

Return only the buy or sell quote. Omit for both sides.

from_source'fiat' | 'crypto'

When from matches both a fiat and a crypto asset on network, set to fiat or crypto to disambiguate. Ignored when from is unambiguous.

to_source'fiat' | 'crypto'

When to matches both a fiat and a crypto asset on network, set to fiat or crypto to disambiguate. Ignored when to is unambiguous.

provider_idstring

Optional. When set, limits the quote to this provider. Must be exactly 8 alphabetic characters (A–Z, a–z).

Response

Token rate quote(s)

statusstring
messagestring

Example response

{
  "status": "success",
  "message": "Operation successful"
}