# Boursa Kuwait (Premier Market) API
> Live Kuwaiti equity data from Boursa Kuwait: real-time quotes for any listed stock by ticker (price, % change, intraday OHLC, volume, market cap in KWD), a ranking screener for gainers, losers, most-active and top market-cap local primary listings, and the Boursa Kuwait Premier Market index. Foreign depositary receipts are filtered out so you get only genuine Kuwaiti companies such as Kuwait Finance House, National Bank of Kuwait, Boubyan Bank, Zain and Mabanee.

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

## Pricing
- **Free** (Free) — 1,650 calls/Mo, 2 req/s
- **Basic** ($12/Mo) — 46,000 calls/Mo, 5 req/s
- **Pro** ($36/Mo) — 191,000 calls/Mo, 15 req/s
- **Business** ($78/Mo) — 772,000 calls/Mo, 40 req/s

## Endpoints

### Quotes

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

**Parameters:**
- `symbols` (query, required, string) — Comma-separated Boursa Kuwait tickers (up to 20) Example: `KFH,NBK,ZAIN`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/kuwait-stock-api/v1/quote?symbols=KFH%2CNBK%2CZAIN"
```

**Response:**
```json
{
    "data": {
        "count": 3,
        "market": "KSE",
        "quotes": [
            {
                "low": 781,
                "high": 791,
                "last": 790,
                "name": "Kuwait Finance House K.S.C.",
                "open": 781,
                "pe_ttm": 23.8671,
                "sector": "Finance",
                "symbol": "KFH",
                "ticker": "KSE:KFH",
                "volume": 27306290,
                "currency": "KWF",
                "change_abs": 16,
                "change_pct": 2.0672,
                "market_cap": 15242086999
            },
            {
                "low": 830,
                "high": 847,
                "last": 834,
                "name": "National Bank of Kuwait K.S.C.",
                "open": 841,
                "pe_ttm": 13.9,
                "sector": "Finance",
                "symbol": "NBK",
                "ticker": "KSE:NBK",
                "volume": 14757019,
                "currency": "KWF",
                "change_abs": 10,
                "change_pct": 1.2136,
                "market_cap": 7564240345
            },
            {
                "low": 605,
                "high": 614,
                "last": 611,
                "name": "Mobile Telecommunications Company K.S.C.P",
                "open": 605,
                "pe_ttm": 9.7917,
                "sector": "Communications",
                "symbol": "ZAIN",
                "ticker": "KSE:ZAIN",
                "vol
…(truncated, see openapi.json for full schema)
```

### Screener

#### `GET /v1/screener` — Rank local primary listings

**Parameters:**
- `sort` (query, optional, string) — Sort field: market_cap, change or volume Example: `market_cap`
- `order` (query, optional, string) — asc or desc Example: `desc`
- `limit` (query, optional, string) — Number of results (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/kuwait-stock-api/v1/screener?sort=market_cap&order=desc&limit=25"
```

**Response:**
```json
{
    "data": {
        "sort": "market_cap",
        "count": 25,
        "order": "desc",
        "market": "KSE",
        "results": [
            {
                "low": 781,
                "high": 791,
                "last": 790,
                "name": "Kuwait Finance House K.S.C.",
                "open": 781,
                "pe_ttm": 23.8671,
                "sector": "Finance",
                "symbol": "KFH",
                "ticker": "KSE:KFH",
                "volume": 27306290,
                "currency": "KWF",
                "change_abs": 16,
                "change_pct": 2.0672,
                "market_cap": 15242086999
            },
            {
                "low": 830,
                "high": 847,
                "last": 834,
                "name": "National Bank of Kuwait K.S.C.",
                "open": 841,
                "pe_ttm": 13.9,
                "sector": "Finance",
                "symbol": "NBK",
                "ticker": "KSE:NBK",
                "volume": 14757019,
                "currency": "KWF",
                "change_abs": 10,
                "change_pct": 1.2136,
                "market_cap": 7564240345
            },
            {
                "low": 653,
                "high": 658,
                "last": 657,
                "name": "Boubyan Bank K.S.C.",
                "open": 653,
                "pe_ttm": 33.3503,
                "sector": "Finance",
                "symbol": "BOUBYAN",
                "ticker": 
…(truncated, see openapi.json for full schema)
```

### Indices

#### `GET /v1/index` — Kuwait index (Boursa Kuwait Premier Market)

**Parameters:**
- `symbol` (query, optional, string) — Optional specific index symbol(s) Example: `BKP`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/kuwait-stock-api/v1/index?symbol=BKP"
```

**Response:**
```json
{
    "data": {
        "count": 1,
        "market": "KSE",
        "indices": [
            {
                "low": 9281.07,
                "high": 9339.17,
                "name": "Boursa Kuwait Premier Market Index",
                "open": 9281.07,
                "index": "BKP",
                "value": 9324.93,
                "change_abs": 138.42,
                "change_pct": 1.5068
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T02:09:52.460Z",
        "request_id": "548f3c4d-956d-430a-b22a-bbf63d2030cb"
    },
    "status": "ok",
    "message": "Index retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Market metadata & endpoint guide

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

**Response:**
```json
{
    "data": {
        "market": "Boursa Kuwait",
        "source": "TradingView screener (kuwait market), keyless",
        "country": "Kuwait",
        "indices": [
            "BKP",
            "BKMAIN",
            "BKALLSHARE"
        ],
        "currency": "KWD",
        "examples": {
            "index": "/v1/index",
            "quote": "/v1/quote?symbols=KFH,NBK,ZAIN",
            "screener": "/v1/screener?sort=change&order=desc&limit=10"
        },
        "endpoints": {
            "/v1/index": "Kuwait index (Boursa Kuwait Premier Market)",
            "/v1/quote": "live quote for one or more Boursa Kuwait stocks by ticker (symbols=KFH,NBK,ZAIN)",
            "/v1/screener": "rank local primary listings by market_cap | change | volume (sort, order, limit)"
        },
        "cache_ttl_ms": 20000
    },
    "meta": {
        "timestamp": "2026-06-15T02:09:52.553Z",
        "request_id": "e1b4a25a-cdb9-438c-a1a5-50a3737021ce"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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