Skip to main content
Mainland China Financials serves the financial statements of companies listed in Shanghai, Shenzhen and Beijing, newest period first. Each observation is one company, one period end and one statement, with typed headline columns beside the source’s own summary fields. Coverage is about 5,600 A-share companies from 2023 Q1 onward, amounts in CNY.
Plan: Free and above · Credits: 1 per call

​
What You Can Use China Financials For

Track revenue and profit for an A-share company period by period. Compare companies across the mainland market. Read the derived ratios the company screen ranks on, for the same company, in the same call.

​
The Half-Year and Q3 Reports Are Cumulative

The A-share reporting cadence is annual (年报), half-year (中报), Q1 (一季报) and Q3 (三季报). report_type names which one a row came from. There is no Q2 or Q4 report, and Q1 and Q3 are unaudited.The half-year and Q3 figures are cumulative year-to-date — six and nine months from 1 January, not a quarter. A single quarter is one report minus the previous one: Q3 is 三季报 minus 中报, Q4 is 年报 minus 三季报. Reading 三季报 revenue as Q3 overstates it about threefold.
A-share fiscal years are calendar years, so year is unambiguous here.

​
Every Row Today Is Aggregated Data

source says what evidence stands behind a row. Today it is aggregated on every row: standardized statement data with no document reference — no filing URL and no page number to check a figure against. filing is an accepted value because a leg read from the reports themselves is planned. When it exists, the endpoint will prefer it.

​
Use disclosed_at for Anything Point-in-Time

Each row carries two dates, and only one of them is the publication date.disclosed_at is when the report first became public, read off the regulator-designated disclosure index. announcement_id names that filing, and has_clock_time false means the index gave a date without a clock, so the midnight time is absence, not a time.announced_on ships with the aggregated data and is not a publication date. It is later than the real one on most income and cash-flow rows — it tracks the newest filing that repeated the period as a comparative.Mainland China Report Timing answers the same question one row per period, without the numbers.

​
What the data Field Holds

The typed columns — revenue, operating_profit, net_profit, net_profit_incl_nci, total_assets, total_liabilities, total_equity, ocf — are the headline lines only, and each is filled on the statement it belongs to. data holds the source’s summary fields verbatim, about 46–57 field codes per row — not every account. It has no R&D, no EPS and no minority-interest lines, so do not report those as undisclosed. Total equity in this dataset includes minority interests; there is no parent-only equity here. org_type is the source’s industry name (128 values, for example 汽车零部件), not a reporting template. It does not tell you which chart of accounts a row uses — though banks, insurers and brokers do file different lines from industrials, so compare revenue across those with care.

​
The metrics Block Is the Latest Period Only

The response carries a top-level metrics block: margins, returns, liquidity, efficiency, leverage and year-on-year growth — the same numbers the company screen filters and sorts on.
  • It describes one period, the latest, named in metrics.period. It does not move with the year or period_end filters on the rows beside it.
  • metrics.amounts are in whole units of metrics.currency.
  • metrics.ratios are fractions (0.2 is 20%), except days_sales_outstanding and operating_cycle, which are days.
  • For A-shares, return_on_invested_capital, debt_to_equity, payout_ratio, ebitda and the four liquidity ratios are always null, because the source publishes no debt total, dividend, share count, depreciation line or current-asset and current-liability totals.
metrics: null means we hold no fundamentals for the company at all — a different fact from a null field inside it.

​
China Financials Coverage

Coverage is about 5,600 A-share companies from 2023 Q1 (period end 2023-03-31) onward, updated quarterly.

​
China Financials Sources

Standardized statement data for companies listed on the Shanghai, Shenzhen and Beijing exchanges. Publication timestamps come from cninfo, the disclosure site the Chinese securities regulator designates.

​
GET /v1/companies/{company_id}/cn/financials

Statements for one mainland-listed company, newest period first.
​
string
required
A six-digit security code (600519), a suffixed ticker (600519.SS, 000333.SZ, 920680.BJ), an ISIN or a company_id.
​
string
income, balance or cashflow. Omit for all three.
​
string
filing or aggregated. Omit to let the endpoint prefer filing where it exists.
​
integer
Calendar year of the period end.
​
string
Exact period end, YYYY-MM-DD — 2026-06-30 is a half-year report.
​
integer
default:"40"
Rows per page, between 1 and 200. Page through with cursor.
See also Mainland China Report Timing for when each report became public, Mainland China Disclosures for the announcements themselves, Hong Kong Financials for the ~148 companies listed in both places, and Screen Companies by Fundamentals for the cross-market ratios.