# Euronext Amsterdam (AEX) API
> Live Dutch equity data from Euronext Amsterdam: 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 Amsterdam index family (AEX, AMX and AScX). Foreign depositary receipts are filtered out so you get only genuine Dutch companies such as ASML, Prosus, ING Groep, ASM International and ArcelorMittal.

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

## Pricing
- **Free** (Free) — 1,900 calls/Mo, 2 req/s
- **Basic** ($13/Mo) — 50,000 calls/Mo, 5 req/s
- **Pro** ($37/Mo) — 200,000 calls/Mo, 15 req/s
- **Business** ($81/Mo) — 800,000 calls/Mo, 40 req/s

## Endpoints

### Quotes

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

**Parameters:**
- `symbols` (query, required, string) — Comma-separated Amsterdam tickers (up to 20) Example: `ASML,INGA,MT`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/netherlands-stock-api/v1/quote?symbols=ASML%2CINGA%2CMT"
```

**Response:**
```json
{
    "data": {
        "count": 3,
        "market": "AMS",
        "quotes": [
            {
                "low": 1574.2,
                "high": 1629.6,
                "last": 1629.6,
                "name": "ASML Holding NV",
                "open": 1612,
                "pe_ttm": 63.0097,
                "sector": "Electronic Technology",
                "symbol": "ASML",
                "ticker": "EURONEXT:ASML",
                "volume": 1014928,
                "currency": "EUR",
                "change_abs": 53.6,
                "change_pct": 3.401,
                "market_cap": 622482424414
            },
            {
                "low": 25.405,
                "high": 26.06,
                "last": 25.96,
                "name": "ING Groep N.V.",
                "open": 25.575,
                "pe_ttm": 11.8979,
                "sector": "Finance",
                "symbol": "INGA",
                "ticker": "EURONEXT:INGA",
                "volume": 9606975,
                "currency": "EUR",
                "change_abs": 0.89,
                "change_pct": 3.5501,
                "market_cap": 73590094729
            },
            {
                "low": 57.92,
                "high": 60.66,
                "last": 60.6,
                "name": "ArcelorMittal SA",
                "open": 59,
                "pe_ttm": 16.2842,
                "sector": "Non-Energy Minerals",
                "symbol": "MT",
                "ticker": "EURONEXT:MT",
        
…(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/netherlands-stock-api/v1/screener?sort=market_cap&order=desc&limit=25"
```

**Response:**
```json
{
    "data": {
        "sort": "market_cap",
        "count": 25,
        "order": "desc",
        "market": "AMS",
        "results": [
            {
                "low": 1574.2,
                "high": 1629.6,
                "last": 1629.6,
                "name": "ASML Holding NV",
                "open": 1612,
                "pe_ttm": 63.0097,
                "sector": "Electronic Technology",
                "symbol": "ASML",
                "ticker": "EURONEXT:ASML",
                "volume": 1014928,
                "currency": "EUR",
                "change_abs": 53.6,
                "change_pct": 3.401,
                "market_cap": 622482424414
            },
            {
                "low": 39.055,
                "high": 40,
                "last": 39.295,
                "name": "Prosus N.V. Class N",
                "open": 40,
                "pe_ttm": 7.4469,
                "sector": "Technology Services",
                "symbol": "PRX",
                "ticker": "EURONEXT:PRX",
                "volume": 3494564,
                "currency": "EUR",
                "change_abs": 0.09,
                "change_pct": 0.2296,
                "market_cap": 78269306604
            },
            {
                "low": 25.405,
                "high": 26.06,
                "last": 25.96,
                "name": "ING Groep N.V.",
                "open": 25.575,
                "pe_ttm": 11.8979,
                "sector": "Finance",
                "symbol"
…(truncated, see openapi.json for full schema)
```

### Indices

#### `GET /v1/index` — Amsterdam index family (AEX, AMX, AScX)

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

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

**Response:**
```json
{
    "data": {
        "count": 1,
        "market": "AMS",
        "indices": [
            {
                "low": 1065.64,
                "high": 1081.18,
                "name": "AEX-Index",
                "open": 1069.88,
                "index": "AEX",
                "value": 1081.18,
                "change_abs": 18.09,
                "change_pct": 1.7016
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T02:09:55.164Z",
        "request_id": "2bc135a6-3c7a-45f5-9e6c-afa15865270d"
    },
    "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/netherlands-stock-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "market": "Euronext Amsterdam",
        "source": "TradingView screener (netherlands market), keyless",
        "country": "Netherlands",
        "indices": [
            "AEX",
            "AMX",
            "ASCX"
        ],
        "currency": "EUR",
        "examples": {
            "index": "/v1/index",
            "quote": "/v1/quote?symbols=ASML,INGA,MT",
            "screener": "/v1/screener?sort=change&order=desc&limit=10"
        },
        "endpoints": {
            "/v1/index": "Amsterdam index family (AEX, AMX, AScX)",
            "/v1/quote": "live quote for one or more Amsterdam stocks by ticker (symbols=ASML,INGA,MT)",
            "/v1/screener": "rank local primary listings by market_cap | change | volume (sort, order, limit)"
        },
        "cache_ttl_ms": 20000
    },
    "meta": {
        "timestamp": "2026-06-15T02:09:55.259Z",
        "request_id": "f64e970b-1baa-4f7e-81a9-42abdfc757fc"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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