Skip to main content
GET
/
v1
/
forex
/
rates
Historical NGN forex rates
curl --request GET \
  --url https://api.ngnmarket.com/v1/forex/rates \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "date": "2026-04-17",
      "currency": "USD",
      "rate": 0.000623
    },
    {
      "date": "2026-04-16",
      "currency": "USD",
      "rate": 0.000621
    },
    {
      "date": "2026-04-15",
      "currency": "USD",
      "rate": 0.000619
    }
  ],
  "meta": {
    "plan": "starter",
    "calls_used": 4821,
    "calls_remaining": 95179,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}
This endpoint gives you historical exchange rate data between NGN and any supported currency pair. You can narrow results by currency code, date range, 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 Starter plan or higher.

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"

​
currency
string

Shorthand currency filter when querying NGN-based rates. Overridden by explicit source/target.

​
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"

​
limit
integer

Maximum number of records to return.

Response

Historical forex rates retrieved successfully.

​
success
boolean
required
​
meta
object

Quota and plan metadata included on every authenticated response.

​
data
object[]