NZXplorer API

Free API access to New Zealand capital market data. Companies, directors, governance scores, stock prices, and 64,000+ market announcements.

Quick Start

Get an API key

Email api@nzxplorer.co.nz with your use case

Add your API key

Include as X-API-Key header

Start building

All endpoints return JSON

curl -H "X-API-Key: YOUR_KEY" \
  "https://nzxplorer.co.nz/api/v1/companies?sector=Technology"

Authentication

All API requests require authentication via an API key. Pass your key in one of two ways:

Header (recommended)

X-API-Key: YOUR_KEY

Query parameter

?api_key=YOUR_KEY

Keep your API key secret. Never expose it in client-side code or public repositories.

Rate Limits

Tier	Rate Limit	Price	Use Case
Free	10 req/min	$0	Personal projects, research, prototyping
Pro	100 req/min	Contact us	Apps, dashboards, data pipelines
Enterprise	500 req/min	Contact us	High-volume, commercial use

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-API-Tier

LLM-Optimized Format

Add ?format=llm to any endpoint for token-optimized output. This strips null values, empty arrays, and metadata — ideal for feeding into LLMs and AI agents.

Standard format

{
  "data": {
    "ticker": "AIR",
    "name": "Air New Zealand",
    "description": null,
    "website_url": null,
    "directors": []
  },
  "meta": {
    "api_version": "v1",
    "timestamp": "2026-03..."
  }
}

LLM format (?format=llm)

{
  "ticker": "AIR",
  "name": "Air New Zealand"
}

~70% fewer tokens. Same data, no nulls or empty fields.

NZXplorer Copilot

An AI research assistant that uses all NZXplorer API endpoints to answer natural language questions about NZX-listed companies. Powered by Claude with tool-calling against 28 internal data tools.

Web Interface

Try the Copilot in your browser — available on every page via the floating button, or as a full-page experience.

Open NZXplorer Copilot →

CLI Agent

A terminal-based research agent with 18 NZX tools, DCF valuation skills, and live RBNZ OCR data. Built on LangChain.

npx nzxplorer-agent

View on GitHub →

API Endpoint

Use the POST /api/v1/ask endpoint to integrate the Copilot into your own applications. Supports SSE streaming and multi-turn conversations.

curl -X POST -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question": "What is the governance score for Air NZ?"}' \
  "https://nzxplorer.co.nz/api/v1/ask"

MCP Server

Connect NZXplorer data directly to Claude Desktop, Cursor, or any MCP-compatible client. 18 tools wrapping the full API — including proxy advisory, anomaly detection, market signals, and stock screening.

npx nzxplorer-mcp

Add to your Claude Desktop config or Cursor MCP settings. See GitHub repo for setup instructions.

Endpoints

Data Coverage

Dataset	Records	Updated
NZX-listed companies	130	Real-time
Company directors	1,334	Weekly
Governance scores (GRS v2)	130	Monthly
Stock prices (daily OHLCV)	162,000+	Daily
Market announcements	64,442	Daily
Director share transactions	4,127	Weekly
Executive compensation	491	Annually
Structured financials	500+	Annually
AGM resolutions	1,662	Annually

Error Codes

Code	Meaning
`200`	Success
`400`	Bad request — check parameters
`401`	Unauthorized — invalid or missing API key
`404`	Not found — resource does not exist
`429`	Rate limited — wait and retry
`500`	Server error — contact support

NZXplorer API v1 — New Zealand Capital Market Intelligence

Questions? Email api@nzxplorer.co.nz