Historical Forex Rates - NGN Market API

Historical NGN forex rates

curl --request GET \
  --url https://api.ngnmarket.com/v1/forex/history \
  --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"
  }
}

GET

forex

history

Historical NGN forex rates

curl --request GET \
  --url https://api.ngnmarket.com/v1/forex/history \
  --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 (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 Starter plan or higher. For example, to fetch GBP/NGN rates for Q1 2026:

curl "https://api.ngnmarket.com/v1/forex/history?source=GBP&target=NGN&from=2026-01-01&to=2026-03-31" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

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"

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