# Nasdaq Iceland (OMXI15) API
> Live Icelandic equity data from Nasdaq Iceland (OMX Iceland): real-time quotes for any listed stock by ticker (price, % change, intraday OHLC, volume, market cap in ISK), a ranking screener for gainers, losers, most-active and top market-cap local primary listings, and the Iceland index family (OMX Iceland 15 and OMX Iceland All-Share). Foreign depositary receipts are filtered out so you get only genuine Icelandic companies such as Islandsbanki, Arion Banki, Sildarvinnslan, Brim and Hagar.

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

## Pricing
- **Free** (Free) — 1,500 calls/Mo, 2 req/s
- **Basic** ($11/Mo) — 45,200 calls/Mo, 5 req/s
- **Pro** ($34/Mo) — 187,000 calls/Mo, 15 req/s
- **Business** ($73/Mo) — 759,000 calls/Mo, 40 req/s

## Endpoints

### Quotes

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

**Parameters:**
- `symbols` (query, required, string) — Comma-separated Iceland tickers (up to 20) Example: `ISB,ARION,HAGA`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/iceland-stock-api/v1/quote?symbols=ISB%2CARION%2CHAGA"
```

**Response:**
```json
{
    "data": {
        "count": 3,
        "market": "OMXICE",
        "quotes": [
            {
                "low": 141,
                "high": 142.8,
                "last": 142,
                "name": "Islandsbanki hf",
                "open": 141,
                "pe_ttm": 9.3974,
                "sector": "Finance",
                "symbol": "ISB",
                "ticker": "OMXICE:ISB",
                "volume": 1110625,
                "currency": "ISK",
                "change_abs": 1,
                "change_pct": 0.7092,
                "market_cap": 247197733521
            },
            {
                "low": 192,
                "high": 193,
                "last": 192,
                "name": "Arion Banki hf",
                "open": 192.5,
                "pe_ttm": 8.6855,
                "sector": "Finance",
                "symbol": "ARION",
                "ticker": "OMXICE:ARION",
                "volume": 490207,
                "currency": "ISK",
                "change_abs": 1.5,
                "change_pct": 0.7874,
                "market_cap": 243649500000
            },
            {
                "low": 122,
                "high": 124,
                "last": 123,
                "name": "Hagar hf.",
                "open": 122,
                "pe_ttm": 20.7078,
                "sector": "Retail Trade",
                "symbol": "HAGA",
                "ticker": "OMXICE:HAGA",
                "volume": 360000,
                "currency"
…(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/iceland-stock-api/v1/screener?sort=market_cap&order=desc&limit=25"
```

**Response:**
```json
{
    "data": {
        "sort": "market_cap",
        "count": 24,
        "order": "desc",
        "market": "OMXICE",
        "results": [
            {
                "low": 141,
                "high": 142.8,
                "last": 142,
                "name": "Islandsbanki hf",
                "open": 141,
                "pe_ttm": 9.3974,
                "sector": "Finance",
                "symbol": "ISB",
                "ticker": "OMXICE:ISB",
                "volume": 1110625,
                "currency": "ISK",
                "change_abs": 1,
                "change_pct": 0.7092,
                "market_cap": 247197733521
            },
            {
                "low": 192,
                "high": 193,
                "last": 192,
                "name": "Arion Banki hf",
                "open": 192.5,
                "pe_ttm": 8.6855,
                "sector": "Finance",
                "symbol": "ARION",
                "ticker": "OMXICE:ARION",
                "volume": 490207,
                "currency": "ISK",
                "change_abs": 1.5,
                "change_pct": 0.7874,
                "market_cap": 243649500000
            },
            {
                "low": 119,
                "high": 119,
                "last": 119,
                "name": "Sildarvinnslan hf.",
                "open": 119,
                "pe_ttm": 18.2756,
                "sector": "Consumer Non-Durables",
                "symbol": "SVN",
                "ticker": "
…(truncated, see openapi.json for full schema)
```

### Indices

#### `GET /v1/index` — Iceland index family (OMX Iceland 15, OMX Iceland All-Share)

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

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

**Response:**
```json
{
    "data": {
        "count": 1,
        "market": "OMXICE",
        "indices": [
            {
                "low": 2584.1767,
                "high": 2616.875,
                "name": "OMX Iceland 15 Index",
                "open": 2584.1767,
                "index": "OMXI15",
                "label": "OMX Iceland 15",
                "value": 2610.8602,
                "change_abs": 26.6835,
                "change_pct": 1.0326
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T11:16:09.627Z",
        "request_id": "553c6ac4-02bf-4a45-9bb4-7316e5907be2"
    },
    "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/iceland-stock-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "market": "Nasdaq Iceland (OMX Iceland)",
        "source": "TradingView screener (iceland market), keyless",
        "country": "Iceland",
        "indices": [
            "OMXI15",
            "OMXIPI"
        ],
        "currency": "ISK",
        "examples": {
            "index": "/v1/index",
            "quote": "/v1/quote?symbols=ISB,ARION,HAGA",
            "screener": "/v1/screener?sort=change&order=desc&limit=10"
        },
        "endpoints": {
            "/v1/index": "Iceland index family (OMX Iceland 15 = OMXI15, OMX Iceland All-Share = OMXIPI)",
            "/v1/quote": "live quote for one or more Iceland stocks by ticker (symbols=ISB,ARION,HAGA)",
            "/v1/screener": "rank local primary listings by market_cap | change | volume (sort, order, limit)"
        },
        "cache_ttl_ms": 20000
    },
    "meta": {
        "timestamp": "2026-06-15T11:16:09.725Z",
        "request_id": "fb70ad7c-3458-4bbe-ac08-f32167f768b5"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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