{"openapi":"3.1.0","info":{"title":"Nairobi Securities Exchange (NSE Kenya) API","version":"1.0.0","description":"Live data for the Nairobi Securities Exchange (NSE Kenya, the Kenyan 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 shillings, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap), and a search across the market by company name or ticker (optionally by sector).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/nairobi-stock-api","description":"oanor gateway"}],"tags":[{"name":"Quotes"},{"name":"Screener"},{"name":"Search"},{"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 NSE Kenya stocks","description":"","parameters":[{"name":"codes","in":"query","required":true,"description":"NSE Kenya ticker(s), comma-separated up to 20","schema":{"type":"string"},"example":"SCOM,EQTY"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The live quote for one or more Kenyan (NSE) stocks — price, change, open/high/low, volume, market cap, P/E and sector (in shillings), with the company name. Pass codes (the NSE Kenya ticker, comma-separate up to 20, e.g. SCOM,EQTY).","count":2,"quotes":[{"low":31.05,"high":31.7,"open":31.2,"price":31.4,"change":0.1999999999999993,"sector":"Communications","ticker":"SCOM","volume":2074748,"company":"Safaricom PLC","currency":"KES","pe_ratio":13.14,"market_cap":1234138892308,"change_percent":0.64},{"low":75,"high":76,"open":75.5,"price":76,"change":0.25,"sector":"Finance","ticker":"EQTY","volume":136221,"company":"Equity Group Holdings Limited","currency":"KES","pe_ratio":3.8,"market_cap":284912447754,"change_percent":0.33}],"source":"Nairobi Securities Exchange / NSE Kenya (TradingView)"},"meta":{"timestamp":"2026-06-15T02:10:30.485Z","request_id":"66155628-d6bd-4b74-b7e2-59a80bb1341d"},"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 Kenyan (NSE) 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":"Nairobi Securities Exchange / NSE Kenya (TradingView)","results":[{"price":31.4,"change":0.1999999999999993,"sector":"Communications","ticker":"SCOM","volume":2074748,"company":"Safaricom PLC","currency":"KES","market_cap":1234138892308,"change_percent":0.64},{"price":76,"change":0.25,"sector":"Finance","ticker":"EQTY","volume":136221,"company":"Equity Group Holdings Limited","currency":"KES","market_cap":284912447754,"change_percent":0.33},{"price":69.75,"change":0.5,"sector":"Finance","ticker":"KCB","volume":470851,"company":"KCB Group PLC","currency":"KES","market_cap":222532288269,"change_percent":0.72},{"price":252.75,"change":3.75,"sector":"Distribution Services","ticker":"EABL","volume":518028,"company":"East African Breweries Plc","currency":"KES","market_cap":196981262207,"change_percent":1.51},{"price":31.8,"change":0.6999999999999993,"sector":"Finance","ticker":"COOP","volume":981116,"company":"Co-operative Bank of Kenya Ltd.","currency":"KES","market_cap":185989430306,"change_percent":2.25},{"price":28.9,"change":0.3999999999999986,"sector":"Finance","ticker":"ABSA","volume":853065,"company":"Absa Bank Kenya Plc","currency":"KES","market_cap":153169323089,"change_percent":1.4},{"price":88,"change":-2.5,"sector":"Finance","ticker":"NCBA","volume":116359,"company":"NCBA Group PLC","currency":"KES","market_cap":145393598633,"change_percent":-2.76},{"price":336,"change":1,"sector":"Finance","ticker":"SCBK","volume":12309,"company":"Standard Chartered Bank Kenya Ltd","currency":"KES","market_cap":127339370422,"change_percent":0.3},{"price":293,"change":-0.5,"sector":"Finance","ticker":"SBIC","volume":2110,"company":"Stanbic Holdings Plc","currency":"KES","market_cap":115631575241,"change_percent":-0.17},{"price":55,"change":0,"sector":"Finance","ticker":"IMH","volume":89367,"company":"I&M Group Plc","currency":"KES","market_cap":90949180298,"change_percent":0},{"price":9.1,"change":0,"sector":"Utilities","ticker":"KEGN","volume":1735181,"company":"Kenya Electricity Generating Company PLC","currency":"KES","market_cap":60010152467,"change_percent":0},{"price":517,"change":-2,"sector":"Consumer Non-Durables","ticker":"BAT","volume":18265,"company":"British American Tobacco Kenya PLC","currency":"KES","market_cap":51700000000,"change_percent":-0.39},{"price":53.75,"change":0.25,"sector":"Finance","ticker":"BKG","volume":1713490,"company":"BK Group Plc","currency":"KES","market_cap":48200811157,"change_percent":0.47},{"price":142,"change":-1,"sector":"Finance","ticker":"DTK","volume":31977,"company":"Diamond Trust Bank Kenya Ltd.","currency":"KES","market_cap":39843318329,"change_percent":-0.7},{"price":5.92,"change":0.05999999999999961,"sector":"Transportation","ticker":"KQ","volume":201754,"company":"Kenya Airways PLC","currency":"KES","market_cap":32680555704,"change_percent":1.02},{"price":12.6,"change":0.29999999999999893,"sector":"Finance","ticker":"BRIT","volume":104237,"company":"Britam Holdings PLC","currency":"KES","market_cap":31165063145,"change_percent":2.44},{"price":47.5,"change":-0.45000000000000284,"sector":"Retail Trade","ticker":"TOTL","volume":26494,"company":"TotalEnergies Marketing Kenya Plc","currency":"KES","market_cap":29966233424,"change_percent":-0.94},{"price":15.4,"change":0.09999999999999964,"sector":"Utilities","ticker":"KPLC","volume":432497,"company":"Kenya Power & Lighting Company Plc","currency":"KES","market_cap":29955019824,"change_percent":0.65},{"price":369.75,"change":-10.25,"sector":"Finance","ticker":"JUB","volume":1146,"company":"Jubilee Holdings Ltd","currency":"KES","market_cap":26670046997,"change_percent":-2.7},{"price":3.45,"change":-0.029999999999999805,"sector":"Finance","ticker":"KNRE","volume":3284865,"company":"Kenya Re-Insurance Corporation Ltd.","currency":"KES","market_cap":19150606042,"change_percent":-0.86}],"description":"largest (by market cap)"},"meta":{"timestamp":"2026-06-15T02:10:30.690Z","request_id":"decf9c8e-3bf6-438e-b896-4800251a8476"},"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/search":{"get":{"operationId":"get_v1_search","tags":["Search"],"summary":"Search the market by name or ticker","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Company name or ticker fragment","schema":{"type":"string"},"example":"bank"},{"name":"sector","in":"query","required":false,"description":"Narrow to a sector","schema":{"type":"string"},"example":"Finance"},{"name":"limit","in":"query","required":false,"description":"Results 1-50","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Search the Kenyan (NSE) market by company name or ticker — matching stocks ranked by market cap. Pass q (the name or ticker fragment, e.g. bank), optionally sector (e.g. Finance, Communications) and limit (1-50, default 20).","count":4,"query":"bank","sector":"Finance","source":"Nairobi Securities Exchange / NSE Kenya (TradingView)","results":[{"price":31.8,"change":0.6999999999999993,"sector":"Finance","ticker":"COOP","volume":981116,"company":"Co-operative Bank of Kenya Ltd.","currency":"KES","market_cap":185989430306,"change_percent":2.25},{"price":28.9,"change":0.3999999999999986,"sector":"Finance","ticker":"ABSA","volume":853065,"company":"Absa Bank Kenya Plc","currency":"KES","market_cap":153169323089,"change_percent":1.4},{"price":336,"change":1,"sector":"Finance","ticker":"SCBK","volume":12309,"company":"Standard Chartered Bank Kenya Ltd","currency":"KES","market_cap":127339370422,"change_percent":0.3},{"price":142,"change":-1,"sector":"Finance","ticker":"DTK","volume":31977,"company":"Diamond Trust Bank Kenya Ltd.","currency":"KES","market_cap":39843318329,"change_percent":-0.7}]},"meta":{"timestamp":"2026-06-15T02:10:30.889Z","request_id":"0dc0d9ea-aefb-491d-bb0d-d4e03b72ab4c"},"status":"ok","message":"Search 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":{"safaricom":31.4},"source":"TradingView public screener (scanner.tradingview.com/kenya/scan), keyless","screens":["gainers","losers","active","marketcap"],"service":"nairobi-stock-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/quote":"Live quote for one or more stocks (codes).","GET /v1/search":"Search by company name or ticker (q, sector, limit).","GET /v1/screener":"Ranked market screener (by, limit)."},"description":"Live data for the Nairobi Securities Exchange (NSE Kenya, the Kenyan 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 shillings, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap), and a search across the market by company name or ticker (optionally by sector). The Kenya-equities / screener / search layer for trading dashboards and research. Distinct from other exchange readers — the Nairobi Securities Exchange market with a built-in screener and name search. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-15T02:10:31.099Z","request_id":"2c947c2a-3e36-4d62-996f-7c9c78dbc149"},"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":7500,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1190,"monthly_call_quota":185000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":5910,"monthly_call_quota":1050000,"rps_limit":20,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":8130,"monthly_call_quota":5760000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/nairobi-stock-api"}