Ranked market screener

Code snippets

curl "https://api.oanor.com/tadawul-api/v1/screener" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/tadawul-api/v1/screener", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/tadawul-api/v1/screener");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/tadawul-api/v1/screener",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "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",
   
…