FMA NZ

Goal

Provide practical, safe access to New Zealand Financial Markets Authority public information for:

• warnings-and-alerts listing and details
• licensed provider discovery for crowdfunding and peer-to-peer lending
• pointers to the Financial Advice Provider licensing ecosystem and the Financial Service Providers Register

Use this when

• A user asks for recent FMA warnings and alerts about scams, impersonation, or unregistered providers
• A task needs licensed provider lookup by name/type across FMA public pages
• A workflow needs source URLs and machine-readable metadata for NZ fintech consumer protection checks

Do not use this for

• Circumventing login walls, bot challenges, or any private/credentialed APIs
• Storing or persisting any scraped payloads
• Treating summary-only outputs as legal or compliance advice

CLI

Run with:

python3 skills/fma-nz/scripts/cli.py <command>

Commands

• warnings list [--query TEXT] [--since YYYY|YYYY-MM-DD] [--until YYYY|YYYY-MM-DD] [--limit N] [--json] - search/paginate FMA warnings/alerts by text and date window
• warnings get <slug-or-url> [--json] - fetch warning detail with source URL, dates, and summary
• providers list [--type crowdfunding|p2p|advice|all] [--query TEXT] [--limit N] [--json] - search FMA licensed-provider listings with type hints
• providers get <slug-or-url-or-fsp-number> [--json] - fetch one licensed-provider detail page
• providers sources [--type crowdfunding|p2p|advice|all] [--json] - return curated source pages and capability notes
• provider-search <query> [--type crowdfunding|p2p|advice|all] [--limit N] [--json] - convenience search wrapper over provider listing
• crowdfunding-platforms [--query TEXT] [--limit N] [--json] - curated alias for crowdfunding providers
• advice-providers [--query TEXT] [--limit N] [--json] - advice-provider source discovery entry point

Notes

• Read-only, no keys or session credentials required for the FMA public pages the skill queries.
• Advice-provider register discovery is source-limited: FMA links to the Financial Service Providers Register for searchable coverage, and that register requires a JS-enabled flow in this environment.
• Upstream is handled defensively with upstream_unavailable exits when traffic is blocked.

Resources

• scripts/cli.py - command implementations
• scripts/smoke_test.py - outage-tolerant smoke checks
• references/api-notes.md - source URLs, endpoint behaviour, caveats, and field notes