taiwan-stock-snapshot

Aggregate FinMind datasets into structured Taiwan equity snapshots.

6|1|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/kouko/monkey-skills --skill taiwan-stock-snapshot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: taiwan-stock-snapshot
Source: https://github.com/kouko/monkey-skills/tree/main/investing-toolkit/skills/taiwan-stock-snapshot
Command: npx skills add https://github.com/kouko/monkey-skills --skill taiwan-stock-snapshot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

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.

Frequently Asked Questions about taiwan-stock-snapshot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I aggregate Taiwan stock price, institutional flows, and margin data into a single snapshot?

You can aggregate Taiwan stock price, institutional flows, and margin data into a single snapshot using this Skill to fetch multiple FinMind datasets, apply dataset-specific postprocessing, and return a consolidated JSON fixture.

What is the best way to collect monthly revenue and insider holdings for TWSE and OTC tickers?

The best way to collect monthly revenue and insider holdings for TWSE and OTC tickers is using this Skill's FinMind multi-dataset aggregation, which structures the data with caching, retry/backoff, and graceful degradation on partial failures.

How does institutional flow postprocessing handle foreign investors, investment trusts, and dealers separately?

Institutional flow postprocessing handles foreign investors, investment trusts, and dealers separately by applying explicit attribution rules during dataset-specific postprocessing to ensure attribution-corrected market signals.

Do I need a FinMind API token to fetch Taiwan equity snapshots?

You optionally need a FINMIND_API_TOKEN to fetch Taiwan equity snapshots, as the Skill requires finmind_client.py and uses the token for authentication while supporting requests via the requests dependency.

What happens when a partial failure occurs while fetching FinMind datasets for Taiwan equities?

When a partial failure occurs while fetching FinMind datasets, the Skill implements graceful degradation to ensure you still receive available market and fundamental signals without losing the entire equity snapshot.

Can I use this Taiwan equity snapshot output for automated trading workflow analysis?

Yes, you can use the Taiwan equity snapshot output for automated trading workflow analysis because the Skill produces a human-readable card and a full processed fixture ready for handoff to investing-team diagnosis workflows.