NZXplorer Market Data API
Stock prices, performance, technical signals, and factor models
Stock prices, performance, technical signals, and factor models
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/nzxplorer-co-nz:nzxplorer-co-nz-market-data-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: NZXplorer Market Data API
version: 1.157.0
description: 'Comprehensive NZX market data, governance intelligence, and proxy advisory API covering 130 issuers on the New Zealand Exchange. Provides structured access to company fundamentals, director intelligence, insider trades, financial statements, ESG data, dividend analytics, proxy advisory reports, and more.
All monetary values in financial statement endpoints (income_statements, balance_sheets, cash_flow_statements, earnings_results) are in NZD thousands unless otherwise noted. Dividends per share (dps_cents) are in cents. Ratios are unit-free percentages.'
contact:
name: NZXplorer API Support
email: hello@nzxplorer.co.nz
url: https://nzxplorer.co.nz/developers
license:
name: Proprietary
url: https://nzxplorer.co.nz/terms
x-logo:
url: https://nzxplorer.co.nz/logo.png
servers:
- url: https://nzxplorer.co.nz/api/v1
description: Production
security:
- ApiKeyHeader: []
- ApiKeyQuery: []
tags:
- name: Market Data
description: Stock prices, performance, technical signals, and factor models
paths:
/prices/{ticker}:
get:
operationId: getPrice
summary: Stock Prices
description: Historical OHLCV daily stock prices plus intraday snapshots (15-minute delay). The response includes a `latest` object with the most recent intraday price, change%, day high/low, and volume when available.
tags:
- Market Data
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol
schema:
type: string
- name: from
in: query
required: false
description: Start date (YYYY-MM-DD)
schema:
type: string
- name: to
in: query
required: false
description: End date (YYYY-MM-DD)
schema:
type: string
- name: days
in: query
required: false
description: Last N days of prices
schema:
type: integer
- name: limit
in: query
required: false
description: 'Max records, up to 2000 (default: 365)'
schema:
type: integer
responses:
'200':
description: Stock Prices
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/volume-anomalies:
get:
operationId: listVolumeAnomalies
summary: Volume Anomalies
description: 'Z-score based volume anomaly detection for NZX stocks. Identifies three types: spikes (single-day z-score above threshold), clusters (3+ days of >2x avg volume in 7-day window), and price-volume divergences (big volume, small price move). Cross-references announcements within 5 trading days. Especially valuable on the thin NZX market.'
tags:
- Market Data
x-tier: free
parameters:
- name: ticker
in: query
required: false
description: Filter to a single NZX ticker (e.g. FPH)
schema:
type: string
- name: days
in: query
required: false
description: 'Number of days to scan (default: 30, max: 365)'
schema:
type: number
- name: min_zscore
in: query
required: false
description: 'Minimum z-score threshold (default: 2.0)'
schema:
type: number
responses:
'200':
description: Volume Anomalies
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/technical-signals/{ticker}:
get:
operationId: getTechnicalSignal
summary: Technical Signals
description: SMA-50/100/200, RSI-14, golden/death cross, 52-week range, volume ratios. Updated daily.
tags:
- Market Data
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol
schema:
type: string
responses:
'200':
description: Technical Signals
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/performance/{ticker}:
get:
operationId: getPerformance
summary: Performance Metrics
description: Returns (1D-5Y), alpha vs NZX50, volatility, 52-week range, market cap.
tags:
- Market Data
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol
schema:
type: string
responses:
'200':
description: Performance Metrics
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/sector-heatmap:
get:
operationId: listSectorHeatmap
summary: Sector Heatmap
description: NZX market sectors aggregated by market cap with average weekly or monthly performance. Supports drill-down to individual companies within a sector via ?sector= filter.
tags:
- Market Data
x-tier: free
parameters:
- name: period
in: query
required: false
description: 'Performance period: 1w (default) or 1m'
schema:
type: string
- name: sector
in: query
required: false
description: Drill down to a specific sector for per-company data
schema:
type: string
responses:
'200':
description: Sector Heatmap
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/factor-model:
get:
operationId: listFactorModel
summary: NZ Equity Factor Model
description: 'Market-wide 6-factor scores (Value, Growth, Quality, Momentum, Dividends, Governance) for NZX companies. Sector-relative percentile ranking (0-100) with A-F grades. Inspired by Fama-French and Bloomberg Factor Model. Requires a Pro key: up to 50 rows per call on Pro, the full list on Corporate.'
tags:
- Market Data
x-tier: pro
parameters:
- name: sector
in: query
required: false
description: Filter by sector (e.g., Healthcare, Property)
schema:
type: string
- name: factor
in: query
required: false
description: 'Sort by factor: value, growth, profitability, momentum, dividends, governance'
schema:
type: string
- name: grade
in: query
required: false
description: Filter by composite grade (e.g., A,B)
schema:
type: string
- name: limit
in: query
required: false
description: 'Limit results (Pro: default and maximum 50; Corporate: default all)'
schema:
type: number
responses:
'200':
description: NZ Equity Factor Model
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/chart-data/{ticker}:
get:
operationId: getChartData
summary: Interactive Chart Data
description: Combined price, fundamental, and macro chart data for interactive overlays. Returns daily OHLCV prices, annual/interim financial metrics (EBITDA, revenue, net profit), earnings results, and RBNZ OCR decisions — all aligned by date for TradingView Lightweight Charts rendering.
tags:
- Market Data
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol (e.g., FPH, AIR, SPK)
schema:
type: string
- name: from
in: query
required: false
description: Start date (YYYY-MM-DD), default 5 years ago
schema:
type: string
- name: to
in: query
required: false
description: End date (YYYY-MM-DD), default today
schema:
type: string
- name: series
in: query
required: false
description: 'Comma-separated series to include: price, fundamentals, macro (default: all)'
schema:
type: string
responses:
'200':
description: Interactive Chart Data
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/snowflake/{ticker}:
get:
operationId: getSnowflake
summary: Portfolio Snowflake
description: 5-axis radar chart scores for visual company assessment. Returns Value, Growth, Health, Governance, and Dividends axis scores (0-100) with the underlying metrics driving each score.
tags:
- Market Data
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol (e.g., FPH, AIR, SPK)
schema:
type: string
responses:
'200':
description: Portfolio Snowflake
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/factor-grades/{ticker}:
get:
operationId: getFactorGrade
summary: Factor Grades
description: 'A-F factor grades across 6 investment dimensions: Value, Growth, Profitability, Momentum, Dividends, and Governance. Each factor includes sub-metrics with percentile rankings against the NZX universe.'
tags:
- Market Data
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol (e.g., FPH, AIR, SPK)
schema:
type: string
responses:
'200':
description: Factor Grades
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
/liquidity/{ticker}:
get:
operationId: getLiquidity
summary: Liquidity Score
description: Kyle\
tags:
- Market Data
x-tier: free
parameters:
- name: ticker
in: path
required: true
description: NZX ticker symbol (e.g. FPH, AIR)
schema:
type: string
responses:
'200':
description: Liquidity Score
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
headers:
$ref: '#/components/headers/RateLimitHeaders'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
components:
responses:
Unauthorized:
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Missing API key
message: Include your API key via X-API-Key header or ?api_key= query parameter.
docs: https://nzxplorer.co.nz/developers
NotFound:
description: Resource not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
InternalError:
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
RateLimited:
description: Rate limit exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Rate limit exceeded
message: free tier allows 10 requests/minute.
retry_after_seconds: 45
headers:
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
X-RateLimit-Limit:
description: Maximum requests allowed per minute
schema:
type: integer
X-RateLimit-Remaining:
description: Always 0 when rate limited
schema:
type: integer
schemas:
Envelope:
type: object
description: Standard API response envelope
properties:
data:
description: Response payload
meta:
type: object
properties:
api_version:
type: string
example: v1
timestamp:
type: string
format: date-time
format:
type: string
enum:
- standard
- llm
- fdc3
- toon
endpoint:
type: string
ErrorResponse:
type: object
properties:
error:
type: string
description: Error message
message:
type: string
description: Human-readable explanation
nullable: true
docs:
type: string
format: uri
description: Link to API documentation
nullable: true
retry_after_seconds:
type: integer
description: Seconds to wait before retrying (rate limit only)
nullable: true
required:
- error
headers:
RateLimitHeaders:
X-RateLimit-Limit:
description: Maximum requests allowed per minute
schema:
type: integer
X-RateLimit-Remaining:
description: Requests remaining in current window
schema:
type: integer
X-RateLimit-Reset:
description: Unix timestamp when the rate limit window resets
schema:
type: integer
X-RateLimit-Limit-Day:
description: Maximum requests allowed per day
schema:
type: integer
X-RateLimit-Remaining-Day:
description: Requests remaining for today
schema:
type: integer
X-API-Tier:
description: Authenticated API key tier (free, pro, enterprise, institutional)
schema:
type: string
X-Request-ID:
description: Unique request ID (UUID v4) for support correlation
schema:
type: string
format: uuid
securitySchemes:
ApiKeyHeader:
type: apiKey
in: header
name: X-API-Key
description: API key passed via the X-API-Key header
ApiKeyQuery:
type: apiKey
in: query
name: api_key
description: API key passed as a query parameter