# Qatar Stock Exchange (QSE) API
> 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.

## 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/qse-api/..."
```

## Pricing
- **Free** (Free) — 8,900 calls/Mo, 2 req/s
- **Basic** ($27/Mo) — 213,000 calls/Mo, 10 req/s
- **Pro** ($72/Mo) — 1,210,000 calls/Mo, 20 req/s
- **Scale** ($143/Mo) — 6,520,000 calls/Mo, 50 req/s

## Endpoints

### Quotes

#### `GET /v1/quote` — Live quote for one or more QSE stocks

**Parameters:**
- `codes` (query, required, string) — QSE ticker(s), comma-separated up to 20 Example: `QNBK,IQCD`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/qse-api/v1/quote?codes=QNBK%2CIQCD"
```

**Response:**
```json
{
    "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_i
…(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: `gainers`
- `limit` (query, optional, string) — Results 1-100 Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/qse-api/v1/screener?by=gainers&limit=20"
```

**Response:**
```json
{
    "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": 15701928808
…(truncated, see openapi.json for full schema)
```

### Indices

#### `GET /v1/index` — Live value of the QE All-Share Index

**Parameters:**
- `name` (query, optional, string) — QEAS Example: `QEAS`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/qse-api/v1/index?name=QEAS"
```

**Response:**
```json
{
    "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
}
```

### Meta

#### `GET /v1/meta` — Service metadata & endpoint catalog

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/qse-api/v1/meta"
```

**Response:**
```json
{
    "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
}
```


---
Marketplace page: https://www.oanor.com/api/qse-api
OpenAPI spec: https://www.oanor.com/api/qse-api/openapi.json
