taiwan-stock-snapshot

What problem does it solve?

Provides a reliable, structured snapshot of Taiwan-listed equities by aggregating multiple FinMind datasets so users and workflows receive consistent, attribution-corrected market and fundamental signals without doing manual data wrangling.

Core Features & Use Cases

• Multi-dataset aggregation: Collects price, 三大法人 (institutional flows), 月營收 (monthly revenue), 董監持股 (insider holdings), and 融資融券 (margin/short) into a single JSON fixture and human-readable card.
• Attribution-corrected signals & postprocessing: Applies dataset-specific postprocessors, explicit attribution rules (e.g., treat 外資/投信/自營商 separately, pledge warnings), caching, retry/backoff, and graceful degradation on partial failures.
• Handoff-ready output: Produces a formatted snapshot card plus full _processed fixture for automated handoff to domain-teams:investing-team Taiwan-Specific Diagnosis workflows.

Quick Start

Fetch a Taiwan stock snapshot for ticker 2330 for period 1y and return the structured snapshot card plus the processed data fixture for investing-team handoff.