{"openapi":"3.1.0","info":{"title":"NZX (S&P/NZX 50) API","version":"1.0.0","description":"Live New Zealand equity data from NZX (New Zealand's Exchange): real-time quotes for any listed stock by ticker (price, % change, intraday OHLC, volume, market cap in NZD), a ranking screener for gainers, losers, most-active and top market-cap local primary listings, and the S&P/NZX 50 Gross index. Foreign depositary receipts are filtered out so you get only genuine New Zealand companies such as Fisher & Paykel Healthcare, Meridian Energy, Infratil, Auckland Airport and Contact Energy.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/newzealand-stock-api","description":"oanor gateway"}],"tags":[{"name":"Quotes"},{"name":"Screener"},{"name":"Indices"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/quote":{"get":{"operationId":"get_v1_quote","tags":["Quotes"],"summary":"Live quote for one or more NZX stocks","description":"","parameters":[{"name":"symbols","in":"query","required":true,"description":"Comma-separated NZX tickers (up to 20)","schema":{"type":"string"},"example":"FPH,MEL,AIA"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"market":"NZX","quotes":[{"low":38.49,"high":39.49,"last":38.95,"name":"Fisher & Paykel Healthcare Corporation Limited","open":39.49,"pe_ttm":49.1359,"sector":"Health Technology","symbol":"FPH","ticker":"NZX:FPH","volume":46416,"currency":"NZD","change_abs":-0.5,"change_pct":-1.2674,"market_cap":23168551556},{"low":5.83,"high":5.98,"last":5.83,"name":"Meridian Energy Limited","open":5.98,"sector":"Utilities","symbol":"MEL","ticker":"NZX:MEL","volume":132098,"currency":"NZD","change_abs":-0.12,"change_pct":-2.0168,"market_cap":15759154097},{"low":8.26,"high":8.4,"last":8.37,"name":"Auckland International Airport Limited","open":8.26,"pe_ttm":34.6011,"sector":"Transportation","symbol":"AIA","ticker":"NZX:AIA","volume":248124,"currency":"NZD","change_abs":0.14,"change_pct":1.7011,"market_cap":13987737160}]},"meta":{"timestamp":"2026-06-15T02:09:58.494Z","request_id":"7d80a838-7dca-422c-9ba5-99634e2d9824"},"status":"ok","message":"Quote retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/screener":{"get":{"operationId":"get_v1_screener","tags":["Screener"],"summary":"Rank local primary listings","description":"","parameters":[{"name":"sort","in":"query","required":false,"description":"Sort field: market_cap, change or volume","schema":{"type":"string"},"example":"market_cap"},{"name":"order","in":"query","required":false,"description":"asc or desc","schema":{"type":"string"},"example":"desc"},{"name":"limit","in":"query","required":false,"description":"Number of results (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sort":"market_cap","count":25,"order":"desc","market":"NZX","results":[{"low":38.49,"high":39.49,"last":38.95,"name":"Fisher & Paykel Healthcare Corporation Limited","open":39.49,"pe_ttm":49.1359,"sector":"Health Technology","symbol":"FPH","ticker":"NZX:FPH","volume":46416,"currency":"NZD","change_abs":-0.5,"change_pct":-1.2674,"market_cap":23168551556},{"low":5.83,"high":5.98,"last":5.83,"name":"Meridian Energy Limited","open":5.98,"sector":"Utilities","symbol":"MEL","ticker":"NZX:MEL","volume":132098,"currency":"NZD","change_abs":-0.12,"change_pct":-2.0168,"market_cap":15759154097},{"low":14.86,"high":15.1,"last":14.995,"name":"Infratil Limited","open":14.86,"pe_ttm":26.5351,"sector":"Finance","symbol":"IFT","ticker":"NZX:IFT","volume":258408,"currency":"NZD","change_abs":0.185,"change_pct":1.2492,"market_cap":14799818544},{"low":8.26,"high":8.4,"last":8.37,"name":"Auckland International Airport Limited","open":8.26,"pe_ttm":34.6011,"sector":"Transportation","symbol":"AIA","ticker":"NZX:AIA","volume":248124,"currency":"NZD","change_abs":0.14,"change_pct":1.7011,"market_cap":13987737160},{"low":9.42,"high":9.57,"last":9.44,"name":"Contact Energy Limited","open":9.56,"pe_ttm":21.204,"sector":"Utilities","symbol":"CEN","ticker":"NZX:CEN","volume":218168,"currency":"NZD","change_abs":-0.11,"change_pct":-1.1518,"market_cap":10224488772},{"low":6.885,"high":6.99,"last":6.92,"name":"Mercury NZ Ltd.","open":6.96,"pe_ttm":110.72,"sector":"Utilities","symbol":"MCY","ticker":"NZX:MCY","volume":72810,"currency":"NZD","change_abs":-0.04,"change_pct":-0.5747,"market_cap":9918285523},{"low":4.41,"high":4.45,"last":4.44,"name":"Fonterra Co-operative Group Limited","open":4.41,"sector":"Consumer Non-Durables","symbol":"FCG","ticker":"NZX:FCG","volume":174261,"currency":"NZD","change_abs":0.02,"change_pct":0.4525,"market_cap":7112622362},{"low":64.9,"high":65.73,"last":65.37,"name":"Mainfreight Limited","open":65.34,"pe_ttm":26.2256,"sector":"Transportation","symbol":"MFT","ticker":"NZX:MFT","volume":7976,"currency":"NZD","change_abs":-0.03,"change_pct":-0.0459,"market_cap":6585685151},{"low":8.11,"high":8.29,"last":8.15,"name":"Port of Tauranga Limited","open":8.29,"pe_ttm":30.23,"sector":"Transportation","symbol":"POT","ticker":"NZX:POT","volume":92238,"currency":"NZD","change_abs":-0.08,"change_pct":-0.9721,"market_cap":5598462212},{"low":7.34,"high":7.94,"last":7.37,"name":"a2 Milk Company Limited","open":7.43,"pe_ttm":23.828,"sector":"Consumer Non-Durables","symbol":"ATM","ticker":"NZX:ATM","volume":564837,"currency":"NZD","change_abs":0.1,"change_pct":1.3755,"market_cap":5273848522},{"low":4.92,"high":4.98,"last":4.96,"name":"Vector Limited","open":4.97,"pe_ttm":32.8042,"sector":"Utilities","symbol":"VCT","ticker":"NZX:VCT","volume":72620,"currency":"NZD","change_abs":-0.04,"change_pct":-0.8,"market_cap":5000000000},{"low":21.2,"high":22.31,"last":21.33,"name":"EBOS Group Limited","open":21.46,"pe_ttm":17.0422,"sector":"Health Technology","symbol":"EBO","ticker":"NZX:EBO","volume":164154,"currency":"NZD","change_abs":-0.08,"change_pct":-0.3737,"market_cap":4430576600},{"low":9.82,"high":9.99,"last":9.82,"name":"Chorus Limited","open":9.9,"pe_ttm":200.818,"sector":"Communications","symbol":"CNU","ticker":"NZX:CNU","volume":19163,"currency":"NZD","change_abs":-0.06,"change_pct":-0.6073,"market_cap":4286806257.9999995},{"low":1.94,"high":1.97,"last":1.955,"name":"Spark New Zealand Limited","open":1.95,"pe_ttm":12.5723,"sector":"Communications","symbol":"SPK","ticker":"NZX:SPK","volume":492259,"currency":"NZD","change_abs":0.015,"change_pct":0.7732,"market_cap":3666852554},{"low":3.15,"high":3.21,"last":3.19,"name":"Fletcher Building Limited","open":3.2,"sector":"Non-Energy Minerals","symbol":"FBU","ticker":"NZX:FBU","volume":112843,"currency":"NZD","change_abs":0,"change_pct":0,"market_cap":3413796941},{"low":2.56,"high":2.605,"last":2.58,"name":"Genesis Energy Limited","open":2.6,"pe_ttm":14.7936,"sector":"Utilities","symbol":"GNE","ticker":"NZX:GNE","volume":125161,"currency":"NZD","change_abs":-0.01,"change_pct":-0.3861,"market_cap":3389968116},{"low":2,"high":2.05,"last":2.05,"name":"Goodman New Zealand Limited & Goodman Property Services Limited Units","open":2,"pe_ttm":12.7171,"sector":"Finance","symbol":"GNZ","ticker":"NZX:GNZ","volume":144544,"currency":"NZD","change_abs":0.01,"change_pct":0.4902,"market_cap":3122447052},{"low":13.55,"high":13.9,"last":13.55,"name":"Freightways Group Limited","open":13.57,"pe_ttm":27.7778,"sector":"Transportation","symbol":"FRW","ticker":"NZX:FRW","volume":59976,"currency":"NZD","change_abs":-0.05,"change_pct":-0.3676,"market_cap":2434330134},{"low":2.3,"high":2.35,"last":2.33,"name":"Ryman Healthcare Ltd.","open":2.3,"sector":"Health Services","symbol":"RYM","ticker":"NZX:RYM","volume":458457,"currency":"NZD","change_abs":0.03,"change_pct":1.3043,"market_cap":2333888172},{"low":8.18,"high":8.8,"last":8.545,"name":"Summerset Group Holdings Limited","open":8.18,"pe_ttm":7.9223,"sector":"Health Services","symbol":"SUM","ticker":"NZX:SUM","volume":86890,"currency":"NZD","change_abs":0.355,"change_pct":4.3346,"market_cap":1999114088},{"low":1.025,"high":1.05,"last":1.05,"name":"Precinct Properties NZ Ltd & Precinct Properties Investments Ltd","open":1.03,"pe_ttm":375,"sector":"Finance","symbol":"PCT","ticker":"NZX:PCT","volume":311523,"currency":"NZD","change_abs":0.015,"change_pct":1.4493,"market_cap":1917699031},{"low":1.89,"high":1.92,"last":1.905,"name":"Vital Healthcare Property Trust","open":1.9,"sector":"Finance","symbol":"VHP","ticker":"NZX:VHP","volume":161342,"currency":"NZD","change_abs":-0.015,"change_pct":-0.7812,"market_cap":1549684163},{"low":0.925,"high":0.935,"last":0.9325,"name":"Kiwi Property Group Ltd.","open":0.925,"pe_ttm":30.4739,"sector":"Finance","symbol":"KPG","ticker":"NZX:KPG","volume":223797,"currency":"NZD","change_abs":0.0075,"change_pct":0.8108,"market_cap":1526750911},{"low":0.415,"high":0.45,"last":0.45,"name":"Air New Zealand Limited","open":0.415,"sector":"Transportation","symbol":"AIR","ticker":"NZX:AIR","volume":2370173,"currency":"NZD","change_abs":0.03,"change_pct":7.1429,"market_cap":1358096003},{"low":3,"high":3.09,"last":3.075,"name":"Channel Infrastructure NZ Limited","open":3,"pe_ttm":106.7708,"sector":"Energy Minerals","symbol":"CHI","ticker":"NZX:CHI","volume":539201,"currency":"NZD","change_abs":0.025,"change_pct":0.8197,"market_cap":1263886919}]},"meta":{"timestamp":"2026-06-15T02:09:58.728Z","request_id":"8e9a5027-7b9d-4192-80d6-08cb8e0b1fbd"},"status":"ok","message":"Screener retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/index":{"get":{"operationId":"get_v1_index","tags":["Indices"],"summary":"New Zealand index (S&P/NZX 50 Gross)","description":"","parameters":[{"name":"symbol","in":"query","required":false,"description":"Optional specific index symbol(s)","schema":{"type":"string"},"example":"NZ50G"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"market":"NZX","indices":[{"low":13393.87,"high":13526.07,"name":"S&P/NZX 50 Gross Index","open":13393.87,"index":"NZ50G","value":13412.21,"change_abs":18.34,"change_pct":0.1369}]},"meta":{"timestamp":"2026-06-15T02:09:59.430Z","request_id":"d0274446-dce5-4a42-9292-afa877170ffb"},"status":"ok","message":"Index retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Market metadata & endpoint guide","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"market":"NZX (New Zealand's Exchange)","source":"TradingView screener (newzealand market), keyless","country":"New Zealand","indices":["NZ50G","NZ50FG"],"currency":"NZD","examples":{"index":"/v1/index","quote":"/v1/quote?symbols=FPH,MEL,AIA","screener":"/v1/screener?sort=change&order=desc&limit=10"},"endpoints":{"/v1/index":"New Zealand index (S&P/NZX 50 Gross)","/v1/quote":"live quote for one or more NZX stocks by ticker (symbols=FPH,MEL,AIA)","/v1/screener":"rank local primary listings by market_cap | change | volume (sort, order, limit)"},"cache_ttl_ms":20000},"meta":{"timestamp":"2026-06-15T02:09:59.521Z","request_id":"a408c153-7c23-490f-84b1-ea980ec30268"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1400,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1130,"monthly_call_quota":44500,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3380,"monthly_call_quota":184000,"rps_limit":15,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7280,"monthly_call_quota":755000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/newzealand-stock-api"}