# Oslo Børs (OSEBX) API
> Live Norwegian equity data from Oslo Børs (Euronext Oslo): real-time quotes for any listed stock by ticker (price, % change, intraday OHLC, volume, market cap in NOK), a ranking screener for gainers, losers, most-active and top market-cap local primary listings, and the Oslo index family (OSEBX, OBX and OSEAX). Foreign depositary receipts are filtered out so you get only genuine Norwegian companies such as Equinor, DNB Bank, Kongsberg Gruppen, Aker BP and Norsk Hydro.

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

## Pricing
- **Free** (Free) — 1,700 calls/Mo, 2 req/s
- **Basic** ($12/Mo) — 47,000 calls/Mo, 5 req/s
- **Pro** ($35/Mo) — 190,000 calls/Mo, 15 req/s
- **Business** ($76/Mo) — 770,000 calls/Mo, 40 req/s

## Endpoints

### Quotes

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

**Parameters:**
- `symbols` (query, required, string) — Comma-separated Oslo tickers (up to 20) Example: `EQNR,DNB,NHY`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/norway-stock-api/v1/quote?symbols=EQNR%2CDNB%2CNHY"
```

**Response:**
```json
{
    "data": {
        "count": 3,
        "market": "OSL",
        "quotes": [
            {
                "low": 332.2,
                "high": 350,
                "last": 348.4,
                "name": "Equinor ASA",
                "open": 350,
                "pe_ttm": 16.0961,
                "sector": "Energy Minerals",
                "symbol": "EQNR",
                "ticker": "OSL:EQNR",
                "volume": 5253329,
                "currency": "NOK",
                "change_abs": -16.8,
                "change_pct": -4.6002,
                "market_cap": 883162512848
            },
            {
                "low": 284.9,
                "high": 291,
                "last": 291,
                "name": "DNB Bank ASA",
                "open": 285,
                "pe_ttm": 10.415,
                "sector": "Finance",
                "symbol": "DNB",
                "ticker": "OSL:DNB",
                "volume": 1740922,
                "currency": "NOK",
                "change_abs": 7.7,
                "change_pct": 2.718,
                "market_cap": 429974026611
            },
            {
                "low": 106.25,
                "high": 112.35,
                "last": 109.8,
                "name": "Norsk Hydro ASA",
                "open": 111.65,
                "pe_ttm": 35.3123,
                "sector": "Non-Energy Minerals",
                "symbol": "NHY",
                "ticker": "OSL:NHY",
                "volume": 5327103,
       
…(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/norway-stock-api/v1/screener?sort=market_cap&order=desc&limit=25"
```

**Response:**
```json
{
    "data": {
        "sort": "market_cap",
        "count": 25,
        "order": "desc",
        "market": "OSL",
        "results": [
            {
                "low": 332.2,
                "high": 350,
                "last": 348.4,
                "name": "Equinor ASA",
                "open": 350,
                "pe_ttm": 16.0961,
                "sector": "Energy Minerals",
                "symbol": "EQNR",
                "ticker": "OSL:EQNR",
                "volume": 5253329,
                "currency": "NOK",
                "change_abs": -16.8,
                "change_pct": -4.6002,
                "market_cap": 883162512848
            },
            {
                "low": 284.9,
                "high": 291,
                "last": 291,
                "name": "DNB Bank ASA",
                "open": 285,
                "pe_ttm": 10.415,
                "sector": "Finance",
                "symbol": "DNB",
                "ticker": "OSL:DNB",
                "volume": 1740922,
                "currency": "NOK",
                "change_abs": 7.7,
                "change_pct": 2.718,
                "market_cap": 429974026611
            },
            {
                "low": 292.2,
                "high": 304.8,
                "last": 294.2,
                "name": "Kongsberg Gruppen ASA",
                "open": 304.8,
                "pe_ttm": 35.154,
                "sector": "Producer Manufacturing",
                "symbol": "KOG",
                "
…(truncated, see openapi.json for full schema)
```

### Indices

#### `GET /v1/index` — Oslo index family (OSEBX, OBX, OSEAX)

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

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

**Response:**
```json
{
    "data": {
        "count": 1,
        "market": "OSL",
        "indices": [
            {
                "low": 1971.05,
                "high": 2003.49,
                "name": "Oslo Børs Benchmark GI Index",
                "open": 2001.87,
                "index": "OSEBX",
                "value": 1995.22,
                "change_abs": -6.64,
                "change_pct": -0.3317
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:12.769Z",
        "request_id": "ec0a3972-5af0-4cc5-8dbf-ab8e8cd7ebd3"
    },
    "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/norway-stock-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "market": "Oslo Børs (Euronext Oslo)",
        "source": "TradingView screener (norway market), keyless",
        "country": "Norway",
        "indices": [
            "OSEBX",
            "OBX",
            "OSEAX"
        ],
        "currency": "NOK",
        "examples": {
            "index": "/v1/index",
            "quote": "/v1/quote?symbols=EQNR,DNB,NHY",
            "screener": "/v1/screener?sort=change&order=desc&limit=10"
        },
        "endpoints": {
            "/v1/index": "Oslo index family (OSEBX, OBX, OSEAX)",
            "/v1/quote": "live quote for one or more Oslo stocks by ticker (symbols=EQNR,DNB,NHY)",
            "/v1/screener": "rank local primary listings by market_cap | change | volume (sort, order, limit)"
        },
        "cache_ttl_ms": 20000
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:12.848Z",
        "request_id": "44d50d11-eb35-4d79-9209-98d3b5d74810"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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