finance-financial-data

Validates corporate financial data through dual-source cross-verification with error-rate thresholds.

Updated Aug 10, 2026
One-click install
npx skills add https://github.com/Choi-Keith/skill-arsenal-ultra --skill finance-financial-data-choi-keith
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finance-financial-data
Source: https://github.com/Choi-Keith/skill-arsenal-ultra/tree/main/plugins/finance-skills/finance-research/skills/finance-financial-data
Command: npx skills add https://github.com/Choi-Keith/skill-arsenal-ultra --skill finance-financial-data-choi-keith

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Financial research often relies on a single data source, which risks propagating errors from GAAP vs Non-GAAP differences, currency conversion mismatches, or stale platform data. This Skill enforces a rule that every key financial figure must come from two independent sources, with discrepancies above 1% explicitly flagged. ## Core Features & Use Cases - Dual-Source Cross-Validation: Defines primary and secondary data sources per market (macrotrends/stockanalysis for US stocks, aastocks for HK stocks, eastmoney/cninfo for A-shares, FinMind/Goodinfo for Taiwan stocks) and computes error rates with tiered handling (≤1% pass, 1-5% warn, >5% require original filing verification). - Taiwan Stock Data Toolkit: Ships a zero-dependency Python script (twstock_data.py) wrapping the FinMind API for quotes, valuation, 5-year financials, monthly revenue, and dividends, with built-in market-cap verification. - Price Adjustment Rules: Standardizes the use of forward-adjusted prices for historical analysis and backward-adjusted prices for total return calculations to prevent distorted historical comparisons. - Use Case: When researching TSMC, run the twstock_data.py script to pull financials from FinMind, cross-check against Goodinfo, and present revenue figures with both sources and the computed error rate annotated. ## Quick Start Ask the agent to research a company's financials, for example: "Get TSMC's last 5 years of revenue and net income, cross-validate the data from two independent sources, and flag any discrepancies over 1%."

Frequently Asked Questions about finance-financial-data

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

FAQPage Schema
How do I cross-validate financial data from two sources?

Pull each key metric (revenue, net income, gross margin) from a primary and secondary source, then compute the error rate as the absolute difference divided by the primary value. Discrepancies up to 1% pass, 1-5% get flagged with both values shown, and above 5% require checking the original filing.

What data sources should I use for Taiwan stock financials?

Use the FinMind API as the primary source via the included twstock_data.py script, which provides quotes, valuation, financials, monthly revenue, and dividends. Cross-validate against Goodinfo, or macrotrends for companies with ADRs like TSMC.

Does the FinMind API require registration or an API key?

FinMind works anonymously with hourly rate limits, so no registration is required. An optional token can be set via the FINMIND_TOKEN environment variable or a local file to raise limits, and it must never be committed to git.

Why do two financial data sources show different net income figures?

The most common cause is GAAP versus Non-GAAP accounting standards, especially for profit metrics. Other causes include currency conversion timing, fiscal year definitions, consolidation scope, and one platform lagging on the latest filing.

When should I use forward-adjusted versus backward-adjusted stock prices?

Use forward-adjusted prices for historical price comparisons, multi-year gains, and historical PE bands. Use backward-adjusted prices when calculating total return or annualized returns, since they include dividend effects.

What are the limitations of this financial data validation approach?

It does not apply to non-financial data such as user behavior or market research figures. For unlisted companies with only one data source, cross-validation is skipped and figures are marked as estimates instead.