OPEN DATA · VERSION 1.9.6
Open futures reference data
Download contract specifications, expiry events, regular trading sessions and the China access matrix for overseas participants. Records include sources, review dates and page links for research, spreadsheets and application integration.
Latest contract record review: 2026-10-26 (records retain individual dates) · release 1.9.6
- Contracts
- 101
- Expiry events
- 531
- Live products
- 95
- Data version
- 1.9.6
01 · DOWNLOADS
9 stable downloads, no API key required
Use JSON for applications and CSV for Excel, Google Sheets or analysis. Every endpoint supports cross-origin browser requests.
Futures Clock contract specifications (JSON)
Bilingual contract specifications, sessions, expiry rules, sources, and pages.
Open or download JSON →Futures Clock contract specifications (CSV)
Spreadsheet-friendly contract specification records.
Open or download CSV →Futures Clock expiry events (JSON)
Upcoming last-trade and first-notice dates for the nearest indexed contract months, computed from verified exchange rules; rolls forward on each deploy with an asOf date and a nextByProduct index.
Open or download JSON →Futures Clock expiry events (CSV)
Spreadsheet-friendly upcoming expiry event records; rolls forward on each deploy.
Open or download CSV →Futures Clock trading hours (JSON)
Regular sessions and reviewed calendar coverage for live-linked products.
Open or download JSON →Futures Clock China access matrix (JSON)
Whole-market futures registry, independent specified/QFI route counts, effective dates and sources in market; site-detail subset in products.
Open or download JSON →China access site-detail subset (CSV)
Site-detail subset only, one row per covered futures product; whole-market counts are in the JSON market field.
Open or download CSV →Whole-market China futures access registry (CSV)
All listed mainland Chinese futures products, with independent route status, effective dates, review dates and source references. Excludes options.
Open or download CSV →Futures Clock trading hours (CSV)
One row per regular session for each live-linked product.
Open or download CSV →02 · QUICK START
Three lines, no SDK
const response = await fetch('https://futuresclock.com/data/contracts.json');
const { datasetVersion, dataReviewed, contracts } = await response.json();
console.log(datasetVersion, dataReviewed, contracts[0]);Download runnable example: whole-market access summary (Node.js)
Download runnable example: contract key dates and evidence
Key-date samples preserve accepted records for six products, including historical months; they are not complete annual calendars.
Responses include Access-Control-Allow-Origin: *. Static files ship with reviewed releases; inspect datasetVersion, schemaVersion and dataReviewed before use.
Platform copies are versioned snapshots, not automatically refreshed feeds. Expiry events may be historical. An empty filter does not prove there are no exchange expiries: check coverage and official notices.
03 · DATA DICTIONARY
5 datasets, one fact scope each
| Dataset | Core fields | Use and boundary |
|---|---|---|
| contracts | exchange · code · size · tick · tickValue · expiryRule · sourceUrl | Bilingual specifications and rule descriptions. |
| expiries | asOf · nextByProduct · symbol · kind · date · evidence · unresolvedEvents | Upcoming LTD/FND events, recomputed from exchange rules on every deploy (currently as of 2026-10-27); nextByProduct gives each product's next last-trade and first-notice day; event evidence separates official checks, calculations and estimates. Legacy estimated is a conservative compatibility flag; use evidence.state. |
| trading-hours | timeZone · tradingDays · open · close · dayOffset · validFrom · validTo | Regular session templates; no live prices. |
| china-access | route · specified · qfi · settlement · deliveryReach · sourceUrls · verified | Access and delivery reachability for overseas traders and QFIs; states notices, not eligibility conclusions. |
| china-access-market | snapshot_as_of · id · specified_status · qfi_status · effective_from · source_urls | Whole-market futures CSV; absence from reviewed lists and unknown are distinct. No participant eligibility determination. |
04 · VERSION, FRESHNESS & LICENSE
Check version and review date before use
Access registry 1.4.0 → 1.9.6: 0 added, 0 removed, 0 records changed. This release adds a download format; that does not imply a policy change. Inspect differences · Original baseline
- 1.9.6Current dataset release version for content publication.
- 1.2.0Current schema version; bumped separately for breaking field changes.
- status · status_reason · source_published_at · last_verified_atEvery fact row carries these four fields (status is verified, provisional or unknown) and every file carries generated_at; product pages print the same values. The legacy estimated flag stays: it is true for a provisional status with the reason rule_derived or estimated.
- 2026-10-26Latest contract record review, not a same-day review of every field. Read each record’s verified and per-event evidence.
- CORSAll JSON/CSV endpoints allow cross-origin reads without an API key.
- DOIArchived version 1.3.0 (current 1.9.6 not yet archived): 10.5281/zenodo.23031490. Cite it with the version number.
The license covers only Futures Clock’s original compilation, schema, formatting and documentation. It does not claim exchange facts or official materials. Attribute futuresclock.com when reusing it; links may use rel="nofollow" because attribution records provenance only.
Read the full data license → · Review sources, freshness and corrections →
The license above already permits reuse with attribution to futuresclock.com. For attribution-free use and change alerts, see Markets Open Pro ↗.
These datasets are not quotes, trading signals or investment advice. Open each record’s sourceUrl and verify the latest exchange notice before trading.
05 · USE OUR DATA
Use our data: license, credit and data services
What you may do
You may reuse the data, including commercially, under the Futures Clock compilation license with attribution to futuresclock.com. Covered: Futures Clock’s compilation, schema, formatting and documentation. Not covered: exchange facts, official notices and source materials, which stay with their publishers.
How to credit
Use these two lines:
Futures Clock (futuresclock.com), datasetVersion 1.9.6 · https://futuresclock.com/en/data/
Separate archive 1.3.0: doi:10.5281/zenodo.23031490 (use only when citing that archive)The DOI identifies archived version 1.3.0; the current 1.9.6 is not archived yet. State the version you actually used.
Change alerts and attribution-free use
Markets Open Pro sends alerts when exchanges confirm holiday or trading-hour changes, and includes attribution-free use: See Markets Open Pro ↗
Using our JSON in production?
Identify your client in the User-Agent with a contact URL or email, for example YourApp/1.0 (+https://example.com/contact). Clients without a contact are not blocked or throttled. For change alerts, see Markets Open Pro ↗. Questions about the data: hello@futuresclock.com.
06 · FORWARD & EMBED
Forward, embed or subscribe: copy and paste
Embed the live market-status card
<iframe src="https://futuresclock.com/en/embed/status/" title="Global futures market status · Futures Clock" width="100%" height="320" loading="lazy" style="border:0;max-width:720px" referrerpolicy="strict-origin-when-cross-origin"></iframe>
<p><a href="https://futuresclock.com/">Futures hours by Futures Clock</a></p>Credit line when you pass on data or a screenshot
Futures Clock (futuresclock.com), datasetVersion 1.9.6 · https://futuresclock.com/en/data/
Separate archive 1.3.0: doi:10.5281/zenodo.23031490 (use only when citing that archive)Subscribe to China futures closures
One calendar feed for all six exchanges (SHFE, INE, DCE, CZCE, GFEX, CFFEX) that updates when they publish new dates. Published by our sister site Markets Open under its own licence: https://marketsopen.today/calendars/china-futures.ics