Get currency rates

curl --request GET \
  --url https://api.paystack.com/v1/currencies/{code}/rates \
  --header 'Authorization: Bearer <token>'

{
  "status": true,
  "message": "Rates fetched successfully",
  "code": "ok",
  "data": [
    {
      "currency": "NGN",
      "country_code": "NG",
      "buy": "1580.50",
      "sell": "1611.25"
    }
  ],
  "meta": {
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Supported Currencies

Get currency rates

Get buy and sell rates for a currency against every currency it pairs with directly.

buy is the rate when you acquire the listed currency using the path code currency. sell is the rate when you dispose of the listed currency to receive the path currency. For fiat currencies the only pair is USDC. For USDC you receive one row per supported fiat. Fiat-to-fiat pairs are not listed here (they price through USDC internally).

Values include a small mock spread and deterministic jitter so consecutive calls stay in a narrow band.

Rates are quoted as decimal strings with two places — they are not numbers, to avoid floating-point precision loss for downstream callers handling financial amounts.

Path parameters

code — the currency code (e.g. NGN, USDC).

Query parameters

country_code (optional) — restricts the rates to a specific country (ISO 3166-1 alpha-2). Useful for currencies that quote differently per market.

Example

GET /v1/currencies/NGN/rates?country_code=NG

GET

currencies

{code}

rates

Get currency rates

curl --request GET \
  --url https://api.paystack.com/v1/currencies/{code}/rates \
  --header 'Authorization: Bearer <token>'

{
  "status": true,
  "message": "Rates fetched successfully",
  "code": "ok",
  "data": [
    {
      "currency": "NGN",
      "country_code": "NG",
      "buy": "1580.50",
      "sell": "1611.25"
    }
  ],
  "meta": {
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Authorizations

Authorization

string

header

required

API key issued during merchant onboarding.

Path Parameters

code

string

required

Pattern: [^\/#\?]+?

Query Parameters

country_code

string

Response

Rates fetched successfully

status

enum<boolean>

required

Available options:

true

Example:

true

message

string

required

Human-readable summary

Example:

"Rates fetched successfully"

code

enum<string>

required

Available options:

ok

Example:

"ok"

data

object[]

required

Show child attributes