# Nasdaq Tallinn (OMX Tallinn) API
> Live Estonian equity data from Nasdaq Tallinn (OMX Tallinn): real-time quotes for any listed stock by ticker (price, % change, intraday OHLC, volume, market cap in EUR), a ranking screener for gainers, losers, most-active and top market-cap local primary listings, and the OMX Tallinn Gross index. Foreign depositary receipts are filtered out so you get only genuine Estonian companies such as LHV Group, Infortar, Merko Ehitus, Tallink Grupp and TKM Grupp.

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

## Pricing
- **Free** (Free) — 1,420 calls/Mo, 2 req/s
- **Basic** ($12/Mo) — 43,500 calls/Mo, 5 req/s
- **Pro** ($36/Mo) — 182,000 calls/Mo, 15 req/s
- **Business** ($75/Mo) — 757,000 calls/Mo, 40 req/s

## Endpoints

### Quotes

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

**Parameters:**
- `symbols` (query, required, string) — Comma-separated Tallinn tickers (up to 20) Example: `LHV1T,TAL1T,MRK1T`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/estonia-stock-api/v1/quote?symbols=LHV1T%2CTAL1T%2CMRK1T"
```

**Response:**
```json
{
    "data": {
        "count": 3,
        "market": "OMXTSE",
        "quotes": [
            {
                "low": 3.39,
                "high": 3.405,
                "last": 3.39,
                "name": "LHV Group AS",
                "open": 3.4,
                "pe_ttm": 10.7143,
                "sector": "Finance",
                "symbol": "LHV1T",
                "ticker": "OMXTSE:LHV1T",
                "volume": 67360,
                "currency": "EUR",
                "change_abs": -0.01,
                "change_pct": -0.2941,
                "market_cap": 1114711011
            },
            {
                "low": 0.653,
                "high": 0.656,
                "last": 0.655,
                "name": "Tallink Grupp AS",
                "open": 0.654,
                "pe_ttm": 17.2823,
                "sector": "Transportation",
                "symbol": "TAL1T",
                "ticker": "OMXTSE:TAL1T",
                "volume": 225132,
                "currency": "EUR",
                "change_abs": 0.001,
                "change_pct": 0.1529,
                "market_cap": 486294174
            },
            {
                "low": 27.45,
                "high": 27.65,
                "last": 27.45,
                "name": "Merko Ehitus AS",
                "open": 27.5,
                "pe_ttm": 14.374,
                "sector": "Industrial Services",
                "symbol": "MRK1T",
                "ticker": "OMXTSE:MRK1T",
                "vo
…(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/estonia-stock-api/v1/screener?sort=market_cap&order=desc&limit=25"
```

**Response:**
```json
{
    "data": {
        "sort": "market_cap",
        "count": 25,
        "order": "desc",
        "market": "OMXTSE",
        "results": [
            {
                "low": 3.39,
                "high": 3.405,
                "last": 3.39,
                "name": "LHV Group AS",
                "open": 3.4,
                "pe_ttm": 10.7143,
                "sector": "Finance",
                "symbol": "LHV1T",
                "ticker": "OMXTSE:LHV1T",
                "volume": 67360,
                "currency": "EUR",
                "change_abs": -0.01,
                "change_pct": -0.2941,
                "market_cap": 1114711011
            },
            {
                "low": 48.8,
                "high": 49.1,
                "last": 49,
                "name": "Infortar AS",
                "open": 49,
                "pe_ttm": 11.275,
                "sector": "Finance",
                "symbol": "INF1T",
                "ticker": "OMXTSE:INF1T",
                "volume": 1147,
                "currency": "EUR",
                "change_abs": 0,
                "change_pct": 0,
                "market_cap": 990840715
            },
            {
                "low": 27.45,
                "high": 27.65,
                "last": 27.45,
                "name": "Merko Ehitus AS",
                "open": 27.5,
                "pe_ttm": 14.374,
                "sector": "Industrial Services",
                "symbol": "MRK1T",
                "ticker": "OMXTSE:MR
…(truncated, see openapi.json for full schema)
```

### Indices

#### `GET /v1/index` — Tallinn index (OMX Tallinn Gross)

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

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

**Response:**
```json
{
    "data": {
        "count": 1,
        "market": "OMXTSE",
        "indices": [
            {
                "low": 2100.2292,
                "high": 2105.5871,
                "name": "OMX Tallinn Gross Index",
                "open": 2104.4151,
                "index": "OMXTGI",
                "label": "OMX Tallinn Gross",
                "value": 2101.9557,
                "change_abs": -1.8631,
                "change_pct": -0.0886
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T11:16:08.881Z",
        "request_id": "dded981c-5985-45cc-897c-9adc4e0456c2"
    },
    "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/estonia-stock-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "market": "Nasdaq Tallinn (OMX Tallinn)",
        "source": "TradingView screener (estonia market), keyless",
        "country": "Estonia",
        "indices": [
            "OMXTGI",
            "OMXT"
        ],
        "currency": "EUR",
        "examples": {
            "index": "/v1/index",
            "quote": "/v1/quote?symbols=LHV1T,TAL1T,MRK1T",
            "screener": "/v1/screener?sort=change&order=desc&limit=10"
        },
        "endpoints": {
            "/v1/index": "Tallinn index (OMX Tallinn Gross = OMXTGI)",
            "/v1/quote": "live quote for one or more Tallinn stocks by ticker (symbols=LHV1T,TAL1T,MRK1T)",
            "/v1/screener": "rank local primary listings by market_cap | change | volume (sort, order, limit)"
        },
        "cache_ttl_ms": 20000
    },
    "meta": {
        "timestamp": "2026-06-15T11:16:08.952Z",
        "request_id": "a07cb5d6-b637-4cc2-918e-e88d43a16f00"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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