# Nasdaq Helsinki (OMXH25) API
> Live Finnish equity data from Nasdaq Helsinki (OMX Helsinki): 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 Helsinki index family (OMXH25 and OMXHPI). Foreign depositary receipts are filtered out so you get only genuine Finnish companies such as Nokia, Nordea, KONE, Sampo and Neste.

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

## Pricing
- **Free** (Free) — 1,900 calls/Mo, 2 req/s
- **Basic** ($12/Mo) — 49,000 calls/Mo, 5 req/s
- **Pro** ($36/Mo) — 196,000 calls/Mo, 15 req/s
- **Business** ($78/Mo) — 780,000 calls/Mo, 40 req/s

## Endpoints

### Quotes

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

**Parameters:**
- `symbols` (query, required, string) — Comma-separated Helsinki tickers (up to 20) Example: `NOKIA,NDA_FI,KNEBV`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/finland-stock-api/v1/quote?symbols=NOKIA%2CNDA_FI%2CKNEBV"
```

**Response:**
```json
{
    "data": {
        "count": 3,
        "market": "OMXHEX",
        "quotes": [
            {
                "low": 12.125,
                "high": 12.965,
                "last": 12.965,
                "name": "Nokia Oyj",
                "open": 12.45,
                "pe_ttm": 93.9493,
                "sector": "Electronic Technology",
                "symbol": "NOKIA",
                "ticker": "OMXHEX:NOKIA",
                "volume": 22167109,
                "currency": "EUR",
                "change_abs": 1.185,
                "change_pct": 10.0594,
                "market_cap": 72364331938
            },
            {
                "low": 16.09,
                "high": 16.365,
                "last": 16.35,
                "name": "Nordea Bank Abp",
                "open": 16.09,
                "pe_ttm": 11.9561,
                "sector": "Finance",
                "symbol": "NDA_FI",
                "ticker": "OMXHEX:NDA_FI",
                "volume": 5448925,
                "currency": "EUR",
                "change_abs": 0.5,
                "change_pct": 3.1546,
                "market_cap": 55467376294
            },
            {
                "low": 48.34,
                "high": 49.55,
                "last": 48.72,
                "name": "KONE Oyj Class B",
                "open": 49.14,
                "pe_ttm": 25.7655,
                "sector": "Producer Manufacturing",
                "symbol": "KNEBV",
                "ticker": "OMXHEX:KNE
…(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/finland-stock-api/v1/screener?sort=market_cap&order=desc&limit=25"
```

**Response:**
```json
{
    "data": {
        "sort": "market_cap",
        "count": 25,
        "order": "desc",
        "market": "OMXHEX",
        "results": [
            {
                "low": 12.125,
                "high": 12.965,
                "last": 12.965,
                "name": "Nokia Oyj",
                "open": 12.45,
                "pe_ttm": 93.9493,
                "sector": "Electronic Technology",
                "symbol": "NOKIA",
                "ticker": "OMXHEX:NOKIA",
                "volume": 22167109,
                "currency": "EUR",
                "change_abs": 1.185,
                "change_pct": 10.0594,
                "market_cap": 72364331938
            },
            {
                "low": 16.09,
                "high": 16.365,
                "last": 16.35,
                "name": "Nordea Bank Abp",
                "open": 16.09,
                "pe_ttm": 11.9561,
                "sector": "Finance",
                "symbol": "NDA_FI",
                "ticker": "OMXHEX:NDA_FI",
                "volume": 5448925,
                "currency": "EUR",
                "change_abs": 0.5,
                "change_pct": 3.1546,
                "market_cap": 55467376294
            },
            {
                "low": 48.34,
                "high": 49.55,
                "last": 48.72,
                "name": "KONE Oyj Class B",
                "open": 49.14,
                "pe_ttm": 25.7655,
                "sector": "Producer Manufacturing",
               
…(truncated, see openapi.json for full schema)
```

### Indices

#### `GET /v1/index` — Helsinki index family (OMXH25, OMXHPI)

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

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

**Response:**
```json
{
    "data": {
        "count": 1,
        "market": "OMXHEX",
        "indices": [
            {
                "low": 6278.2953,
                "high": 6350.9807,
                "name": "OMX Helsinki 25 Index",
                "open": 6347.49,
                "index": "OMXH25",
                "value": 6339.0473,
                "change_abs": 95.4301,
                "change_pct": 1.5284
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:07.880Z",
        "request_id": "6d4e1d9c-208b-4095-8d1f-41b50e94aebe"
    },
    "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/finland-stock-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "market": "Nasdaq Helsinki (OMX Helsinki)",
        "source": "TradingView screener (finland market), keyless",
        "country": "Finland",
        "indices": [
            "OMXH25",
            "OMXHPI",
            "OMXHGI"
        ],
        "currency": "EUR",
        "examples": {
            "index": "/v1/index",
            "quote": "/v1/quote?symbols=NOKIA,NDA_FI,KNEBV",
            "screener": "/v1/screener?sort=change&order=desc&limit=10"
        },
        "endpoints": {
            "/v1/index": "Helsinki index family (OMXH25, OMXHPI)",
            "/v1/quote": "live quote for one or more Helsinki stocks by ticker (symbols=NOKIA,NDA_FI,KNEBV)",
            "/v1/screener": "rank local primary listings by market_cap | change | volume (sort, order, limit)"
        },
        "cache_ttl_ms": 20000
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:07.959Z",
        "request_id": "20eeab29-e205-417f-8223-6a01a43bee4d"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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