# The Egyptian Exchange (EGX) API
> Live data for the Egyptian Exchange (EGX, the Cairo 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 Egyptian pounds, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap), and the live value of the EGX 30 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/egx-api/..."
```

## Pricing
- **Free** (Free) — 12,200 calls/Mo, 2 req/s
- **Basic** ($24/Mo) — 263,000 calls/Mo, 10 req/s
- **Pro** ($66/Mo) — 1,420,000 calls/Mo, 20 req/s
- **Scale** ($145/Mo) — 7,520,000 calls/Mo, 50 req/s

## Endpoints

### Quotes

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

**Parameters:**
- `codes` (query, required, string) — EGX ticker(s), comma-separated up to 20 Example: `COMI,TMGH`

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

**Response:**
```json
{
    "data": {
        "note": "The live quote for one or more Egyptian (EGX) stocks — price, change, open/high/low, volume, market cap, P/E and sector (in Egyptian pounds), with the company name. Pass codes (the EGX ticker, comma-separate up to 20, e.g. COMI,TMGH).",
        "count": 2,
        "quotes": [
            {
                "low": 131.69,
                "high": 135.7,
                "open": 131.69,
                "price": 134.76,
                "change": 3.069999999999993,
                "sector": "Finance",
                "ticker": "COMI",
                "volume": 4254137,
                "company": "Commercial International Bank - Egypt (CIB) S.A.E.",
                "currency": "EGP",
                "pe_ratio": 7.12,
                "market_cap": 444840404717,
                "change_percent": 2.33
            },
            {
                "low": 92.91,
                "high": 96.25,
                "open": 92.91,
                "price": 95.68,
                "change": 2.7700000000000102,
                "sector": "Finance",
                "ticker": "TMGH",
                "volume": 4761365,
                "company": "Talaat Moustafa Group Holding",
                "currency": "EGP",
                "pe_ratio": 14.29,
                "market_cap": 191455352903,
                "change_percent": 2.98
            }
        ],
        "source": "The Egyptian Exchange / EGX (TradingView)"
    },
    "meta": {
        "timestamp": "2026-06-15T02:1
…(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/egx-api/v1/screener?by=gainers&limit=20"
```

**Response:**
```json
{
    "data": {
        "by": "gainers",
        "note": "A ranked screener of the Egyptian (EGX) 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": "The Egyptian Exchange / EGX (TradingView)",
        "results": [
            {
                "price": 6.12,
                "change": 1.0200000000000005,
                "sector": "Finance",
                "ticker": "EASB",
                "volume": 3403297,
                "company": "Egyptian Arabian Company for Securities Brokerage EAC",
                "currency": "EGP",
                "market_cap": 509999990,
                "change_percent": 20
            },
            {
                "price": 298.21,
                "change": 49.69999999999999,
                "sector": "Process Industries",
                "ticker": "MOSC",
                "volume": 94837,
                "company": "Misr Oils & Soap Co.",
                "currency": "EGP",
                "market_cap": 1491059967,
                "change_percent": 20
            },
            {
                "price": 12,
                "change": 1.9900000000000002,
                "sector": "Process Industries",
                "ticker": "EGS30AJ1C016-EGP",
                "volume": 1815,
                "company": "International Dry Ice Co.",
                "currency"
…(truncated, see openapi.json for full schema)
```

### Indices

#### `GET /v1/index` — Live value of the EGX 30 Index

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

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

**Response:**
```json
{
    "data": {
        "low": 50818.8,
        "high": 52202.2,
        "name": "EGX 30 Index",
        "note": "The live value of the EGX 30 Index (the Egyptian Exchange benchmark) — current level, change, and the day's open/high/low. Pass name (EGX30; default EGX30).",
        "open": 52016.2,
        "index": "EGX30",
        "value": 51994.6,
        "change": 1175.7999999999956,
        "source": "The Egyptian Exchange / EGX (TradingView)",
        "change_percent": 2.31
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:39.280Z",
        "request_id": "f3e90b18-3dc7-4488-8d63-3458449e5f59"
    },
    "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/egx-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "sample": {
            "egx30": 51994.6
        },
        "source": "TradingView public screener (scanner.tradingview.com/egypt/scan), keyless",
        "indexes": [
            "EGX30"
        ],
        "screens": [
            "gainers",
            "losers",
            "active",
            "marketcap"
        ],
        "service": "egx-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/index": "Live value of the EGX 30 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 Egyptian Exchange (EGX, the Cairo 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 Egyptian pounds, with the company name), a ranked market screener (top gainers, losers, most active, or largest by market cap), and the live value of the EGX 30 Index. The Egypt-equities / EGX30-index / screener layer for trading dashboards and research. Distinct from other exchange readers — the EGX market with a built-in screener. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:39.388Z",
        "request_id": "75de90c3-3646-49cb-ab9e-72f98c3f6ca3"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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