NZXplorer Market Data API

Stock prices, performance, technical signals, and factor models

GitHub OpenAPI

Operations 10

GET /prices/{ticker} Stock Prices #
GET /volume-anomalies Volume Anomalies #
GET /technical-signals/{ticker} Technical Signals #
GET /performance/{ticker} Performance Metrics #
GET /sector-heatmap Sector Heatmap #
GET /factor-model NZ Equity Factor Model #
GET /chart-data/{ticker} Interactive Chart Data #
GET /snowflake/{ticker} Portfolio Snowflake #
GET /factor-grades/{ticker} Factor Grades #
GET /liquidity/{ticker} Liquidity Score #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/nzxplorer-co-nz:nzxplorer-co-nz-market-data-api"
All apis
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.

Get an API 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 Specification

nzxplorer-co-nz-market-data-api-openapi.yml Raw ↑
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