# World Stock Indices API
> Live world stock-index levels as an API — the current level of the major stock-market indices, served from Yahoo Finance. For any index it returns the current level, the previous close, the absolute and percentage change on the day, the day's high and low, and the 52-week high and low, in the index's own currency. Look an index up by name or ticker alias (S&P 500, Nasdaq, Dow, FTSE 100, DAX, CAC 40, Euro Stoxx 50, Nikkei 225, Hang Seng, Sensex, ASX 200 and more), pull a regional board ranked by the day's move (US, Europe, Asia, Americas), or get the headline world board in a single call. The live index-quote layer for trading, markets and dashboard apps. Distinct from S&P 500 and Nasdaq constituent-directory APIs — this returns the live index level, not the member list.

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

## Pricing
- **Free** (Free) — 9,000 calls/Mo, 4 req/s
- **Starter** ($9/Mo) — 130,000 calls/Mo, 12 req/s
- **Pro** ($25/Mo) — 700,000 calls/Mo, 35 req/s
- **Desk** ($59/Mo) — 3,500,000 calls/Mo, 100 req/s

## Endpoints

### Index

#### `GET /v1/index` — One index quote with day and 52-week stats

**Parameters:**
- `index` (query, required, string) — Index key or alias (e.g. sp500, dax, nikkei225, spx, ftse) Example: `sp500`

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

**Response:**
```json
{
    "data": {
        "name": "S&P 500",
        "as_of": "2026-06-08T20:56:48.000Z",
        "index": "sp500",
        "price": 7405.73,
        "change": 21.99,
        "region": "us",
        "symbol": "^GSPC",
        "country": "US",
        "day_low": 7395.13,
        "currency": "USD",
        "day_high": 7466.81,
        "change_pct": 0.3,
        "week52_low": 5943.23,
        "week52_high": 7620.9,
        "previous_close": 7383.74
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:35.165Z",
        "request_id": "8f5479a9-d7b8-4b7a-bf5f-d88d8a6d3fc6"
    },
    "status": "ok",
    "message": "Index retrieved successfully",
    "success": true
}
```

### Region

#### `GET /v1/region` — Regional board ranked by day change

**Parameters:**
- `region` (query, required, string) — Region: us|europe|asia|americas Example: `europe`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/indices-api/v1/region?region=europe"
```

**Response:**
```json
{
    "data": {
        "count": 7,
        "region": "europe",
        "indices": [
            {
                "name": "AEX",
                "as_of": "2026-06-08T16:05:02.000Z",
                "index": "aex",
                "price": 1044.99,
                "change": 3.9,
                "region": "europe",
                "symbol": "^AEX",
                "country": "NL",
                "day_low": 0,
                "currency": "EUR",
                "day_high": 0,
                "change_pct": 0.37,
                "week52_low": 0,
                "week52_high": 1056.8,
                "previous_close": 1041.09
            },
            {
                "name": "FTSE 100",
                "as_of": "2026-06-08T15:35:29.000Z",
                "index": "ftse100",
                "price": 10373.2,
                "change": 5.2,
                "region": "europe",
                "symbol": "^FTSE",
                "country": "GB",
                "day_low": 10319.17,
                "currency": "GBP",
                "day_high": 10409.33,
                "change_pct": 0.05,
                "week52_low": 8707.7,
                "week52_high": 10934.9,
                "previous_close": 10368
            },
            {
                "name": "Euro Stoxx 50",
                "as_of": "2026-06-08T16:00:00.000Z",
                "index": "eurostoxx50",
                "price": 6062.29,
                "change": 0.22,
                "region": "europe",
                "sy
…(truncated, see openapi.json for full schema)
```

### List

#### `GET /v1/list` — Headline world board in one call

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/indices-api/v1/list"
```

**Response:**
```json
{
    "data": {
        "count": 10,
        "indices": [
            {
                "name": "Nikkei 225",
                "as_of": "2026-06-09T02:35:03.000Z",
                "index": "nikkei225",
                "price": 64654.22,
                "change": 629.62,
                "region": "asia",
                "symbol": "^N225",
                "country": "JP",
                "day_low": 63918.96,
                "currency": "JPY",
                "day_high": 65042.43,
                "change_pct": 0.98,
                "week52_low": 37540.2,
                "week52_high": 68786.49,
                "previous_close": 64024.6
            },
            {
                "name": "Nasdaq Composite",
                "as_of": "2026-06-08T21:15:59.000Z",
                "index": "nasdaq",
                "price": 25929.66,
                "change": 220.23,
                "region": "us",
                "symbol": "^IXIC",
                "country": "US",
                "day_low": 25872.68,
                "currency": "USD",
                "day_high": 26179.65,
                "change_pct": 0.86,
                "week52_low": 19334.98,
                "week52_high": 27190.21,
                "previous_close": 25709.43
            },
            {
                "name": "S&P 500",
                "as_of": "2026-06-08T20:56:48.000Z",
                "index": "sp500",
                "price": 7405.73,
                "change": 21.99,
                "region": "us",
          
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata and full index list

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/indices-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Yahoo Finance public chart API (live)",
        "indices": {
            "aex": "AEX",
            "dax": "DAX",
            "dow": "Dow Jones Industrial Average",
            "smi": "Swiss Market Index",
            "tsx": "S&P/TSX Composite",
            "vix": "CBOE Volatility Index",
            "cac40": "CAC 40",
            "kospi": "KOSPI",
            "sp500": "S&P 500",
            "asx200": "S&P/ASX 200",
            "ibex35": "IBEX 35",
            "nasdaq": "Nasdaq Composite",
            "sensex": "BSE Sensex",
            "bovespa": "Bovespa",
            "ftse100": "FTSE 100",
            "hangseng": "Hang Seng",
            "shanghai": "SSE Composite",
            "nikkei225": "Nikkei 225",
            "eurostoxx50": "Euro Stoxx 50",
            "russell2000": "Russell 2000"
        },
        "regions": [
            "us",
            "europe",
            "asia",
            "americas"
        ],
        "service": "indices-api",
        "endpoints": {
            "GET /v1/list": "The headline world board in one call.",
            "GET /v1/meta": "This document (with the full index list).",
            "GET /v1/index": "One index quote (index=sp500|dax|nikkei225|… or aliases like spx, ftse).",
            "GET /v1/region": "A regional board ranked by day change (region=us|europe|asia|americas)."
        },
        "description": "Live world stock-index levels from Yahoo Finance: for any index, the current level, previous
…(truncated, see openapi.json for full schema)
```


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