Skip to main content
GET
Historical NGN forex rates
This endpoint gives you historical exchange rate data between NGN and any supported currency pair. You can narrow results by currency code, date range (from/to), and record count, making it straightforward to populate charts, backtest models, or power rate-change alerts. The source and target parameters default to USD and NGN respectively. Pass both to query any supported pair in either direction. This endpoint requires a Hobby plan or higher. How far back you can go depends on your plan. Hobby gets 2 years, Starter gets 5, and Pro, Business, and Enterprise get the full record. A from date older than your plan allows won’t error, the response just starts from the earliest date you’re entitled to, so check the returned dates rather than assuming the request failed. For example, to fetch GBP/NGN rates for Q1 2026:

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