{"openapi":"3.1.0","info":{"title":"Qatar Stock Exchange (QSE) API","version":"1.0.0","description":"Live data for the Qatar Stock Exchange (QSE, the Doha 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 Qatari riyals, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap), and the live value of the QE All-Share Index.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/qse-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 QSE stocks","description":"","parameters":[{"name":"codes","in":"query","required":true,"description":"QSE ticker(s), comma-separated up to 20","schema":{"type":"string"},"example":"QNBK,IQCD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The live quote for one or more Qatari (QSE) stocks — price, change, open/high/low, volume, market cap, P/E and sector (in Qatari riyals), with the company name. Pass codes (the QSE ticker, comma-separate up to 20, e.g. QNBK,IQCD).","count":2,"quotes":[{"low":17.4,"high":17.64,"open":17.4,"price":17.64,"change":0.6400000000000006,"sector":"Finance","ticker":"QNBK","volume":1540368,"company":"Qatar National Bank QPSC","currency":"QAR","pe_ratio":10.09,"market_cap":157019288086,"change_percent":3.76},{"low":11.85,"high":12.3,"open":12.3,"price":11.88,"change":0.02000000000000135,"sector":"Non-Energy Minerals","ticker":"IQCD","volume":2125499,"company":"Industries of Qatar Co.","currency":"QAR","pe_ratio":17.78,"market_cap":71752997923,"change_percent":0.17}],"source":"Qatar Stock Exchange / QSE (TradingView)"},"meta":{"timestamp":"2026-06-15T02:10:35.276Z","request_id":"83fc2836-a8e9-4e4f-9d6f-e489ecccd31e"},"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":"gainers"},{"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":"gainers","note":"A ranked screener of the Qatari (QSE) 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":"Qatar Stock Exchange / QSE (TradingView)","results":[{"price":4.336,"change":0.19600000000000062,"sector":"Transportation","ticker":"QGTS","volume":3168825,"company":"Qatar Gas Transport Co.","currency":"QAR","market_cap":22936690862,"change_percent":4.73},{"price":2.22,"change":0.0860000000000003,"sector":"Finance","ticker":"QFBQ","volume":8823686,"company":"Lesha Bank L.L.C","currency":"QAR","market_cap":2390080070,"change_percent":4.03},{"price":17.64,"change":0.6400000000000006,"sector":"Finance","ticker":"QNBK","volume":1540368,"company":"Qatar National Bank QPSC","currency":"QAR","market_cap":157019288086,"change_percent":3.76},{"price":22.04,"change":0.7399999999999984,"sector":"Finance","ticker":"QIBK","volume":1294425,"company":"Qatar Islamic Bank","currency":"QAR","market_cap":50330447343,"change_percent":3.47},{"price":5.257,"change":0.15700000000000003,"sector":"Technology Services","ticker":"MCCS","volume":285521,"company":"Mannai Corporation Q.P.S.C.","currency":"QAR","market_cap":2326579086,"change_percent":3.08},{"price":2.979,"change":0.08400000000000007,"sector":"Finance","ticker":"IHGS","volume":931963,"company":"Inma Holding Company","currency":"QAR","market_cap":163960660,"change_percent":2.9},{"price":1.192,"change":0.028999999999999915,"sector":"Process Industries","ticker":"MPHC","volume":16087803,"company":"Mesaieed Petrochemical Holding Company Q.S.C.","currency":"QAR","market_cap":14610972142,"change_percent":2.49},{"price":0.753,"change":0.018000000000000016,"sector":"Distribution Services","ticker":"AHCS","volume":2142446,"company":"Aamal Company Q.S.C.","currency":"QAR","market_cap":4630500449,"change_percent":2.45},{"price":2.86,"change":0.06499999999999995,"sector":"Finance","ticker":"DHBK","volume":3653918,"company":"Doha Bank","currency":"QAR","market_cap":8665805616,"change_percent":2.33},{"price":0.593,"change":0.01200000000000001,"sector":"Commercial Services","ticker":"FALH","volume":1673519,"company":"Al Faleh Educational Holding Co.","currency":"QAR","market_cap":139439993,"change_percent":2.07},{"price":0.673,"change":0.013000000000000012,"sector":"Finance","ticker":"NLCS","volume":1453662,"company":"Alijarah Holding","currency":"QAR","market_cap":326569334,"change_percent":1.97},{"price":4.25,"change":0.08000000000000007,"sector":"Finance","ticker":"CBQK","volume":1892063,"company":"Commercial Bank (Q.S.C.)","currency":"QAR","market_cap":16877048080,"change_percent":1.92},{"price":0.798,"change":0.015000000000000013,"sector":"Retail Trade","ticker":"SIIS","volume":1168429,"company":"Salam International Investment Ltd.","currency":"QAR","market_cap":895083211,"change_percent":1.92},{"price":2.917,"change":0.053999999999999826,"sector":"Finance","ticker":"DOHI","volume":1303356,"company":"Doha Insurance Co.","currency":"QAR","market_cap":1431499958,"change_percent":1.89},{"price":4.37,"change":0.07899999999999974,"sector":"Finance","ticker":"IGRD","volume":2029250,"company":"Estithmar Holding Q.P.S.C","currency":"QAR","market_cap":19280876773,"change_percent":1.84},{"price":14.02,"change":0.2400000000000002,"sector":"Energy Minerals","ticker":"QFLS","volume":720013,"company":"Qatar Fuel-Woqod QSC","currency":"QAR","market_cap":13700843795,"change_percent":1.74},{"price":2.141,"change":0.03600000000000003,"sector":"Energy Minerals","ticker":"GISS","volume":4457196,"company":"Gulf International Services QSC","currency":"QAR","market_cap":3911950331,"change_percent":1.71},{"price":2.409,"change":0.03999999999999959,"sector":"Finance","ticker":"BRES","volume":3294916,"company":"Barwa Real Estate Co.","currency":"QAR","market_cap":9218362411,"change_percent":1.69},{"price":0.869,"change":0.014000000000000012,"sector":"Finance","ticker":"ERES","volume":8009042,"company":"Ezdan Holding Group","currency":"QAR","market_cap":22678847117,"change_percent":1.64},{"price":1.58,"change":0.025000000000000133,"sector":"Finance","ticker":"QGRI","volume":134748,"company":"Qatar General Insurance & Reinsurance Company Q.P.S.C.","currency":"QAR","market_cap":1360729269,"change_percent":1.61}],"description":"top gainers (by % change)"},"meta":{"timestamp":"2026-06-15T02:10:35.486Z","request_id":"a7721d59-b9d0-4aa1-a256-046e413cf1b5"},"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 QE All-Share Index","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"QEAS","schema":{"type":"string"},"example":"QEAS"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"low":4008.52,"high":4108.95,"name":"QE All Share Index","note":"The live value of the QE All-Share Index (the Qatar Stock Exchange benchmark) — current level, change, and the day's open/high/low. Pass name (QEAS; default QEAS).","open":4008.52,"index":"QEAS","value":4087.37,"change":78.84999999999991,"source":"Qatar Stock Exchange / QSE (TradingView)","change_percent":1.97},"meta":{"timestamp":"2026-06-15T02:10:35.695Z","request_id":"3c73ffbf-d7cb-4b39-8438-b4199871674b"},"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":{"qe_all_share":4087.37},"source":"TradingView public screener (scanner.tradingview.com/qatar/scan), keyless","indexes":["QEAS"],"screens":["gainers","losers","active","marketcap"],"service":"qse-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/index":"Live value of the QE 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 Qatar Stock Exchange (QSE, the Doha 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 Qatari riyals, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap), and the live value of the QE All-Share Index. The Qatar-equities / QE-index / screener layer for trading dashboards and research. Distinct from other exchange readers — the QSE market with a built-in screener. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-15T02:10:35.783Z","request_id":"5d9ea367-0b91-418f-a4ad-4438d25a1a75"},"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":8900,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":2710,"monthly_call_quota":213000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":7180,"monthly_call_quota":1210000,"rps_limit":20,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":14330,"monthly_call_quota":6520000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/qse-api"}