Skip to content
GET /v1/screener

Ranked market screener

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/qse-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/qse-api/v1/screener" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/qse-api/v1/screener", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/qse-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/qse-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": "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.",
 
…