Skip to main content
This example fetches the latest NGN exchange rates against all supported currencies, then drills into the USD/NGN pair for a 30-day history suitable for charting. Endpoints used:
  • GET /forex/current (Free plan)
  • GET /forex/history (Starter plan)

​
Fetch current rates

Returns live NGN rates against all supported currencies in a single call. 
curl "https://api.ngnmarket.com/v1/forex/current" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

​
Sample response

{
  "success": true,
  "data": {
    "base": "NGN",
    "updated_at": "2026-04-17T16:00:00.000Z",
    "rates": {
      "USD": 1580.25,
      "GBP": 2012.40,
      "EUR": 1720.60,
      "CAD": 1148.30,
      "AUD": 1022.15,
      "GHS": 98.40,
      "ZAR": 84.70,
      "CNY": 218.90,
      "JPY": 10.52,
      "SAR": 421.10
    }
  },
  "meta": {
    "plan": "free",
    "calls_used": 5,
    "calls_remaining": 9995,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

​
Fetch 30-day USD/NGN history

Useful for rendering a rate trend chart or calculating how much the naira has moved against the dollar. 
curl "https://api.ngnmarket.com/v1/forex/history?source=USD&target=NGN&period=30d&format=simple" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

​
Sample response (trimmed)

{
  "success": true,
  "data": {
    "source": "USD",
    "target": "NGN",
    "period": "30d",
    "count": 30,
    "data": [
      { "date": "2026-04-17", "rate": 1580.25 },
      { "date": "2026-04-16", "rate": 1577.80 },
      { "date": "2026-04-15", "rate": 1582.10 }
    ]
  }
}

​
Supported currencies

USD EUR GBP CAD AUD GHS ZAR CNY JPY SAR NGN Pass source and target in any direction. For example, source=NGN&target=USD gives you the inverse rate.

Current rates reference

GET /forex/current parameters

Rate history reference

GET /forex/history parameters