SuperAPI AI Directory

earnings-analysis

General & other

View repository

Updated 10-16 08:40

About this skill

Financial report breakdown (earnings-analysis)

Definition manual corresponding to Phase 2 (financials) of the company-research SOP, also used for any "how are the results" follow-up. Principles:Cumulative values are the raw material, the single quarter is the basic unit, TTM looks at scale, the latest period looks at inflection; every split / sum / ratio is a calc call。

0. Four iron rules

  1. What A-share financial reports disclose isreporting-period cumulative values(Q1 / H1 / Q1–Q3 / full year); any "single quarter" or "QoQ" must be obtained via quarterize breakdown, not subtracted in your head.
  2. Deducted non-recurring vs. attributable to parent: use deducted non-recurring for the valuation numerator (one-off gains/losses cannot be ×4), use attributable to parent for the main growth judgment (same definition as consensus EPS); report both side by side, and when the difference is large you must explain it (investment income / subsidies / impairments / fair value changes).
  3. Numerator and denominator in the same period and same definition: YoY against the same quarter, TTM against TTM; do not compare cumulative values with single quarters.
  4. Ratios (gross margin / net margin / expense ratio / debt ratio / proportion) are all ratio(numerator, denominator, label, unit_in), you guarantee both numbers are in the same unit; calc does not convert units.

1. Definition map

Definition Definition calc function Use Prohibited
Cumulative value (YTD) Original value disclosed for the reporting period — (evidence) Raw material Do not directly compare reporting periods of different lengths
Single quarter Q1 = YTD(Q1);Qn = YTD(n) − YTD(n−1) quarterize(cumulative, unit, money=true) Basic unit Previous period missing → no value for that quarter; do not substitute an average
Latest single quarter Latest non-empty single quarter latest_quarter(single_quarters, unit, money=true) Valuation numerator (deducted non-recurring), inflection judgment —
TTM Sum of the last 4 quarters ttm_sum(single_quarters, end_period, unit, money=true) Scale, TTM PE If any quarter is missing, then not_meaningful(do not make it up from 3 quarters)
TTM YoY TTM(end) ÷ TTM(end − 4 quarters) − 1 ttm_yoy(...) Fact of sustainable growth, cross-validation of forward CAGR Requires 8 consecutive quarters
QoQ Q(end) ÷ Q(end − 1) − 1 qoq(...) Inflection / momentum signal Prohibited as a growth rate, prohibited from annualizing, prohibited as a PEG denominator
Single-quarter YoY Q(end) ÷ Q(end − 4) − 1 growth_rate(current, base, label) Look at the direction of "this quarter relative to last year" Prohibited as a PEG denominator (a low base falsely inflates it)
Ratio Ratio of two line items in the same period and same unit ratio(numerator, denominator, label, unit_in) Gross margin / net margin / expense ratio / debt ratio / operating cash flow ÷ net profit Denominator ≤ 0 → not_meaningful, write it as is

Use money=false for EPS series (yuan per share); for amount-type items use money=true and let calc normalize the unit.

2. Breakdown process (consistent with the financials phase of the SOP)

  1. fetch_financials(★ required) → cumulative value series for revenue / net profit attributable to parent / deducted non-recurring / EPS (last 8–12 reporting periods).
  2. quarterize Run each once: revenue_cum, net_profit_parent_cum, net_profit_deducted_cum (unit=yuan, money=true).
  3. latest_quarter(deducted non-recurring) → valuation numerator;ttm_sum(one each for attributable-to-parent and non-recurring-adjusted) → intermediate quantity;ttm_yoy(primarily attributable to parent, non-recurring-adjusted in parallel) → growth fact;qoq(latest single-quarter non-recurring-adjusted) → inflection signal.
  4. Three-statement cross-check (○ optional endpoints):sina_income_statement / sina_balance_sheet / sina_cashflow(A-shares),em_global_income / em_global_balance / em_global_cashflow or yahoo_financials(US / HK). Only for verification and supplementary line items (gross profit, expenses, operating cash flow, receivables, inventory, interest-bearing debt),record line-item raw values as-is from the source, without conversion.
  5. Ratios: gross margin = ratio(毛利, 营收); net margin = ratio(净利润, 营收); expense ratio = ratio(某费用, 营收); operating cash flow / net profit = ratio(经营现金流净额, 净利润); debt-to-asset ratio = ratio(总负债, 总资产)——one call per ratio, numerator and denominator for the same period and in the same unit, record calc id.
  6. Every calc call passes --run-dir(the CLI writes the record of that calculation into the run directory's calcs/, and the orchestrator merges them at the end into the contract artifact calculations.json; do not write any file by hand), and the stage JSON references calculation_id; for gaps follow the structured gaps in SOP §2.

3. Quality checklist (write into the inference section)

  • One-off gains/losses: when the difference between attributable-to-parent and non-recurring-adjusted exceeds 20%, the source must be explained (investment income / government subsidies / impairment / fair value changes), and state which basis is used for valuation and which for growth.
  • Seasonality: mark whether the latest single quarter is Q1 / Q2 / Q3 / Q4, and the company's historical peak/off-season direction (from the single-quarter series), and flag the directional bias of "single quarter × 4" (valuation §1).
  • Reporting period alignment: year-on-year against the same quarter, TTM against TTM; when comparing across companies, first list their respective reporting periods.
  • Cash flow vs profit: operating cash flow ÷ net profit persistently < 1 → mark "profit quality to be verified", and look at changes in receivables / inventory (three-statement cross-check).
  • Balance sheet: interest-bearing debt, receivables / inventory growth vs revenue growth (use growth_rate to calculate each once and then compare, do not do mental math).
  • Audit and announcements: annual report audit opinion, differences between earnings forecasts / flash reports and the formal report (fetch_announcements / cninfo_announcements)。

4. Interpretation template ("turn to the latest period, scale to TTM")

Question What to look at calc
Is it accelerating or decelerating? Latest single-quarter non-recurring-adjusted quarter-on-quarter (inflection), single-quarter year-on-year direction, trend over two consecutive quarters qoq、growth_rate
Has the growth materialized? Difference between TTM year-on-year (attributable to parent) and forward CAGR ttm_yoy → valuation's forward_vs_ttm_judgement
How is profit quality? non-recurring-adjusted / attributable-to-parent, operating cash flow / net profit, gross margin trend ratio
How large is the scale? TTM revenue / profit ttm_sum

Five-question self-check (AGENTS.md §1): calculated or mental math? Are there fields pulled that could overturn the conclusion? Source / purpose, same period? Turn vs scale? Have you sought counter-evidence for strong conclusions?

5. Outputs

  • Fact table: metric | value | unit | reporting period | source (ev id)
  • Derived table: basis | value | reporting period | calc id
  • Inference section: seasonality / one-off gains and losses / profit quality / turn judgment (each with basis and confidence)
  • Gaps: which period / line item is missing, which sources were tried, impact on the conclusion

6. What not to do

  • No mental math, no converting units yourself, no making a TTM out of 3 quarters, no using quarter-on-quarter as growth.
  • Do not treat consensus expectations as facts (that is the estimates stage, and it is marked as a forecast).
  • Do not give investment action recommendations.