API Reference

The NGN Market API provides programmatic access to Nigerian Exchange Group (NGX) market data. All endpoints share a common base URL, authentication scheme, and response envelope.

Market

Snapshots, ASI, top trades, gainers, sector rotation

Companies

Profiles, price charts, and financial statements

Forex & Indices

NGN exchange rates and all NGX market indices

Base URL

https://api.ngnmarket.com/v1

Need prices or these other channels pushed to you instead of polling? See the WebSocket API.

Authentication

Every endpoint except /health requires a Bearer token in the Authorization header:

Authorization: Bearer ngm_live_YOUR_KEY

curl https://api.ngnmarket.com/v1/market/snapshot \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

const res = await fetch('https://api.ngnmarket.com/v1/market/snapshot', {
  headers: { 'Authorization': 'Bearer ngm_live_YOUR_KEY' }
});
const data = await res.json();

import requests

res = requests.get(
  'https://api.ngnmarket.com/v1/market/snapshot',
  headers={ 'Authorization': 'Bearer ngm_live_YOUR_KEY' }
)
data = res.json()

Get your key from the developer dashboard.

Never expose your API key in client-side code or commit it to version control. If a key is compromised, revoke it from the dashboard immediately.

HTTP Response Codes

Code	Meaning
`200`	Request succeeded
`401`	Missing or invalid API key
`403`	Endpoint requires a higher plan, or request IP is not in this key’s allowlist
`404`	Resource or route not found
`429`	Monthly quota exceeded
`500`	Unexpected server error

Response Envelope

Every response (success or error) uses the same JSON envelope:

{
  "success": true,
  "data": { },
  "meta": {
    "plan": "starter",
    "calls_used": 4821,
    "calls_remaining": 95179,
    "reset_at": "2026-05-01T00:00:00.000Z"
  }
}

The meta object is included on every response, so you can check calls_remaining and reset_at without a separate request to /account/usage.

Using the API

Market Endpoints

Company Endpoints

Dividend Endpoints

Forex Endpoints

Index Endpoints

ETF Endpoints

Bond Endpoints

Disclosure Endpoints

Blog Endpoints

Account Endpoints

Market

Companies

Forex & Indices

Base URL

Authentication

HTTP Response Codes

Response Envelope

Market

Companies

Forex & Indices

​Base URL

​Authentication

​HTTP Response Codes

​Response Envelope

Base URL

Authentication

HTTP Response Codes

Response Envelope