NZXplorer API

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

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

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.

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

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

Add ?format=toon to any endpoint for maximum token compression. TOON (Token-Optimized Object Notation) encodes arrays of objects as pipe-delimited tabular data — 30-60% fewer tokens than JSON with lossless roundtrip fidelity.

[
  {"ticker":"AIR","name":"Air NZ","sector":"Industrials"},
  {"ticker":"FPH","name":"Fisher & Paykel","sector":"Healthcare"},
  {"ticker":"MEL","name":"Meridian","sector":"Utilities"}
]

ticker|name|sector
AIR|Air NZ|Industrials
FPH|Fisher & Paykel|Healthcare
MEL|Meridian|Utilities

Add ?format=fdc3 to supported endpoints for FINOS FDC3 v2.0 standard context types. Enables interoperability with Bloomberg, Refinitiv, IRESS, and other FDC3-compliant desktop applications. All 131 issuers have ISINs, and LEIs are available for 65/131 issuers (50% coverage) via the GLEIF register.

{
  "data": {
    "ticker": "AIR",
    "name": "Air New Zealand",
    "isin": "NZAIRE0001S2",
    "sector": "Industrials"
  }
}

{
  "type": "fdc3.instrument",
  "name": "Air New Zealand",
  "id": {
    "ticker": "AIR",
    "ISIN": "NZAIRE0001S2",
    "LEI": "XN8VX00V0UCRJ3ZGN385"
  },
  "market": {
    "MIC": "XNZE",
    "name": "New Zealand Exchange",
    "COUNTRY_ISOALPHA2": "NZ"
  }
}

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 36 internal data tools. Features hybrid semantic search with reranking, structured copilot cards for rich visual output, and TOON token optimization for 30-60% cost reduction.

npx nzxplorer-agent

# Default (general) persona
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"

# With analyst persona (macro, governance, or risk)
curl -X POST -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question": "How does the OCR cycle affect utilities?", "persona": "macro"}' \
  "https://nzxplorer.co.nz/api/v1/ask"

Connect NZXplorer data directly to Claude Desktop, Cursor, or any MCP-compatible client. 42 tools wrapping the full API — including proxy advisory, anomaly detection, market signals, stock screening, accounting quality, IR quality, peer mentions, board briefings, skills matrices, and research briefings.

npx nzxplorer-mcp

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