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

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 always know where you stand on your quota.

Market Status

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