v1 (retired)
The previous data APIs under /v1 are retired and frozen. They receive no fixes
and no new data, and their data reference pages are no longer maintained. Every
/v1 response carries Deprecation: true, Sunset: Wed, 31 Mar 2027 00:00:00 GMT
and a Link: </docs/v1>; rel="deprecation" header; the routes are removed after
that date.
Administration endpoints under /v1 are still the current way to manage
principals, keys and usage policies. See Administration.
What replaced what
| v1 | Now |
|---|---|
Series list, /v1/query, /v1/series | /v2/data for book snapshots; /v2/bars for K-lines |
/v1/stream | /v2/stream |
/v1/exports | /v2/exports |
| A-share Level-2 orders and trades | No direct replacement. /v2 serves book snapshots for SSE and SZSE stocks and ETFs |
| Cryptocurrency series | Ended |
/v2/whoami | Moved; the /v1/whoami alias remains until the sunset date |
/v2/admin/principals, /v2/admin/keys, /v2/admin/quota/policies | Moved; the /v1 aliases remain until the sunset date |
The markets and datasets served today are on Data coverage; the API is the authority.
Moving to v2
- Key and authentication do not change:
Authorization: Bearer vmk_.... - The base path changes from
/v1to/v2for data. - Symbols are veinmesh symbols such as
SHFE.rb2701,CZCE.AP2610andSSE.600000; see Symbols. - Ask your administrator for the
book_snapshotkind,history,live,exportand book depth you need. - Start with the quickstart or Market data.
Old /docs/*.html links and v1 data pages are intentionally not redirected.