{"openapi":"3.1.0","info":{"title":"Saudi Stock Exchange (Tadawul) API","version":"1.0.0","description":"Live data for the Saudi Stock Exchange (Tadawul, the Riyadh market) with no key: the live quote for one or more stocks by numeric ticker (price, change, open/high/low, volume, market cap, P/E, sector, in 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 Tadawul All Shares Index (TASI).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tadawul-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 Tadawul stocks","description":"","parameters":[{"name":"codes","in":"query","required":true,"description":"Numeric Tadawul ticker(s), comma-separated up to 20","schema":{"type":"string"},"example":"2222,1120"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The live quote for one or more Saudi (Tadawul) stocks — price, change, open/high/low, volume, market cap, P/E and sector (in riyals), with the company name. Pass codes (the numeric Tadawul ticker, comma-separate up to 20, e.g. 2222,1120).","count":2,"quotes":[{"low":26.5,"high":26.96,"open":26.96,"price":26.88,"change":-0.3000000000000007,"sector":"Energy Minerals","ticker":"2222","volume":12431390,"company":"Saudi Arabian Oil Co.","currency":"SAR","pe_ratio":15.77,"market_cap":6574782192884,"change_percent":-1.1},{"low":66.75,"high":67.35,"open":67.1,"price":67,"change":0.09999999999999432,"sector":"Finance","ticker":"1120","volume":5160719,"company":"Al Rajhi Bank","currency":"SAR","pe_ratio":16.67,"market_cap":401400009155,"change_percent":0.15}],"source":"Saudi Stock Exchange / Tadawul (TradingView)"},"meta":{"timestamp":"2026-06-15T02:10:42.818Z","request_id":"bb5320cc-c490-46e9-bf3d-f03c4488b64f"},"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":"active"},{"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":"active","note":"A ranked screener of the Saudi (Tadawul) 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":"Saudi Stock Exchange / Tadawul (TradingView)","results":[{"price":1.95,"change":0.020000000000000018,"sector":"Consumer Services","ticker":"6015","volume":22664549,"company":"Americana Restaurants International PLC","currency":"SAR","market_cap":16257611890,"change_percent":1.04},{"price":26.88,"change":-0.3000000000000007,"sector":"Energy Minerals","ticker":"2222","volume":12431390,"company":"Saudi Arabian Oil Co.","currency":"SAR","market_cap":6574782192884,"change_percent":-1.1},{"price":7.7,"change":-0.10999999999999943,"sector":"Non-Energy Minerals","ticker":"2200","volume":9406604,"company":"Arabian Pipes Co.","currency":"SAR","market_cap":1561999989,"change_percent":-1.41},{"price":13.5,"change":-0.9199999999999999,"sector":"Finance","ticker":"4280","volume":5516126,"company":"Kingdom Holding Co.","currency":"SAR","market_cap":53438823398,"change_percent":-6.38},{"price":5.66,"change":0.08999999999999986,"sector":"Process Industries","ticker":"2350","volume":5283005,"company":"Saudi Kayan Petrochemical Co.","currency":"SAR","market_cap":8355000257,"change_percent":1.62},{"price":67,"change":0.09999999999999432,"sector":"Finance","ticker":"1120","volume":5160719,"company":"Al Rajhi Bank","currency":"SAR","market_cap":401400009155,"change_percent":0.15},{"price":25.1,"change":0.3100000000000023,"sector":"Finance","ticker":"1150","volume":5085234,"company":"Alinma Bank","currency":"SAR","market_cap":74039471418,"change_percent":1.25},{"price":8.56,"change":0.0600000000000005,"sector":"Process Industries","ticker":"2230","volume":4728113,"company":"Saudi Chemical Co.","currency":"SAR","market_cap":7167200104,"change_percent":0.71},{"price":2.17,"change":0.009999999999999787,"sector":"Transportation","ticker":"4110","volume":3375834,"company":"Batic Investments and Logistics Co.","currency":"SAR","market_cap":1296000051,"change_percent":0.46},{"price":62.05,"change":3.049999999999997,"sector":"Non-Energy Minerals","ticker":"1211","volume":3161144,"company":"Saudi Arabian Mining Co.","currency":"SAR","market_cap":229437042236,"change_percent":5.17},{"price":2.03,"change":0.039999999999999813,"sector":"Consumer Services","ticker":"1820","volume":2996377,"company":"BAAN Holding Group Company","currency":"SAR","market_cap":626850003,"change_percent":2.01},{"price":13.61,"change":-0.33000000000000007,"sector":"Energy Minerals","ticker":"2380","volume":2975306,"company":"Rabigh Refining & Petrochemical Co. Class A","currency":"SAR","market_cap":37968794921,"change_percent":-2.37},{"price":14.93,"change":0.17999999999999972,"sector":"Consumer Services","ticker":"4250","volume":2961561,"company":"Jabal Omar Development Co.","currency":"SAR","market_cap":17405336700,"change_percent":1.22},{"price":6.26,"change":-0.20999999999999996,"sector":"Commercial Services","ticker":"1834","volume":2946130,"company":"Saudi Manpower Solutions Company","currency":"SAR","market_cap":2587999916,"change_percent":-3.25},{"price":6.93,"change":0.019999999999999574,"sector":"Consumer Services","ticker":"6018","volume":2641214,"company":"Sport Clubs Co.","currency":"SAR","market_cap":790503993,"change_percent":0.29},{"price":3.45,"change":0.13000000000000034,"sector":"Finance","ticker":"8190","volume":2478029,"company":"United Cooperative Assurance Co.","currency":"SAR","market_cap":132799996.99999999,"change_percent":3.92},{"price":35.48,"change":0.8999999999999986,"sector":"Producer Manufacturing","ticker":"2240","volume":2389648,"company":"Advanced Building Industries Co.","currency":"SAR","market_cap":2074800110.0000002,"change_percent":2.6},{"price":17.29,"change":1.3399999999999999,"sector":"Consumer Durables","ticker":"2130","volume":2003845,"company":"Saudi Industrial Development Co.","currency":"SAR","market_cap":478499994,"change_percent":8.4},{"price":6.78,"change":0.39000000000000057,"sector":"Finance","ticker":"8150","volume":1963505,"company":"Allied Cooperative Insurance Group","currency":"SAR","market_cap":185948999,"change_percent":6.1},{"price":11.75,"change":0.10999999999999943,"sector":"Finance","ticker":"1020","volume":1961564,"company":"Bank Aljazira","currency":"SAR","market_cap":14913750440,"change_percent":0.95}],"description":"most active (by volume)"},"meta":{"timestamp":"2026-06-15T02:10:43.020Z","request_id":"0a7a08f1-6a1d-48eb-9ac5-321bb386805e"},"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 Tadawul All Shares Index","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"TASI","schema":{"type":"string"},"example":"TASI"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"low":11085.62,"high":11137.49,"name":"Tadawul All Shares Index","note":"The live value of the Tadawul All Shares Index (TASI) — current level, change, and the day's open/high/low. Pass name (TASI; default TASI).","open":11090.61,"index":"TASI","value":11104.42,"change":62.399999999999636,"source":"Saudi Stock Exchange / Tadawul (TradingView)","change_percent":0.57},"meta":{"timestamp":"2026-06-15T02:10:43.225Z","request_id":"2c17782a-0fe7-452f-9d83-9bf55244dc3f"},"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":{"tasi":11104.42},"source":"TradingView public screener (scanner.tradingview.com/ksa/scan), keyless","indexes":["TASI"],"screens":["gainers","losers","active","marketcap"],"service":"tadawul-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/index":"Live value of the Tadawul All Shares 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 Saudi Stock Exchange (Tadawul, the Riyadh market) with no key: the live quote for one or more stocks by numeric ticker (price, change, open/high/low, volume, market cap, P/E, sector, in 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 Tadawul All Shares Index (TASI). The Saudi-equities / TASI-index / screener layer for trading dashboards and research. Distinct from other exchange readers — the Tadawul market with a built-in screener. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-15T02:10:43.303Z","request_id":"dbd2ed26-7065-4575-8c5b-ce5b586c25ee"},"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":12500,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":2230,"monthly_call_quota":268000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":6470,"monthly_call_quota":1455000,"rps_limit":20,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":13890,"monthly_call_quota":7750000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tadawul-api"}