NZX Announcements Monitor — New Zealand Market Disclosure Feed

Every new company announcement from the NZX Main Board (NZSX) and NZX Debt Market (NZDX) as a clean, near-real-time change feed: ticker, issuer, headline, NZX's own price-sensitive flag, a permalink to the announcement PDF, and a UTC timestamp. Each run emits only announcements it has never seen before, so a schedule gives you a duplicate-free stream you can pipe straight into a model, an alerting bot or a newsroom workflow.

Coverage note — NZX only, no ASX. ASX's website terms of use reserve ASX Market Announcements for investors' "private and personal use only" and require ASX's express written authority for any commercial use, so this actor does not fetch or redistribute them. Asking for asx in the input logs the reason and is skipped. If ASX coverage matters to you, licence it directly from ASX Information Services.

Example output

One real record, unmodified:

{
  "exchange": "nzx",
  "market": "NZSX",
  "announcementId": "478910",
  "ticker": "BRW",
  "company": "Bremworth Limited",
  "title": "Preliminary FY26 Unaudited Results Announcement",
  "announcementType": "FLLYR",
  "priceSensitive": true,
  "isThirdParty": false,
  "publishedAt": "2026-08-31T04:34:30Z",
  "publishedAtLocal": "2026-08-31T16:34:30+12:00",
  "pdfUrl": "https://api.nzx.com/public/announcement/478910/attachment/475933/478910-475933.pdf",
  "attachmentCount": 3,
  "url": "https://www.nzx.com/announcements/478910",
  "windowTruncated": false,
  "detectedAt": "2026-08-31T09:56:20Z"
}

Field	What it is
exchange	nzx
market	NZSX (Main Board) or NZDX (Debt Market). A release to both boards is emitted once, tagged NZSX
announcementId	NZX's own id — the stable key to dedupe on
ticker	Instrument code (AIR, FCG010, …). NZ RegCo notices carry REGCO
company	Issuer name, security class trimmed. null for issuers outside NZX's active-instrument list (most NZDX debt issuers, delisted codes)
title	Headline as published
announcementType	NZX type code: FLLYR, HALFYR, CORPACT, MKTUPDTE, MEETING, SECISSUE, SHINTR, HALT, ADMIN, ANNREP, GENERAL
priceSensitive	The exchange's own flag, not our guess (~1 announcement in 5)
isThirdParty	Lodged by a third party (substantial holder, NZ RegCo) rather than the issuer
publishedAt / publishedAtLocal	UTC, and the original NZ-offset timestamp
pdfUrl	Permalink to the first attached document (null if there is none)
attachmentCount	How many documents the announcement carries
url	The announcement's page on nzx.com
windowTruncated	true when this row's board listed nothing older than your sinceHours cutoff — the source window does not reach that far back, so coverage before its oldest row is incomplete
detectedAt	When this monitor first saw it

Input options

Input	Type	Default	What it does
exchanges	array	["nzx"]	Exchanges to monitor. nzx only — see the coverage note
tickers	array	(empty = all)	NZX instrument codes. A 3+ character code also matches that issuer's debt series, so FCG catches FCG010
priceSensitiveOnly	boolean	false	Emit only announcements NZX flagged price sensitive
sinceHours	integer	24	Backfill window on the first run; the scan window afterwards (max 168)
maxItems	integer	200	Cap on new announcements per run. Anything over the cap arrives next run

First run seeds, later runs diff. The first run emits everything inside sinceHours; after that only never-seen announcements are emitted, so a scheduled run yields zero duplicates. Announcements over maxItems carry over rather than being dropped.

Window vs source depth. Each board page lists its ~200 most recent announcements: about a month on NZDX, about four trading days on the busier NZSX. sinceHours beyond that is limited by the source on NZSX. When a board's oldest listed announcement is newer than your cutoff, the run logs a COVERAGE GAP warning, says so in the run status message, and marks every row from that board windowTruncated: true — so a short list is never mistaken for a quiet period. Weekends carry no announcements, so a Monday run with sinceHours=72 legitimately returns only Monday's items.

Suggested schedule: every 15 minutes between 08:00 and 18:00 NZ time on trading days — the exchange releases announcements continuously through the session.

Use cases

1. "NZX price-sensitive announcement alerts" — run with priceSensitiveOnly: true and webhook every new row into Slack, Discord or email. You see results, dividends, guidance changes and trading halts as they land, with the PDF one click away.
2. "NZX announcements API for my portfolio" — set tickers to your holdings and let the feed watch them for you: capital changes, director interests, meeting notices, debt-series terms. announcementId makes upserts trivial.
3. "Scrape NZX disclosures into a dataset" — leave the filters empty and run on a schedule to build a timestamped announcement history with headline, type, price-sensitivity and document links, ready for event studies or LLM summarisation.

Pricing (pay per event)

Event	Price
Actor start	$0.005 per run
New announcement detected	$0.008 each

A quiet run costs the start fee alone. A typical NZ trading day publishes roughly 90–120 announcements across both boards, of which about 10–20 are price sensitive.

Reliability

• One board failing degrades to a warning: the other board still emits and the failed board's announcements are picked up on the next run. If both boards fail the run fails loudly rather than reporting a quiet day.
• Field-level changes at the source log a named schema-drift warning instead of crashing the run. If every board fetches but lists zero announcements the run fails loudly rather than reporting a quiet day.
• Attachment links are built the way nzx.com builds them for a browser; the monitor never hammers NZX's data host.
• Schema checked weekly against the live pages; output changes within v1 are additive only.

Changelog

• 0.1 — first release. NZSX + NZDX boards, ticker and price-sensitive filters, PDF permalinks, seen-id change feed with carry-over.