financial-data

Cross-validate financial data from dual sources with error-rate thresholds and source attribution.

16.4k|2.5k|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/xbtlin/ai-berkshire --skill financial-data-xbtlin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: financial-data
Source: https://github.com/xbtlin/ai-berkshire/tree/main/codex-skills/financial-data
Command: npx skills add https://github.com/xbtlin/ai-berkshire --skill financial-data-xbtlin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Financial research often relies on a single data source, which risks errors from GAAP vs Non-GAAP differences, currency conversion, or stale updates. This Skill enforces a rule that every key financial figure must come from two independent sources, with discrepancies over 1% explicitly flagged. ## Core Features & Use Cases - Dual-source verification: Defines prioritized data sources per market (macrotrends/stockanalysis for US stocks, aastocks for HK, eastmoney/cninfo for A-shares, FinMind/Goodinfo for Taiwan stocks) and computes error rates between them. - Tiered discrepancy handling: Differences under 1% pass, 1-5% get flagged with explanations, and over 5% require checking original filings (10-K, annual reports) before use. - Taiwan stock tooling: Uses tools/twstock_data.py to fetch quotes, valuation, financials, monthly revenue, and dividends from the FinMind API with built-in market-cap verification. - Use Case: When analyzing TSMC, run the twstock_data.py script for FinMind figures, cross-check against Goodinfo, and present revenue with both source values and the computed error rate. ## Quick Start Fetch and cross-validate TSMC's last five years of revenue and net income using the FinMind tool and Goodinfo, flagging any discrepancy above 1%.

Frequently Asked Questions about 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?

Fetch each key metric from a primary and secondary source, compute the error rate as the absolute difference divided by the primary value, then apply thresholds: under 1% passes, 1-5% gets flagged with both values, and over 5% requires checking the original filing.

What data sources should I use for Taiwan stock financials?

Use the FinMind API via the twstock_data.py script as the primary source for Taiwan stocks, with Goodinfo as the secondary source. The script supports quote, valuation, financials, revenue, and dividend subcommands with built-in market-cap verification.

Why do financial data sources show different net income figures?

Differences usually come from GAAP versus Non-GAAP accounting, currency conversion timing, fiscal year definitions, or consolidation scope. These are flagged as data discrepancies rather than errors, with both values and the likely cause documented.

Does the FinMind API require registration or a token?

FinMind works unregistered with hourly rate limits. For higher limits, store a token in the FINMIND_TOKEN environment variable or a local/finmind_token.txt file, which is gitignored and must never be committed.

When should I use adjusted versus unadjusted stock prices?

Use forward-adjusted prices for all historical comparisons, multi-year returns, and historical PE bands; use unadjusted prices only for current snapshots. Total return calculations require backward-adjusted prices that include dividends.