# The Nigerian Exchange (NGX) API > Live data for the Nigerian Exchange (NGX, the Lagos market) with no key: the live quote for one or more stocks by ticker (price, change, open/high/low, volume, market cap, P/E, sector, in naira, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap), and the live value of the NGX All-Share Index. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/ngx-api/..." ``` ## Pricing - **Free** (Free) — 9,800 calls/Mo, 2 req/s - **Basic** ($18/Mo) — 228,000 calls/Mo, 10 req/s - **Pro** ($49/Mo) — 1,260,000 calls/Mo, 20 req/s - **Scale** ($114/Mo) — 6,850,000 calls/Mo, 50 req/s ## Endpoints ### Quotes #### `GET /v1/quote` — Live quote for one or more NGX stocks **Parameters:** - `codes` (query, required, string) — NGX ticker(s), comma-separated up to 20 Example: `DANGCEM,MTNN` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/ngx-api/v1/quote?codes=DANGCEM%2CMTNN" ``` **Response:** ```json { "data": { "note": "The live quote for one or more Nigerian (NGX) stocks — price, change, open/high/low, volume, market cap, P/E and sector (in naira), with the company name. Pass codes (the NGX ticker, comma-separate up to 20, e.g. DANGCEM,MTNN).", "count": 2, "quotes": [ { "low": 1155, "high": 1155, "open": 1155, "price": 1155, "change": 0, "sector": "Non-Energy Minerals", "ticker": "DANGCEM", "volume": 339746, "company": "Dangote Cement PLC", "currency": "NGN", "pe_ratio": 17.31, "market_cap": 19155911865234, "change_percent": 0 }, { "low": 800, "high": 800, "open": 800, "price": 800, "change": 0, "sector": "Communications", "ticker": "MTNN", "volume": 7008897, "company": "MTN Nigeria Communications Plc", "currency": "NGN", "pe_ratio": 12.57, "market_cap": 16796448437500, "change_percent": 0 } ], "source": "The Nigerian Exchange / NGX (TradingView)" }, "meta": { "timestamp": "2026-06-15T02:10:37.076Z", "request_id": "c1c803f5-a4dd-4056-b506-6f3f5b9 …(truncated, see openapi.json for full schema) ``` ### Screener #### `GET /v1/screener` — Ranked market screener **Parameters:** - `by` (query, optional, string) — Ranking: gainers, losers, active, marketcap Example: `marketcap` - `limit` (query, optional, string) — Results 1-100 Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/ngx-api/v1/screener?by=marketcap&limit=20" ``` **Response:** ```json { "data": { "by": "marketcap", "note": "A ranked screener of the Nigerian (NGX) market — the top stocks by your chosen ranking. Pass by (gainers, losers, active, or marketcap; default marketcap) and limit (1-100, default 20). Only real stocks above a market-cap floor are ranked.", "count": 20, "source": "The Nigerian Exchange / NGX (TradingView)", "results": [ { "price": 4021.2, "change": 0, "sector": "Communications", "ticker": "AIRTELAFRI", "volume": 208, "company": "Airtel Africa Plc", "currency": "NGN", "market_cap": 26081112577991.934, "change_percent": 0 }, { "price": 1155, "change": 0, "sector": "Non-Energy Minerals", "ticker": "DANGCEM", "volume": 339746, "company": "Dangote Cement PLC", "currency": "NGN", "market_cap": 19155911865234, "change_percent": 0 }, { "price": 939, "change": 0, "sector": "Process Industries", "ticker": "BUAFOODS", "volume": 50520, "company": "BUA Foods PLC", "currency": "NGN", "market_cap": 16902000000000, "change_ …(truncated, see openapi.json for full schema) ``` ### Indices #### `GET /v1/index` — Live value of the NGX All-Share Index **Parameters:** - `name` (query, optional, string) — ASI Example: `ASI` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/ngx-api/v1/index?name=ASI" ``` **Response:** ```json { "data": { "low": 244456.2, "high": 244944.45, "name": "NGX All Share Index", "note": "The live value of the NGX All-Share Index (the Nigerian Exchange benchmark) — current level, change, and the day's open/high/low. Pass name (ASI; default ASI).", "open": 244877.64, "index": "ASI", "value": 244738.73, "change": -113.47000000000116, "source": "The Nigerian Exchange / NGX (TradingView)", "change_percent": -0.05 }, "meta": { "timestamp": "2026-06-15T02:10:37.505Z", "request_id": "314d7eb7-1e11-440a-aac9-cb4118746c33" }, "status": "ok", "message": "Index retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Service metadata & endpoint catalog **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/ngx-api/v1/meta" ``` **Response:** ```json { "data": { "sample": { "ngx_asi": 244738.73 }, "source": "TradingView public screener (scanner.tradingview.com/nigeria/scan), keyless", "indexes": [ "ASI" ], "screens": [ "gainers", "losers", "active", "marketcap" ], "service": "ngx-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/index": "Live value of the NGX All-Share Index (name).", "GET /v1/quote": "Live quote for one or more stocks (codes).", "GET /v1/screener": "Ranked market screener (by, limit)." }, "description": "Live data for the Nigerian Exchange (NGX, the Lagos market) with no key: the live quote for one or more stocks by ticker (price, change, open/high/low, volume, market cap, P/E, sector, in naira, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap), and the live value of the NGX All-Share Index. The Nigeria-equities / NGX-ASI-index / screener layer for trading dashboards and research. Distinct from other exchange readers — the NGX market with a built-in screener. Live, short cache only.", "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-15T02:10:37.595Z", "request_id": "9c06b80c-ec85-44c4-af36-a7fde72408fe" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/ngx-api OpenAPI spec: https://www.oanor.com/api/ngx-api/openapi.json