| name | asx-announcements |
| compatibility | Requires bash, curl, awk, and jq. |
| description | Use this skill when the user asks about ASX company announcements, filings, or market-sensitive news for Australian listed companies. Fetches announcements by ticker with date, recency, and price-sensitivity filters, or browses the company directory. |
ASX Announcements
Fetch ASX-listed company announcements.
Usage
scripts/asx-announcements [SYMBOL] [options]
| Option | Description |
|---|
-d, --date YYYY-MM-DD | Sydney date (default: today). |
--days-back N | Scan N days back. |
-p, --price-sensitive | Price-sensitive only. |
-P, --pages N | Pages (default: 1, 0=unlimited). |
-l, --limit N | Max results (0=unlimited). |
--pdf DOCKEY | Download PDF by document key. |
--pdf-dir DIR | Directory for PDFs (default: .). |
--output FILE | Output path for --pdf. |
--directory | List company directory. |
--name-like TEXT | Company name prefix (e.g. A). |
--industry TEXT | Filter by industry (repeatable). |
--market-cap-bucket TEXT | Market cap bucket (repeatable). |
--per-page N | Directory items per page (default: 100). |
--order asc|desc | Directory sort order (default: asc). |
--order-by FIELD | Directory sort field. |
Examples:
scripts/asx-announcements # all companies today
scripts/asx-announcements --date=2026-05-21 --price-sensitive # price-sensitive only
scripts/asx-announcements CBA # CBA announcements
scripts/asx-announcements CBA,BHP --date=2026-05-21 # multi-ticker
scripts/asx-announcements --pdf DOCKEY --output ~/ann.pdf # PDF download
scripts/asx-announcements --directory # all companies A-Z
scripts/asx-announcements --directory --industry Banks # banks only
scripts/asx-announcements --directory --name-like A --industry Banks --market-cap-bucket "Large Caps"
scripts/asx-announcements --directory --order-by marketCap --order desc
Gotchas
- ASX ticker codes only — resolve names with
--directory or yfinance_search.
--date defaults to today in Sydney timezone.- Single company → supports all flags:
--date, --days-back, --price-sensitive, --pages, --limit.
- Multiple companies or no company → supports
--pages, --limit, --price-sensitive. --date and --days-back are accepted but do not filter results.
--days-back N filters to the last N Sydney days (single company only, slow on many days).- Output — one JSON document per page. Use
--pages and --limit to control volume.
- Zero results —
{"data":{"items":[]}} means nothing matched.
Reference
see references/industries.md for valid --industry and --market-cap-bucket values.
