Skip to main content
GET
Historical NGN forex rates
This endpoint is /v1/forex/history, not /v1/forex/rates. For current rates, see Live NGN exchange rates.

Authorizations

Authorization
string
header
required

Pass your API key as a Bearer token: Authorization: Bearer ngm_live_YOUR_KEY. Generate keys at ngnmarket.com/dashboard/developer.

Query Parameters

source
string
default:USD

Source currency code (e.g. USD, EUR, GBP). Defaults to USD.

Example:

"USD"

target
string
default:NGN

Target currency code. Defaults to NGN.

Example:

"NGN"

period
enum<string>
default:30d

Preset window when from/to are not given. Defaults to 30d.

Available options:
7d,
30d,
90d,
1y,
all
format
enum<string>
default:detailed

detailed (default) returns full rows with pagination and summary statistics; simple returns every row in the window as {date, rate, timestamp}, unpaginated.

Available options:
detailed,
simple
from
string<date>

Start date in YYYY-MM-DD format (inclusive).

Example:

"2026-01-01"

to
string<date>

End date in YYYY-MM-DD format (inclusive). Defaults to today.

Example:

"2026-04-17"

page
integer
default:1

Page number for format=detailed.

limit
integer
default:100

Rows per page for format=detailed.

Response

Historical forex rates retrieved successfully.

success
boolean
required
meta
object

Quota and plan metadata included on every authenticated response.

data
object