API Reference

List exchange rates

Returns indicative rates for display, sorted by pair. You cannot trade at these rates; call POST /v1/fx/quote for a firm price. Filters are not case-sensitive. When rates are not loaded yet, the error is fx cache is not ready; retry the call.

GEThttps://api.gravv.xyz/v1/fx/rates

Query Parameters

Possible values: fiat, crypto

Comma-separated FROM_TO values, such as USD_NGN,USD_EUR

Comma-separated four-part pair keys, such as USD_US_EUR_FR

Responses

Status	Description
`200`	The rates, in one list with no paging
`400`	The request failed. Every FX error is a 400, including not-found and outages. Read `error`.

200 response

Units of the TO currency for 1 unit of the FROM currency

FROM_TO

Pair key FROM_CC_TO_CC. One direction can have several rows, one for each country pair.

Possible values: fiat, crypto

When the rate was last updated. Check it, as a row can be old.

{
"data": [
{
  "currency_pair": "USD_US_NGN_NG",
  "direction": "USD_NGN",
  "from_currency": "USD",
  "from_currency_name": "US Dollar",
  "pair_type": "fiat",
  "rate": "1368.27",
  "timestamp": "2026-10-13T22:20:08.941956Z",
  "to_currency": "NGN",
  "to_currency_name": "NGN"
}
],
"error": null
}

400 response

What went wrong. FX errors carry no code.

{
"data": null,
"error": "order not found"
}

Authorization

ApiKeyAuth

Was this page helpful?