# UAE Stock Exchanges (ADX & DFM) API
> Live data for the UAE stock markets (Abu Dhabi Securities Exchange ADX + Dubai Financial Market DFM) with no key: the live quote for one or more stocks by ticker (price, change, open/high/low, volume, market cap, P/E, sector, exchange, in dirhams, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap; filterable by exchange), and the live value of the FTSE ADX General 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/uae-stock-api/..."
```

## Pricing
- **Free** (Free) — 13,500 calls/Mo, 2 req/s
- **Basic** ($23/Mo) — 278,000 calls/Mo, 10 req/s
- **Pro** ($62/Mo) — 1,510,000 calls/Mo, 20 req/s
- **Scale** ($132/Mo) — 7,850,000 calls/Mo, 50 req/s

## Endpoints

### Quotes

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

**Parameters:**
- `codes` (query, required, string) — Ticker(s), ADX:/DFM: prefix optional, comma-separated up to 20 Example: `IHC,DFM:EMAAR`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/uae-stock-api/v1/quote?codes=IHC%2CDFM%3AEMAAR"
```

**Response:**
```json
{
    "data": {
        "note": "The live quote for one or more UAE (ADX or DFM) stocks — price, change, open/high/low, volume, market cap, P/E, sector and the exchange (in dirhams), with the company name. Pass codes (the ticker, optionally prefixed ADX:/DFM:, comma-separate up to 20, e.g. IHC,DFM:EMAAR).",
        "count": 2,
        "quotes": [
            {
                "low": 385,
                "high": 387,
                "open": 385.1,
                "price": 385,
                "change": 0,
                "sector": "Health Services",
                "ticker": "IHC",
                "volume": 567843,
                "company": "International Holding Company PJSC",
                "currency": "AED",
                "exchange": "ADX",
                "pe_ratio": 33.21,
                "market_cap": 844512915039,
                "change_percent": 0
            },
            {
                "low": 11.12,
                "high": 11.7,
                "open": 11.3,
                "price": 11.7,
                "change": 0.8999999999999986,
                "sector": "Finance",
                "ticker": "EMAAR",
                "volume": 50497509,
                "company": "Emaar Properties (P.J.S.C)",
                "currency": "AED",
                "exchange": "DFM",
                "pe_ratio": 5.48,
                "market_cap": 103413144799,
                "change_percent": 8.33
            }
        ],
        "source": "UAE Stock Exchanges / ADX + DFM (T
…(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`
- `exchange` (query, optional, string) — ADX or DFM (optional) Example: `DFM`
- `limit` (query, optional, string) — Results 1-100 Example: `20`

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

**Response:**
```json
{
    "data": {
        "by": "gainers",
        "note": "A ranked screener of the UAE market (ADX + DFM) — the top stocks by your chosen ranking. Pass by (gainers, losers, active, or marketcap; default marketcap), optionally exchange (ADX or DFM) and limit (1-100, default 20). Only real stocks above a market-cap floor are ranked.",
        "count": 20,
        "source": "UAE Stock Exchanges / ADX + DFM (TradingView)",
        "results": [
            {
                "price": 5.42,
                "change": 0.5199999999999996,
                "sector": "Finance",
                "ticker": "SUKOON",
                "volume": 97015,
                "company": "Sukoon Insurance PJSC",
                "currency": "AED",
                "exchange": "DFM",
                "market_cap": 2503346987,
                "change_percent": 10.61
            },
            {
                "price": 11.7,
                "change": 0.8999999999999986,
                "sector": "Finance",
                "ticker": "EMAAR",
                "volume": 50497509,
                "company": "Emaar Properties (P.J.S.C)",
                "currency": "AED",
                "exchange": "DFM",
                "market_cap": 103413144799,
                "change_percent": 8.33
            },
            {
                "price": 28.7,
                "change": 2.120000000000001,
                "sector": "Finance",
                "ticker": "EMIRATESNBD",
                "volume": 5850573,
           
…(truncated, see openapi.json for full schema)
```

### Indices

#### `GET /v1/index` — Live value of the FTSE ADX General Index

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

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

**Response:**
```json
{
    "data": {
        "low": 9545.51,
        "high": 9804.97,
        "name": "FTSE ADX General Index",
        "note": "The live value of the FTSE ADX General Index (the Abu Dhabi Securities Exchange benchmark) — current level, change, and the day's open/high/low. Pass name (FADGI; default FADGI).",
        "open": 9545.51,
        "index": "FADGI",
        "value": 9804.97,
        "change": 259.4599999999991,
        "source": "UAE Stock Exchanges / ADX + DFM (TradingView)",
        "change_percent": 2.72
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:40.853Z",
        "request_id": "3ab98973-1afc-4aee-a945-45232fb488af"
    },
    "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/uae-stock-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "sample": {
            "fadgi": 9804.97
        },
        "source": "TradingView public screener (scanner.tradingview.com/uae/scan), keyless",
        "indexes": [
            "FADGI"
        ],
        "screens": [
            "gainers",
            "losers",
            "active",
            "marketcap"
        ],
        "service": "uae-stock-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/index": "Live value of the FTSE ADX General Index (name).",
            "GET /v1/quote": "Live quote for one or more stocks (codes, ADX:/DFM: prefix optional).",
            "GET /v1/screener": "Ranked market screener (by, exchange, limit)."
        },
        "exchanges": [
            "ADX",
            "DFM"
        ],
        "description": "Live data for the UAE stock markets (Abu Dhabi Securities Exchange ADX + Dubai Financial Market DFM) with no key: the live quote for one or more stocks by ticker (price, change, open/high/low, volume, market cap, P/E, sector, exchange, in dirhams, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap; filterable by exchange), and the live value of the FTSE ADX General Index. The UAE-equities / ADX+DFM / screener layer for trading dashboards and research. Distinct from other exchange readers — both Emirati exchanges in one feed with a built-in screener. Live, short cache only.",
        "upstream_status": "ok"
    },
 
…(truncated, see openapi.json for full schema)
```


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