NGX Pulse API
Access real-time Nigerian stock market data programmatically. Build trading apps, dashboards, alerts, and analytics with our RESTful JSON API.
REST API JSON Real-time 99.9% Uptime
Base URL for all API requests:
Base URL
https://ngxpulse.ng/api/ngxdata
🔐 Authentication
Authenticate requests by including your API key in the x-api-key header.
cURL
# Example authenticated request curl -H "x-api-key: YOUR_API_KEY" \ https://ngxpulse.ng/api/ngxdata/stocks
Get an API key by signing up for a free account. Free tier includes 100 requests/day.
⚡ Rate Limits
Rate limits depend on your plan. Limits reset at midnight WAT (UTC+1).
100
Free / day
10,000
Pro / day
∞
Enterprise
Rate limit headers included in every response:
Response Headers
X-RateLimit-Limit: 100 X-RateLimit-Remaining: 87 X-RateLimit-Reset: 1706832000
📊 Endpoints
Get All Stocks
GET/stocks
Returns all listed equities on the NGX with current prices, change percentages, volume, and market data.
| Parameter | Type | Required | Description |
|---|---|---|---|
| sector | string | Optional | Filter by sector |
| sort | string | Optional | Sort by: price, change, volume, mcap |
| limit | integer | Optional | Max results (default: all) |
Response
{ "stocks": [ { "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 } ], "count": 182, "timestamp": "2026-02-08T14:30:00+01:00" }Get Stock Detail
GET/stocks/:symbol
Returns detailed data for a single stock including financials, dividend history, and historical prices.
Example
# Get Zenith Bank details curl https://ngxpulse.ng/api/ngxdata/stocks/ZENITHBANK \ -H "x-api-key: YOUR_API_KEY"
Market Summary
GET/market
Returns current ASI, market cap, total volume, value traded, and market breadth.
Response
{ "asi": 171727.49, "market_cap": 110200000000000, "volume": 174800000000, "advancers": 55, "decliners": 30, "unchanged": 15 }News Feed
GET/news
Returns latest market news and corporate actions from the Nigerian Exchange.
Historical Data
GET/stocks/:symbol/history
Returns daily OHLCV data for a stock. Pro and Enterprise plans only.
| Parameter | Type | Required | Description |
|---|---|---|---|
| from | date | Required | Start date (YYYY-MM-DD) |
| to | date | Optional | End date (default: today) |
Sector Performance
GET/sectors
Returns sector-level performance data including daily/weekly/monthly changes.
💳 Pricing
Simple, transparent pricing. Start free, upgrade as you grow.
Free
₦0/mo
- 100 requests/day
- Real-time prices
- All stocks endpoint
- Market summary
Pro
₦15K/mo
- 10,000 requests/day
- Historical data (5 years)
- Sector breakdowns
- Webhook alerts
- Priority support
Enterprise
Custom
- Unlimited requests
- Full historical data
- Dedicated endpoint
- SLA guarantee
- Custom integrations
⚠️ Error Codes
| Code | Status | Description |
|---|---|---|
| 200 | OK | Request successful |
| 400 | Bad Request | Invalid parameters |
| 401 | Unauthorized | Missing or invalid API key |
| 404 | Not Found | Stock symbol not found |
| 429 | Rate Limited | Rate limit exceeded |
| 500 | Server Error | Internal server error |
📦 SDKs & Libraries
Official SDKs to get started faster.
JavaScript / Node.js
import { NGXPulse } from 'ngxpulse'; const client = new NGXPulse('YOUR_API_KEY'); const stocks = await client.stocks.list(); const dangcem = await client.stocks.get('DANGCEM');
Python
from ngxpulse import NGXPulse client = NGXPulse(api_key="YOUR_API_KEY") stocks = client.stocks.list() dangcem = client.stocks.get("DANGCEM")