# Saudi Stock Exchange (Tadawul) API > 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). ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/tadawul-api/..." ``` ## Pricing - **Free** (Free) — 12,500 calls/Mo, 2 req/s - **Basic** ($22/Mo) — 268,000 calls/Mo, 10 req/s - **Pro** ($65/Mo) — 1,455,000 calls/Mo, 20 req/s - **Scale** ($139/Mo) — 7,750,000 calls/Mo, 50 req/s ## Endpoints ### Quotes #### `GET /v1/quote` — Live quote for one or more Tadawul stocks **Parameters:** - `codes` (query, required, string) — Numeric Tadawul ticker(s), comma-separated up to 20 Example: `2222,1120` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tadawul-api/v1/quote?codes=2222%2C1120" ``` **Response:** ```json { "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" …(truncated, see openapi.json for full schema) ``` ### Screener #### `GET /v1/screener` — Ranked market screener **Parameters:** - `by` (query, optional, string) — Ranking: gainers, losers, active, marketcap Example: `active` - `limit` (query, optional, string) — Results 1-100 Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tadawul-api/v1/screener?by=active&limit=20" ``` **Response:** ```json { "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" …(truncated, see openapi.json for full schema) ``` ### Indices #### `GET /v1/index` — Live value of the Tadawul All Shares Index **Parameters:** - `name` (query, optional, string) — TASI Example: `TASI` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tadawul-api/v1/index?name=TASI" ``` **Response:** ```json { "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 } ``` ### Meta #### `GET /v1/meta` — Service metadata & endpoint catalog **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tadawul-api/v1/meta" ``` **Response:** ```json { "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" …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/tadawul-api OpenAPI spec: https://www.oanor.com/api/tadawul-api/openapi.json