Skip to main content
Mainland China Report Timing answers one question: when did a Shanghai-, Shenzhen- or Beijing-listed company’s periodic report first become public? Each observation is one company and one period end, newest first, from 2023 onward, carrying the timestamp of the earliest announcement that published the report.
Plan: Free and above · Credits: 1 per call

What You Can Use China Report Timing For

Build a backtest that only sees A-share numbers after the market did. Measure how long after period end a company reports. Pair each row of Mainland China Financials with the moment it became public.

Why the Date on a Statement Row Is Not Enough

For Asian markets, the date that travels with standardized statement data is routinely the period end, or the date of a later filing that repeated the period as a comparative — not the publication date.A backtest built on that date sees the numbers months before the market did. Use first_announced_at from this endpoint, or disclosed_at on the financials row, which carries the same timestamp.

The Earliest Filing Wins

A periodic report is filed as several announcements — the main text, the summary and sometimes an English version. first_announced_at is the earliest of them, which is the moment the numbers became public. doc_count says how many announcements carried the report, and announcement_id names the one the timestamp came from, so you can look it up in Mainland China Disclosures.

A Midnight Timestamp Is Not a Time

When has_clock_time is false, the index gave a date and no clock — it does this for anything filed on a non-trading day. first_announced_at is then midnight Beijing time, which reads as 16:00Z on the previous day in UTC. That is the absence of a time, not an announcement at 4 p.m.announced_on is the Beijing calendar day and is always safe to use.

Key China Report Timing Fields

Each row carries sec_code, company_id, sec_name, period_end, first_announced_at, announced_on, has_clock_time, doc_count and announcement_id.

China Report Timing Coverage

Coverage runs from 2023-01 onward, the start of the announcement archive, and updates daily.

China Report Timing Sources

Timestamps are read from cninfo, the disclosure site the Chinese securities regulator designates.

GET /v1/companies/{company_id}/cn/report-timing

When each periodic report of one company first became public, 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.
integer
Calendar year of the period end.
integer
default:"40"
Rows per page, between 1 and 200.
See also Mainland China Financials for the numbers these timestamps belong to, and Mainland China Disclosures for every announcement, one row each.