NGN Market offers six plans. The Free plan lets you explore the API without spending anything. Paid plans unlock more endpoints and higher call limits.
You can change your plan at any time from your developer dashboard.
Plan overview
| Plan | Monthly calls | Price |
|---|
| Free | 3,000 | Free |
| Hobby | 10,000 | ₦15,000 / month |
| Starter | 100,000 | ₦50,000 / month |
| Growth | 500,000 | ₦200,000 / month |
| Business | 2,000,000 | ₦700,000 / month |
| Enterprise | Custom | Custom |
All API keys on your account share one monthly quota pool. If you have multiple keys, their combined usage counts toward the same limit.
Endpoints by plan
Each endpoint is gated to a minimum plan. Calling an endpoint above your plan returns a 403 PLAN_REQUIRED error. The tables below show which plan each endpoint requires.
Free plan
Available to all accounts at no cost.
| Endpoint | Description |
|---|
GET /market/snapshot | Daily market summary: ASI, volume, value traded, market cap |
GET /market/available-dates | Dates for which market data is available |
GET /companies | Paginated, searchable company list |
GET /companies/identifiers | All NGX ticker symbols |
GET /forex/current | Latest NGN exchange rates |
GET /indices | All NGX market indices |
GET /disclosures | Paginated feed of official corporate filings from NGX-listed companies |
GET /disclosures/types | All disclosure submission types with document counts |
GET /companies/:symbol/disclosures | Corporate disclosures scoped to a single company |
GET /blog/posts | Paginated, filterable feed of published posts (filter by category, company, or tag) |
GET /blog/posts/:slug | Full post detail: rich author profile, named taxonomies, and content preview |
GET /blog/search | AI-powered full-text search across posts |
GET /account/usage | Quota status and 30-day request analytics |
Hobby plan (₦15,000/month)
Includes everything in Free, plus:
| Endpoint | Description |
|---|
GET /companies/:symbol | Full company profile |
GET /companies/:symbol/chart | Historical price series |
GET /forex/history | Historical NGN forex rates |
GET /indices/:symbol | Single index detail and constituents |
GET /indices/:symbol/chart | Historical index values |
Starter plan (₦50,000/month)
Includes everything in Hobby, plus:
| Endpoint | Description |
|---|
GET /market/top-trades | Most traded stocks for a given date |
GET /market/movers | Top gainers and losers for a date |
GET /companies/:symbol/dividends | Full dividend history with ex-dates, amounts, and yield |
GET /dividends/upcoming | Paginated calendar of all upcoming ex-dividend dates across NGX |
GET /dividends/recent | Dividends whose ex-date fell within the last 60 days |
GET /companies/:symbol/news | Recent news articles by company symbol |
GET /bonds | NGX-listed bond instruments |
GET /account/logs | Paginated request log history |
Growth plan (₦200,000/month)
Includes everything in Starter, plus:
| Endpoint | Description |
|---|
GET /market/breadth | Trading session list with market breadth data |
GET /market/sectors | Sector-level performance breakdown |
GET /market/ytd-performers | Year-to-date best and worst performers |
Business plan (₦700,000/month)
Includes everything in Growth, plus:
| Endpoint | Description |
|---|
GET /companies/:symbol/financials | Income statement, balance sheet, cash flow, and key financial ratios |
Enterprise plan (Custom pricing)
Designed for organizations that need more than 2,000,000 calls per month, SLA guarantees, or dedicated support. Contact the NGN Market team to discuss pricing.
Not sure which plan fits? Start on Free to explore the API, then upgrade when you need more calls or access to higher-tier endpoints.
Shared quota pool
All keys on your account draw from the same monthly quota. If you have three keys on a Starter plan and one key uses 80,000 calls, the other two keys share the remaining 20,000 calls for that month. Use separate accounts if you need isolated quotas.
Quota resets on your billing renewal date — the same day of the month you first subscribed. You can check your current usage at any time in the meta field included in every API response. See Rate limits for details.
Upgrading your plan
Log in to your developer dashboard and select a new plan. Upgrades take effect immediately. You gain access to higher-tier endpoints and a larger quota as soon as the upgrade is confirmed.
Downgrades take effect at the start of your next billing cycle. Calls to endpoints above your new plan tier will return 403 PLAN_REQUIRED errors once the downgrade kicks in.