List live exchange rates

Fetches exchange rates for multiple currency pairs from all enabled providers.

Filters that match no supported pair (for example an unknown currency code) don't error; they return a 200 with an empty data array. Use Get supported currencies to confirm a pair is supported.

GET/v1/fx/rates

Query Parameters

When true, crypto pairs are included in the rates data alongside fiat pairs. Defaults to false.

Filter by source currency (3-letter ISO 4217 code)

Filter by target currency (3-letter ISO 4217 code)

Comma-separated list of specific currency pairs to retrieve, each in FROM/TO format.

Responses

Status	Description
`200`	List of exchange rates
`400`	Invalid request
`401`	Missing or invalid API key
`500`	Internal server error

200 response

Rate for this pair in the given direction; null if unavailable for that direction.

Direction of the rate.

Possible values: BUY, SELL

Category of the currency pair.

Possible values: fiat/fiat, crypto/crypto, fiat/crypto, crypto/fiat

{
"data": [
{
  "rate": 13.7741,
  "direction": "BUY",
  "currency_pair": "BWP/USD",
  "pair_type": "fiat/fiat",
  "from_currency": "BWP",
  "from_currency_name": null,
  "timestamp": "2026-03-23T12:50:32.082350079+01:00",
  "to_currency": "USD",
  "to_currency_name": null
},
{
  "rate": 18.4025,
  "direction": "SELL",
  "currency_pair": "USD/ZAR",
  "pair_type": "fiat/fiat",
  "from_currency": "USD",
  "from_currency_name": null,
  "timestamp": "2026-03-23T12:50:32.450793659+01:00",
  "to_currency": "ZAR",
  "to_currency_name": null
}
],
"error": null
}

400 response

Always null for error responses.

Human-readable error message.

{
"data": null,
"error": "field 'currencypairs[0]' must be a valid currency pair format (e.g., USD/ZAR, BTC/USDT)"
}

401 response

Always null for error responses.

Human-readable error message.

{
"data": null,
"error": "Invalid or missing Api-Key header. Api-Key is required!"
}

{
"data": null,
"error": "Invalid token!"
}

500 response

Always null for error responses.

Human-readable error message.

{
"data": null,
"error": "Internal server error"
}

Authorization

ApiKeyAuth

Was this page helpful?