Skip to main content
GET
/
v1
/
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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ngnmarket.com/llms.txt

Use this file to discover all available pages before exploring further.

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[]