{"openapi":"3.1.0","info":{"title":"Boursa Kuwait (Premier Market) API","version":"1.0.0","description":"Live Kuwaiti equity data from Boursa Kuwait: real-time quotes for any listed stock by ticker (price, % change, intraday OHLC, volume, market cap in KWD), a ranking screener for gainers, losers, most-active and top market-cap local primary listings, and the Boursa Kuwait Premier Market index. Foreign depositary receipts are filtered out so you get only genuine Kuwaiti companies such as Kuwait Finance House, National Bank of Kuwait, Boubyan Bank, Zain and Mabanee.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/kuwait-stock-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 Boursa Kuwait stocks","description":"","parameters":[{"name":"symbols","in":"query","required":true,"description":"Comma-separated Boursa Kuwait tickers (up to 20)","schema":{"type":"string"},"example":"KFH,NBK,ZAIN"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"market":"KSE","quotes":[{"low":781,"high":791,"last":790,"name":"Kuwait Finance House K.S.C.","open":781,"pe_ttm":23.8671,"sector":"Finance","symbol":"KFH","ticker":"KSE:KFH","volume":27306290,"currency":"KWF","change_abs":16,"change_pct":2.0672,"market_cap":15242086999},{"low":830,"high":847,"last":834,"name":"National Bank of Kuwait K.S.C.","open":841,"pe_ttm":13.9,"sector":"Finance","symbol":"NBK","ticker":"KSE:NBK","volume":14757019,"currency":"KWF","change_abs":10,"change_pct":1.2136,"market_cap":7564240345},{"low":605,"high":614,"last":611,"name":"Mobile Telecommunications Company K.S.C.P","open":605,"pe_ttm":9.7917,"sector":"Communications","symbol":"ZAIN","ticker":"KSE:ZAIN","volume":2684904,"currency":"KWF","change_abs":6,"change_pct":0.9917,"market_cap":2617870827}]},"meta":{"timestamp":"2026-06-15T02:09:52.013Z","request_id":"48f564ed-9a78-468b-878c-a1517578d8b0"},"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":"Rank local primary listings","description":"","parameters":[{"name":"sort","in":"query","required":false,"description":"Sort field: market_cap, change or volume","schema":{"type":"string"},"example":"market_cap"},{"name":"order","in":"query","required":false,"description":"asc or desc","schema":{"type":"string"},"example":"desc"},{"name":"limit","in":"query","required":false,"description":"Number of results (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sort":"market_cap","count":25,"order":"desc","market":"KSE","results":[{"low":781,"high":791,"last":790,"name":"Kuwait Finance House K.S.C.","open":781,"pe_ttm":23.8671,"sector":"Finance","symbol":"KFH","ticker":"KSE:KFH","volume":27306290,"currency":"KWF","change_abs":16,"change_pct":2.0672,"market_cap":15242086999},{"low":830,"high":847,"last":834,"name":"National Bank of Kuwait K.S.C.","open":841,"pe_ttm":13.9,"sector":"Finance","symbol":"NBK","ticker":"KSE:NBK","volume":14757019,"currency":"KWF","change_abs":10,"change_pct":1.2136,"market_cap":7564240345},{"low":653,"high":658,"last":657,"name":"Boubyan Bank K.S.C.","open":653,"pe_ttm":33.3503,"sector":"Finance","symbol":"BOUBYAN","ticker":"KSE:BOUBYAN","volume":2914338,"currency":"KWF","change_abs":7,"change_pct":1.0769,"market_cap":3067453989},{"low":605,"high":614,"last":611,"name":"Mobile Telecommunications Company K.S.C.P","open":605,"pe_ttm":9.7917,"sector":"Communications","symbol":"ZAIN","ticker":"KSE:ZAIN","volume":2684904,"currency":"KWF","change_abs":6,"change_pct":0.9917,"market_cap":2617870827},{"low":986,"high":1002,"last":994,"name":"Mabanee Company (SAKC)","open":990,"pe_ttm":22.9032,"sector":"Finance","symbol":"MABANEE","ticker":"KSE:MABANEE","volume":569081,"currency":"KWF","change_abs":14,"change_pct":1.4286,"market_cap":1535640171},{"low":346,"high":350,"last":348,"name":"Gulf Bank K.S.C.","open":346,"pe_ttm":28.0645,"sector":"Finance","symbol":"GBK","ticker":"KSE:GBK","volume":4465318,"currency":"KWF","change_abs":1,"change_pct":0.2882,"market_cap":1441874642},{"low":274,"high":282,"last":280,"name":"Warba Bank KSC","open":276,"pe_ttm":24.3478,"sector":"Finance","symbol":"WARBABANK","ticker":"KSE:WARBABANK","volume":22667413,"currency":"KWF","change_abs":7,"change_pct":2.5641,"market_cap":1289413667},{"low":2000,"high":2099,"last":2050,"name":"National Mobile Telecommunications Company K.S.C.","open":2000,"pe_ttm":12.6935,"sector":"Communications","symbol":"OOREDOO","ticker":"KSE:OOREDOO","volume":173320,"currency":"KWF","change_abs":20,"change_pct":0.9852,"market_cap":1017358386},{"low":191,"high":193,"last":192,"name":"Burgan Bank","open":191,"pe_ttm":25.2632,"sector":"Finance","symbol":"BURG","ticker":"KSE:BURG","volume":863836,"currency":"KWF","change_abs":2,"change_pct":1.0526,"market_cap":758269116},{"low":268,"high":270,"last":268,"name":"Al Ahli Bank Of Kuwait","open":268,"pe_ttm":12.4074,"sector":"Finance","symbol":"ABK","ticker":"KSE:ABK","volume":2064556,"currency":"KWF","change_abs":3,"change_pct":1.1321,"market_cap":724703212},{"low":661,"high":665,"last":662,"name":"Kuwait Telecommunications Co.","open":664,"pe_ttm":19.3003,"sector":"Communications","symbol":"STC","ticker":"KSE:STC","volume":1486358,"currency":"KWF","change_abs":1,"change_pct":0.1513,"market_cap":660162991},{"low":3040,"high":3121,"last":3121,"name":"Boursa Kuwait Securities Company (K.P.S.C)","open":3040,"pe_ttm":23.8974,"sector":"Finance","symbol":"BOURSA","ticker":"KSE:BOURSA","volume":488797,"currency":"KWF","change_abs":91,"change_pct":3.0033,"market_cap":608350537},{"low":240,"high":242,"last":240,"name":"National Industries Group (Holding) SAK","open":241,"pe_ttm":13.1868,"sector":"Finance","symbol":"NIND","ticker":"KSE:NIND","volume":6242396,"currency":"KWF","change_abs":4,"change_pct":1.6949,"market_cap":590207368},{"low":259,"high":262,"last":262,"name":"Kuwait International Bank KSC","open":260,"pe_ttm":18.4507,"sector":"Finance","symbol":"KIB","ticker":"KSE:KIB","volume":12550587,"currency":"KWF","change_abs":6,"change_pct":2.3438,"market_cap":451788740},{"low":375,"high":385,"last":380,"name":"Kuwait Real Estate Company","open":375,"pe_ttm":25,"sector":"Finance","symbol":"KRE","ticker":"KSE:KRE","volume":3992769,"currency":"KWF","change_abs":7,"change_pct":1.8767,"market_cap":444995005},{"low":206,"high":210,"last":208,"name":"Commercial Real Estate Co.","open":208,"pe_ttm":22.6087,"sector":"Miscellaneous","symbol":"ALTIJARIA","ticker":"KSE:ALTIJARIA","volume":5578319,"currency":"KWF","change_abs":3,"change_pct":1.4634,"market_cap":407495428},{"low":1894,"high":1934,"last":1905,"name":"Gulf Cables and Electrical Industries Group Co.(K.S.C.P)","open":1934,"pe_ttm":19.2424,"sector":"Producer Manufacturing","symbol":"CABLE","ticker":"KSE:CABLE","volume":333393,"currency":"KWF","change_abs":12,"change_pct":0.6339,"market_cap":395506962},{"low":78.4,"high":80.3,"last":78.4,"name":"Kuwait Projects Company Holding (K.S.C.P.)","open":79.5,"pe_ttm":56,"sector":"Finance","symbol":"KPROJ","ticker":"KSE:KPROJ","volume":5589558,"currency":"KWF","change_abs":-0.2,"change_pct":-0.2545,"market_cap":389274391},{"low":951,"high":966,"last":959,"name":"Ali Alghanim Sons Automotive Company","open":965,"pe_ttm":13.488,"sector":"Distribution Services","symbol":"ALG","ticker":"KSE:ALG","volume":1026710,"currency":"KWF","change_abs":16,"change_pct":1.6967,"market_cap":370899767},{"low":260,"high":275,"last":260,"name":"United Real Estate Company","open":270,"pe_ttm":60.4651,"sector":"Finance","symbol":"URC","ticker":"KSE:URC","volume":1944329,"currency":"KWF","change_abs":-10,"change_pct":-3.7037,"market_cap":367143852},{"low":1120,"high":1152,"last":1150,"name":"Mezzan Holding Company KSCC","open":1131,"pe_ttm":19.4257,"sector":"Consumer Non-Durables","symbol":"MEZZAN","ticker":"KSE:MEZZAN","volume":820464,"currency":"KWF","change_abs":41,"change_pct":3.697,"market_cap":355466675},{"low":668,"high":683,"last":673,"name":"Boubyan Petrochemical Co. (K.S.C.)","open":672,"pe_ttm":13.4331,"sector":"Process Industries","symbol":"BPCC","ticker":"KSE:BPCC","volume":1796518,"currency":"KWF","change_abs":5,"change_pct":0.7485,"market_cap":348326642},{"low":1624,"high":1665,"last":1631,"name":"Jazeera Airways Co. (KSC)","open":1665,"pe_ttm":22.4038,"sector":"Transportation","symbol":"JAZEERA","ticker":"KSE:JAZEERA","volume":711438,"currency":"KWF","change_abs":51,"change_pct":3.2278,"market_cap":347599983},{"low":131,"high":137,"last":134,"name":"Agility Public Warehousing Co. K.S.C.","open":133,"sector":"Transportation","symbol":"MKHZN","ticker":"KSE:MKHZN","volume":17256739,"currency":"KWF","change_abs":2,"change_pct":1.5152,"market_cap":336720751},{"low":2440,"high":2493,"last":2440,"name":"Human Soft Holding Co. KSCC","open":2493,"pe_ttm":9.5424,"sector":"Commercial Services","symbol":"HUMANSOFT","ticker":"KSE:HUMANSOFT","volume":28525,"currency":"KWF","change_abs":-15,"change_pct":-0.611,"market_cap":329420787}]},"meta":{"timestamp":"2026-06-15T02:09:52.227Z","request_id":"4328de36-d1df-427c-9077-65f512a9ab41"},"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":"Kuwait index (Boursa Kuwait Premier Market)","description":"","parameters":[{"name":"symbol","in":"query","required":false,"description":"Optional specific index symbol(s)","schema":{"type":"string"},"example":"BKP"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"market":"KSE","indices":[{"low":9281.07,"high":9339.17,"name":"Boursa Kuwait Premier Market Index","open":9281.07,"index":"BKP","value":9324.93,"change_abs":138.42,"change_pct":1.5068}]},"meta":{"timestamp":"2026-06-15T02:09:52.460Z","request_id":"548f3c4d-956d-430a-b22a-bbf63d2030cb"},"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":"Market metadata & endpoint guide","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"market":"Boursa Kuwait","source":"TradingView screener (kuwait market), keyless","country":"Kuwait","indices":["BKP","BKMAIN","BKALLSHARE"],"currency":"KWD","examples":{"index":"/v1/index","quote":"/v1/quote?symbols=KFH,NBK,ZAIN","screener":"/v1/screener?sort=change&order=desc&limit=10"},"endpoints":{"/v1/index":"Kuwait index (Boursa Kuwait Premier Market)","/v1/quote":"live quote for one or more Boursa Kuwait stocks by ticker (symbols=KFH,NBK,ZAIN)","/v1/screener":"rank local primary listings by market_cap | change | volume (sort, order, limit)"},"cache_ttl_ms":20000},"meta":{"timestamp":"2026-06-15T02:09:52.553Z","request_id":"e1b4a25a-cdb9-438c-a1a5-50a3737021ce"},"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":1650,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1240,"monthly_call_quota":46000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3630,"monthly_call_quota":191000,"rps_limit":15,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7820,"monthly_call_quota":772000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/kuwait-stock-api"}