# NZX (S&P/NZX 50) API
> Live New Zealand equity data from NZX (New Zealand's Exchange): real-time quotes for any listed stock by ticker (price, % change, intraday OHLC, volume, market cap in NZD), a ranking screener for gainers, losers, most-active and top market-cap local primary listings, and the S&P/NZX 50 Gross index. Foreign depositary receipts are filtered out so you get only genuine New Zealand companies such as Fisher & Paykel Healthcare, Meridian Energy, Infratil, Auckland Airport and Contact Energy.

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

## Pricing
- **Free** (Free) — 1,400 calls/Mo, 2 req/s
- **Basic** ($11/Mo) — 44,500 calls/Mo, 5 req/s
- **Pro** ($34/Mo) — 184,000 calls/Mo, 15 req/s
- **Business** ($73/Mo) — 755,000 calls/Mo, 40 req/s

## Endpoints

### Quotes

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

**Parameters:**
- `symbols` (query, required, string) — Comma-separated NZX tickers (up to 20) Example: `FPH,MEL,AIA`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/newzealand-stock-api/v1/quote?symbols=FPH%2CMEL%2CAIA"
```

**Response:**
```json
{
    "data": {
        "count": 3,
        "market": "NZX",
        "quotes": [
            {
                "low": 38.49,
                "high": 39.49,
                "last": 38.95,
                "name": "Fisher & Paykel Healthcare Corporation Limited",
                "open": 39.49,
                "pe_ttm": 49.1359,
                "sector": "Health Technology",
                "symbol": "FPH",
                "ticker": "NZX:FPH",
                "volume": 46416,
                "currency": "NZD",
                "change_abs": -0.5,
                "change_pct": -1.2674,
                "market_cap": 23168551556
            },
            {
                "low": 5.83,
                "high": 5.98,
                "last": 5.83,
                "name": "Meridian Energy Limited",
                "open": 5.98,
                "pe_ttm": null,
                "sector": "Utilities",
                "symbol": "MEL",
                "ticker": "NZX:MEL",
                "volume": 132098,
                "currency": "NZD",
                "change_abs": -0.12,
                "change_pct": -2.0168,
                "market_cap": 15759154097
            },
            {
                "low": 8.26,
                "high": 8.4,
                "last": 8.37,
                "name": "Auckland International Airport Limited",
                "open": 8.26,
                "pe_ttm": 34.6011,
                "sector": "Transportation",
                "symbol": "AIA",
                "ti
…(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/newzealand-stock-api/v1/screener?sort=market_cap&order=desc&limit=25"
```

**Response:**
```json
{
    "data": {
        "sort": "market_cap",
        "count": 25,
        "order": "desc",
        "market": "NZX",
        "results": [
            {
                "low": 38.49,
                "high": 39.49,
                "last": 38.95,
                "name": "Fisher & Paykel Healthcare Corporation Limited",
                "open": 39.49,
                "pe_ttm": 49.1359,
                "sector": "Health Technology",
                "symbol": "FPH",
                "ticker": "NZX:FPH",
                "volume": 46416,
                "currency": "NZD",
                "change_abs": -0.5,
                "change_pct": -1.2674,
                "market_cap": 23168551556
            },
            {
                "low": 5.83,
                "high": 5.98,
                "last": 5.83,
                "name": "Meridian Energy Limited",
                "open": 5.98,
                "pe_ttm": null,
                "sector": "Utilities",
                "symbol": "MEL",
                "ticker": "NZX:MEL",
                "volume": 132098,
                "currency": "NZD",
                "change_abs": -0.12,
                "change_pct": -2.0168,
                "market_cap": 15759154097
            },
            {
                "low": 14.86,
                "high": 15.1,
                "last": 14.995,
                "name": "Infratil Limited",
                "open": 14.86,
                "pe_ttm": 26.5351,
                "sector": "Finance",
                "sy
…(truncated, see openapi.json for full schema)
```

### Indices

#### `GET /v1/index` — New Zealand index (S&P/NZX 50 Gross)

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

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

**Response:**
```json
{
    "data": {
        "count": 1,
        "market": "NZX",
        "indices": [
            {
                "low": 13393.87,
                "high": 13526.07,
                "name": "S&P/NZX 50 Gross Index",
                "open": 13393.87,
                "index": "NZ50G",
                "value": 13412.21,
                "change_abs": 18.34,
                "change_pct": 0.1369
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T02:09:59.430Z",
        "request_id": "d0274446-dce5-4a42-9292-afa877170ffb"
    },
    "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/newzealand-stock-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "market": "NZX (New Zealand's Exchange)",
        "source": "TradingView screener (newzealand market), keyless",
        "country": "New Zealand",
        "indices": [
            "NZ50G",
            "NZ50FG"
        ],
        "currency": "NZD",
        "examples": {
            "index": "/v1/index",
            "quote": "/v1/quote?symbols=FPH,MEL,AIA",
            "screener": "/v1/screener?sort=change&order=desc&limit=10"
        },
        "endpoints": {
            "/v1/index": "New Zealand index (S&P/NZX 50 Gross)",
            "/v1/quote": "live quote for one or more NZX stocks by ticker (symbols=FPH,MEL,AIA)",
            "/v1/screener": "rank local primary listings by market_cap | change | volume (sort, order, limit)"
        },
        "cache_ttl_ms": 20000
    },
    "meta": {
        "timestamp": "2026-06-15T02:09:59.521Z",
        "request_id": "a408c153-7c23-490f-84b1-ea980ec30268"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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