nzx.com APInzx.com ↗
Access daily OHLC prices, trading volume, company listings, and instrument details for NZX-listed stocks via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/7392557d-d880-428c-a870-0c3c60653fd3/get_daily_price_volume?code=AIR' \ -H 'X-API-Key: $PARSE_API_KEY'
Get daily price and volume data for an NZX-listed stock. Returns up to 2 years of merged OHLC price data and trading volume/value for every trading day, sorted newest first.
| Param | Type | Description |
|---|---|---|
| coderequired | string | NZX stock ticker code (e.g. MHJ, AIR, FPH, FBU) |
{
"type": "object",
"fields": {
"code": "string - Stock ticker code",
"isin": "string - International Securities Identification Number",
"name": "string - Full instrument name",
"period": "string - Data period (2Y)",
"currency": "string - Currency code (e.g. NZD)",
"daily_data": "array - Daily records sorted newest first, each with date, open, high, low, close, market_price, volume, value, trade_count, on_market_volume, off_market_volume, capitalisation",
"total_days": "integer - Number of trading days returned"
},
"sample": {
"data": {
"code": "AIR",
"isin": "NZAIRE0001S2",
"name": "Air New Zealand Limited (NS) Ordinary Shares",
"period": "2Y",
"currency": "NZD",
"daily_data": [
{
"low": null,
"date": "2026-05-14",
"high": null,
"open": null,
"close": null,
"value": 0,
"volume": 0,
"trade_count": 0,
"market_price": 0.405,
"capitalisation": 1309592623.365,
"on_market_volume": 0,
"off_market_volume": 0
}
],
"total_days": 502
},
"status": "success"
}
}About the nzx.com API
The NZX API provides access to New Zealand Exchange market data across 3 endpoints, covering daily OHLC price and volume history, a full company directory, and per-instrument details. The get_daily_price_volume endpoint returns up to 2 years of trading day records — including open, high, low, close, volume, value, and trade count — for any NZX-listed ticker code such as AIR, FPH, or FBU.
Daily Price and Volume History
The get_daily_price_volume endpoint accepts an NZX ticker code (e.g. MHJ, AIR, FPH) and returns a daily_data array sorted newest first. Each record includes date, open, high, low, close, market_price, volume, value, trade_count, and on_ma. The response also carries top-level fields: isin, name, currency, period (fixed at 2Y), and total_days — the number of trading days in the returned dataset.
Company Directory
The list_companies endpoint requires no inputs and returns every NZX-listed company as an array. Each company object includes code, short_name, registered_name, listing_status, and first_listed. The total field gives the count of companies in the response. Results are sorted alphabetically by ticker code, making it straightforward to iterate over the full exchange.
Instrument Details
The get_instrument_details endpoint takes a ticker code and returns an instruments array. Each instrument record includes isin, code, name, security_class, market_type, category, currency_code, shares_issued, and first_listed. A single ticker can map to multiple instrument entries where different security classes exist for the same issuer.
Coverage and Data Currency
All data covers instruments listed on the NZX. Price history extends back up to two years from the current date. The currency field in both price and instrument responses is typically NZD, though some instruments may carry different designations.
- Build a historical price chart for any NZX stock using up to 2 years of daily OHLC data from
get_daily_price_volume. - Screen NZX-listed companies by
listing_statususing the full directory fromlist_companies. - Calculate daily trading volume trends and value turnover for NZX equities using
volumeandvaluefields. - Enrich a portfolio tracker with
isin,shares_issued, andsecurity_classfromget_instrument_details. - Identify newly listed companies on the NZX by sorting the
first_listedfield returned bylist_companies. - Cross-reference NZX instruments with global securities databases using the
isinfield. - Monitor average trade size per session by dividing
valuebytrade_countin the daily records.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does NZX provide an official developer API?+
What does `get_daily_price_volume` return beyond OHLC prices?+
volume (shares traded), value (dollar value of trades), trade_count (number of individual transactions), market_price, and on_ma in addition to the standard open, high, low, and close fields. The response also includes the instrument's isin, name, and currency at the top level.Can I retrieve intraday price data or real-time quotes through this API?+
Does the API cover NZX derivatives, bonds, or funds — or only equities?+
get_instrument_details returns for a given code. Dedicated coverage of NZX-listed bonds or derivatives is not currently guaranteed. You can fork this API on Parse and revise it to add endpoints targeting those instrument categories.Is there pagination for `list_companies`?+
list_companies endpoint returns all listed companies in a single response along with a total count. There are no pagination parameters — the full directory is delivered at once.