# Bahrain Bourse API
> Live Bahraini equity data from the Bahrain Bourse: real-time quotes for any listed stock by ticker (price, % change, intraday OHLC, volume, market cap in BHD), a ranking screener for gainers, losers, most-active and top market-cap local primary listings, and the Bahrain index family (Bahrain All Share and Bahrain Islamic). Foreign depositary receipts are filtered out so you get only genuine Bahraini companies such as Aluminium Bahrain, National Bank of Bahrain, BBK, GFH and Beyon.

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

## Pricing
- **Free** (Free) — 1,480 calls/Mo, 2 req/s
- **Basic** ($11/Mo) — 44,800 calls/Mo, 5 req/s
- **Pro** ($34/Mo) — 184,000 calls/Mo, 15 req/s
- **Business** ($73/Mo) — 756,000 calls/Mo, 40 req/s

## Endpoints

### Quotes

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

**Parameters:**
- `symbols` (query, required, string) — Comma-separated Bahrain Bourse tickers (up to 20) Example: `ALBH,NBB,BEYON`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bahrain-stock-api/v1/quote?symbols=ALBH%2CNBB%2CBEYON"
```

**Response:**
```json
{
    "data": {
        "count": 3,
        "market": "BAHRAIN",
        "quotes": [
            {
                "low": 0.91,
                "high": 0.921,
                "last": 0.921,
                "name": "Aluminium Bahrain B.S.C",
                "open": 0.91,
                "pe_ttm": 4.7255,
                "sector": "Non-Energy Minerals",
                "symbol": "ALBH",
                "ticker": "BAHRAIN:ALBH",
                "volume": 359344,
                "currency": "BHD",
                "change_abs": 0.014,
                "change_pct": 1.5436,
                "market_cap": 1273925686
            },
            {
                "low": 0.516,
                "high": 0.52,
                "last": 0.52,
                "name": "National Bank of Bahrain BSC",
                "open": 0.516,
                "pe_ttm": 15.1163,
                "sector": "Finance",
                "symbol": "NBB",
                "ticker": "BAHRAIN:NBB",
                "volume": 1485230,
                "currency": "BHD",
                "change_abs": 0.004,
                "change_pct": 0.7752,
                "market_cap": 1160693917
            },
            {
                "low": 0.462,
                "high": 0.462,
                "last": 0.462,
                "name": "Beyon B.S.C",
                "open": 0.462,
                "pe_ttm": 11.1325,
                "sector": "Communications",
                "symbol": "BEYON",
                "ticker": "BAHRAIN:BEYON",
…(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/bahrain-stock-api/v1/screener?sort=market_cap&order=desc&limit=25"
```

**Response:**
```json
{
    "data": {
        "sort": "market_cap",
        "count": 23,
        "order": "desc",
        "market": "BAHRAIN",
        "results": [
            {
                "low": 0.91,
                "high": 0.921,
                "last": 0.921,
                "name": "Aluminium Bahrain B.S.C",
                "open": 0.91,
                "pe_ttm": 4.7255,
                "sector": "Non-Energy Minerals",
                "symbol": "ALBH",
                "ticker": "BAHRAIN:ALBH",
                "volume": 359344,
                "currency": "BHD",
                "change_abs": 0.014,
                "change_pct": 1.5436,
                "market_cap": 1273925686
            },
            {
                "low": 0.516,
                "high": 0.52,
                "last": 0.52,
                "name": "National Bank of Bahrain BSC",
                "open": 0.516,
                "pe_ttm": 15.1163,
                "sector": "Finance",
                "symbol": "NBB",
                "ticker": "BAHRAIN:NBB",
                "volume": 1485230,
                "currency": "BHD",
                "change_abs": 0.004,
                "change_pct": 0.7752,
                "market_cap": 1160693917
            },
            {
                "low": 0.568,
                "high": 0.568,
                "last": 0.568,
                "name": "Bank of Bahrain and Kuwait B.S.C.",
                "open": 0.568,
                "pe_ttm": 12.0594,
                "sector": "Finance",
     
…(truncated, see openapi.json for full schema)
```

### Indices

#### `GET /v1/index` — Bahrain index family (Bahrain All Share, Bahrain Islamic)

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

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

**Response:**
```json
{
    "data": {
        "count": 1,
        "market": "BAHRAIN",
        "indices": [
            {
                "low": 1992.979,
                "high": 2000.23,
                "name": "Bahrain All Share Index",
                "open": 1992.979,
                "index": "BHBX",
                "label": "Bahrain All Share",
                "value": 2000.23,
                "change_abs": 8.348,
                "change_pct": 0.4191
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T11:16:11.524Z",
        "request_id": "93568e79-32c6-46ec-9b9c-80a3cfd6e04d"
    },
    "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/bahrain-stock-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "market": "Bahrain Bourse",
        "source": "TradingView screener (bahrain market), keyless",
        "country": "Bahrain",
        "indices": [
            "BHBX",
            "BIX"
        ],
        "currency": "BHD",
        "examples": {
            "index": "/v1/index",
            "quote": "/v1/quote?symbols=ALBH,NBB,BEYON",
            "screener": "/v1/screener?sort=change&order=desc&limit=10"
        },
        "endpoints": {
            "/v1/index": "Bahrain index family (Bahrain All Share = BHBX, Bahrain Islamic = BIX)",
            "/v1/quote": "live quote for one or more Bahrain Bourse stocks by ticker (symbols=ALBH,NBB,BEYON)",
            "/v1/screener": "rank local primary listings by market_cap | change | volume (sort, order, limit)"
        },
        "cache_ttl_ms": 20000
    },
    "meta": {
        "timestamp": "2026-06-15T11:16:11.600Z",
        "request_id": "9a6e5395-7108-4002-add7-201771d53ea1"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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