/api/health.
/api/seed-health reports whether the China coverage evaluator itself ran
recently; a fresh evaluator heartbeat does not prove healthy China content.
Coverage inventory
Health projection registry
The China health projection tracks these stable contracts.launched means the
lane is admitted to the China projection; it does not override the lane’s live
freshness or content status.
JODI remains available to existing global energy products. Its China oil and
gas contracts stay blocked because the reviewed upstream country index does not
currently publish substantive
CN rows. A healthy global JODI heartbeat
therefore cannot be presented as China coverage.
Detailed method and source contracts:
- Official macro and policy
- Corporate disclosures
- Logistics corridors
- Cross-domain decision signals
- Activity nowcast methodology
- Shared provenance contract
Status and missingness
Source arrival is not the same as usable content. China health evaluates transport freshness and content freshness separately. A successful request can still publish stale, partial, empty, or timestamp-unknown content. The public contracts use explicit states:availableorhealthymeans the required payload passed its domain validation and freshness rules;partialordegradedmeans some reviewed coverage is missing, stale, or invalid while other evidence remains usable;stalemeans the last valid observation is outside its content budget;unavailablemeans no usable observation can be published; andblockedmeans a source was deliberately not launched, normally because robots, terms, transport, or source-substance review did not pass.
Stock Connect turnover and margin
Four official exchange endpoints composemarket:china:stock-connect:v1. They
sit on the two exchange hosts already covered by the corporate-disclosure terms
review, and all four are admitted as admitted_aggregate_statistics: public
aggregate market statistics only, with no per-investor and no per-order data.
The reviewed terms records are the same ones the disclosure lane uses: SSE
official legal terms, robots.txt not
published (404); SZSE
applicable rules and notices,
robots.txt present but empty (200).
Northbound net flow is not available, because this source does not publish it.
Both exchanges stopped disclosing the northbound buy and sell split on
2024-08-16, so only gross turnover survives. The payload states that directly:
northbound.netFlow is
{ status: 'unavailable', reason: 'EXCHANGE_STOPPED_PUBLISHING_BUY_SELL_SPLIT' },
alongside netFlowDiscontinuedOn: '2024-08-16'. Turnover is two-way trading
activity, buys and sells counted together. It is not capital entering or leaving
the mainland market and must never be read as a flow.
The rest of the contract:
- every published value is normalized to CNY. SSE quotes margin in yuan; every other figure arrives in 亿 (1e8) or 万 (1e4) and is converted;
- a combined SSE and SZSE figure is published only when both exchanges report
the same trade date. Otherwise the combined value degrades with reason
TRADE_DATE_MISMATCH, which doubles as the freeze detector: one exchange that stops advancing is visible immediately instead of after a staleness budget expires; - margin publishes on a T+1 lag, and northbound publishes after each session closes;
- SZSE endpoints are date-keyed, so the seeder pins the date from the exchange
trading calendar
(
https://www.szse.cn/api/report/exchange/onepersistenthour/monthList) and probes back a bounded number of trading days; and - the lane runs hourly as a member of the
seed-bundle-market-backupRailway bundle.
Bilateral HS4 import baskets
The bilateral store covers the 20 reviewedbilateralHs4Code entries in
scripts/shared/comtrade-strategic-products.json. Each country shard contains
annual imports by HS4 product and the leading exporter partners. It supports
country exposure, route impact, multi-sector shock, and the PRO
get-country-products route. Detailed bilateral rows are not part of the
anonymous China summary.
The authenticated Comtrade route sends one four-year period window, Y-2
through Y-5, for each of the two HS4 batches. The normalizer keeps the newest
year per product-and-partner pair, so a response cannot silently mix annual
values. When COMTRADE_API_KEYS is absent, the public preview route cannot
accept a period list and instead tries Y-2 followed by Y-3.
The scheduled production contract is deliberately quota-bound:
A run below the 110-shard floor writes
partial seed metadata rather than
claiming full success. Failed reporters preserve an existing shard for at most
two consecutive runs; after that, the shard may expire so the on-demand public
fallback can probe it again. Rate limits, quota exhaustion, and request-budget
exhaustion publish partial coverage and stop the run instead of overwriting
last-good country data with empty payloads.
Access boundaries
- Country summary, corridor conditions, decision-signal summaries, provenance, and aggregate health are available through bounded public surfaces.
- Detailed corridor control towers and activity-nowcast evidence are REST/UI
surfaces. MCP does not expose dedicated tools for either route; Pro MCP
receives their bounded summaries through
get_china_decision_signals. - Pro MCP reads the canonical macro and release-calendar caches through
get_economic_datawith datasetchina-macroorchina-release-calendar. - Detailed bilateral HS4 product rows and route exposure are PRO-only.
- The Pro MCP decision-signal tool receives the same bounded items and provenance as the public composition, not raw exchange documents or unrestricted source expansion.
- Proxy credentials, raw per-attempt request diagnostics, cache names, and detailed freshness thresholds remain operator-only. Public documentation names the configuration keys and selection semantics, not their values.
