NGX Pulse
API Reference
Real-time Nigerian Stock Exchange data infrastructure. Built for developers, analysts, and institutional integrations requiring reliable, low-latency NGX market data.
API Keys
All API requests require authentication via an API key passed in the request header. Keys are issued per integration and scoped to specific access tiers.
X-API-Key header on every request.X-API-Key: your_api_key_here Content-Type: application/json
Endpoint Root
All API endpoints are served from the following base URL. Requests must be made over HTTPS.
Request Limits
Rate limits are applied per API key. Institutional and enterprise keys are available with custom limits based on integration requirements.
| Tier | Requests / Min | Requests / Day | Use Case |
|---|---|---|---|
| Standard | 10 | 500 | Developer / Testing |
| Professional | 60 | 10,000 | Production Apps |
| Institutional | Custom | Unlimited | Enterprise / Trading Terminals |
429 Too Many Requests response. Institutional clients with high-frequency requirements should contact us for custom arrangements. Market Data
Returns real-time price and market data for all 150+ NGX listed equities.Includes price, percentage change, volume, market capitalisation, sector classification, and key financial ratios.
GET https://www.ngxpulse.ng/api/ngxdata/stocks X-API-Key: your_api_key_here
[ { "symbol": "DANGCEM", "name": "Dangote Cement Plc", "current_price": 665.00, "change_percent": 2.31, "volume": 1245890, "shares_outstanding": 17040507405, "sector": "Industrial", "pe_ratio": 18.5 }, // … 150+ equities ] Returns real-time price data for a single NGX listed equity by ticker symbol. Optimised for high-frequency polling of specific instruments.
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | required | NGX ticker symbol e.g. DANGCEM, GTCO, ZENITHBANK |
GET https://www.ngxpulse.ng/api/ngxdata/prices/DANGCEM X-API-Key: your_api_key_here
{ "symbol": "DANGCEM", "name": "Dangote Cement Plc", "current_price": 665.00, "change_percent": 2.31, "volume": 1245890, "sector": "Industrial", "pe_ratio": 18.5 } Returns the NGX All Share Index (ASI), total market capitalisation, trading volume, value, number of deals, and breadth data including advancers, decliners, top gainers and losers.
GET https://www.ngxpulse.ng/api/ngxdata/market X-API-Key: your_api_key_here
{ "asi": 198204.02, "pct_change": 0.63, "market_cap": 35000000000000, "volume": 540000000, "value": 4200000000, "deals": 4500, "advancers": 44, "decliners": 24, "unchanged": 2, "gainers": [ /* top gaining stocks */ ], "losers": [ /* top declining stocks */ ] }Returns the current trading status of the Nigerian Stock Exchange. Useful for conditional logic in trading terminals — only poll price endpoints when the market is open.
{ "status": "open", // "open" | "closed" "message": "NGX Market is Open", "timestamp": "2026-03-13T10:45:00.000Z" } Returns recent corporate disclosures from NGX listed companies including earnings announcements, dividend declarations, rights issues, board resolutions, and other material filings.
GET https://www.ngxpulse.ng/api/ngxdata/disclosures X-API-Key: your_api_key_here
Returns the latest Nigerian capital market news aggregated from leading financial publishers including Nairametrics and BusinessDay. Updated continuously during market hours.
GET https://www.ngxpulse.ng/api/news X-API-Key: your_api_key_here
Error Reference
NGX Pulse API uses standard HTTP status codes. All error responses include a JSON body with a message field describing the issue.
| Status | Code | Description |
|---|---|---|
| 200 | OK | Request successful |
| 400 | Bad Request | Invalid parameters or malformed request |
| 401 | Unauthorized | Missing or invalid API key |
| 404 | Not Found | Symbol or resource not found |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Server Error | Internal error — contact support |
{ "error": true, "status": 401, "message": "Invalid or missing API key" } Get in Touch
For API access requests, institutional integration enquiries, or technical support, reach out directly.
Get Your API Key
Fill in the form below. Personal and learning projects receive a Standard tier key instantly. Commercial and enterprise requests are reviewed within 24 hours.