{"openapi":"3.1.0","info":{"title":"The Nigerian Exchange (NGX) API","version":"1.0.0","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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/ngx-api","description":"oanor gateway"}],"tags":[{"name":"Quotes"},{"name":"Screener"},{"name":"Indices"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/quote":{"get":{"operationId":"get_v1_quote","tags":["Quotes"],"summary":"Live quote for one or more NGX stocks","description":"","parameters":[{"name":"codes","in":"query","required":true,"description":"NGX ticker(s), comma-separated up to 20","schema":{"type":"string"},"example":"DANGCEM,MTNN"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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-6f3f5b9faaa9"},"status":"ok","message":"Quote retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/screener":{"get":{"operationId":"get_v1_screener","tags":["Screener"],"summary":"Ranked market screener","description":"","parameters":[{"name":"by","in":"query","required":false,"description":"Ranking: gainers, losers, active, marketcap","schema":{"type":"string"},"example":"marketcap"},{"name":"limit","in":"query","required":false,"description":"Results 1-100","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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_percent":0},{"price":800,"change":0,"sector":"Communications","ticker":"MTNN","volume":7008897,"company":"MTN Nigeria Communications Plc","currency":"NGN","market_cap":16796448437500,"change_percent":0},{"price":378,"change":0,"sector":"Non-Energy Minerals","ticker":"BUACEMENT","volume":539057,"company":"BUA Cement Plc","currency":"NGN","market_cap":12800726367188,"change_percent":0},{"price":1770,"change":0,"sector":"Energy Minerals","ticker":"ARADEL","volume":1292777,"company":"Aradel Holdings Plc","currency":"NGN","market_cap":7690375166016,"change_percent":0},{"price":11363.9,"change":0,"sector":"Energy Minerals","ticker":"SEPLAT","volume":45891,"company":"Seplat Energy PLC","currency":"NGN","market_cap":6284589001975.505,"change_percent":0},{"price":330,"change":2,"sector":"Non-Energy Minerals","ticker":"WAPCO","volume":2555572,"company":"Lafarge Africa Plc","currency":"NGN","market_cap":5315572646484,"change_percent":0.61},{"price":124.5,"change":-2.5,"sector":"Finance","ticker":"ZENITHBANK","volume":27357879,"company":"Zenith Bank PLC","currency":"NGN","market_cap":5113194087891,"change_percent":-1.97},{"price":135.95,"change":-0.05000000000001137,"sector":"Finance","ticker":"GTCO","volume":9170859,"company":"Guaranty Trust Holding Company Plc","currency":"NGN","market_cap":4967978785160,"change_percent":-0.04},{"price":69,"change":1.75,"sector":"Finance","ticker":"FIRSTHOLDCO","volume":6740328,"company":"First HoldCo Plc","currency":"NGN","market_cap":3067304707031,"change_percent":2.6},{"price":1132.5,"change":0,"sector":"Utilities","ticker":"GEREGU","volume":2735,"company":"Geregu Power Plc","currency":"NGN","market_cap":2831250000000,"change_percent":0},{"price":2300,"change":0,"sector":"Consumer Non-Durables","ticker":"PRESCO","volume":90099,"company":"Presco PLC","currency":"NGN","market_cap":2683333239746,"change_percent":0},{"price":165,"change":0,"sector":"Finance","ticker":"STANBIC","volume":329105,"company":"Stanbic IBTC Holdings Plc","currency":"NGN","market_cap":2623791811523,"change_percent":0},{"price":80,"change":-1.5,"sector":"Consumer Non-Durables","ticker":"NB","volume":10407017,"company":"Nigerian Breweries PLC","currency":"NGN","market_cap":2478642031250,"change_percent":-1.84},{"price":3125,"change":0,"sector":"Consumer Non-Durables","ticker":"NESTLE","volume":24345,"company":"Nestle Nigeria Plc","currency":"NGN","market_cap":2477050781250,"change_percent":0},{"price":97.4,"change":0,"sector":"Finance","ticker":"ETI","volume":265299,"company":"Ecobank Transnational, Inc.","currency":"NGN","market_cap":2298007696938,"change_percent":0},{"price":223.3,"change":0,"sector":"Consumer Services","ticker":"TRANSCOHOT","volume":35199,"company":"Transcorp Hotels PLC","currency":"NGN","market_cap":2287156605183,"change_percent":0},{"price":12.1,"change":-0.34999999999999964,"sector":"Consumer Non-Durables","ticker":"INTBREW","volume":1843044,"company":"International Breweries PLC","currency":"NGN","market_cap":2036328159511,"change_percent":-2.81},{"price":43,"change":-0.10000000000000142,"sector":"Finance","ticker":"UBA","volume":106979999,"company":"United Bank for Africa PLC","currency":"NGN","market_cap":1900435558594,"change_percent":-0.23}],"description":"largest (by market cap)"},"meta":{"timestamp":"2026-06-15T02:10:37.302Z","request_id":"e8f0cb7f-1232-4912-9438-71a701e4ef77"},"status":"ok","message":"Screener retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/index":{"get":{"operationId":"get_v1_index","tags":["Indices"],"summary":"Live value of the NGX All-Share Index","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"ASI","schema":{"type":"string"},"example":"ASI"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata & endpoint catalog","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":9800,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1830,"monthly_call_quota":228000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4940,"monthly_call_quota":1260000,"rps_limit":20,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":11390,"monthly_call_quota":6850000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/ngx-api"}