跳到主要内容

目录与日历

目录告诉你什么存在、什么时候交易。本页说明流程；参数与响应字段在 API 文档。

每个目录响应都带 catalog_version、ETag 与 Cache-Control: private, max-age=300。把 ETag 当成 If-None-Match 传回； 目录没变时回 304。

目录端点只需要有效密钥，不需要数据权限，所以是检查密钥最便宜的方法。

交易所与市场​

从 GET /v2/catalog/venues 开始。每个交易所有代码、名称、MIC、时区、国家与 它服务的市场。目前服务的市场整理在数据范围。

curl -s -H "Authorization: Bearer $VEINMESH_API_KEY" \
  "https://data.cyberun.cloud/v2/catalog/venues" \
  | jq '.venues[] | {code, timezone, markets}'

商品​

商品是可交易的分类，例如 SHFE.rb，带乘数与最小跳动。用 GET /v2/catalog/products 列出，可限定交易所。

curl -s -H "Authorization: Bearer $VEINMESH_API_KEY" \
  "https://data.cyberun.cloud/v2/catalog/products?venue=SHFE" \
  | jq '.products[] | {code, name, multiplier, tick_size}'

Instrument​

Instrument 是一个可交易的东西：有到期月的期货、选择权、股票、ETF、基金或 指数。用 GET /v2/catalog/instruments 搜索与分页，或 GET /v2/catalog/instruments/{symbol} 查单一商品。

# 所有上市中的螺纹钢期货
curl -s -H "Authorization: Bearer $VEINMESH_API_KEY" \
  "https://data.cyberun.cloud/v2/catalog/instruments?product=SHFE.rb&kind=future&status=active"

# 单一商品，含它有的数据集
curl -s -H "Authorization: Bearer $VEINMESH_API_KEY" \
  "https://data.cyberun.cloud/v2/catalog/instruments/SHFE.rb2701"

单一商品响应有 instrument、datasets，没有数据时另有 availability。 datasets: [] 且 availability.status: reference_only 代表商品在目录中但还没 有已发布数据，不是错误。

每个 instrument 有：

  • instrument_id：稳定、永不重用；自己的表要用这个键；
  • symbol：查找当时有效的公开代号；
  • kind、venue、product、currency、multiplier、tick_size；
  • 已知时有 listed_day、last_trading_day、expiry；
  • 股票与基金有 board（main、star、chinext、bse、fund）与 risk_warning（none、st、*st）；risk_warning_since 是 veinmesh 第一次观察到当前状态的日期（已知时）；
  • 基金有 fund_type（etf、lof、reit、other）与 tracking_board （main、star、chinext、bse、none）：tracking_board 是涨跌幅规则 适用的板别；none 表示没有 A 股板别（债券、商品、QDII、货币或 REIT 基金）； 未知时不提供；
  • 选择权有 underlying、strike、right、exercise_style；
  • combo 有 legs；
  • aliases 与其有效期间，容纳交易所的特殊写法。

risk_warning 取自交易所公布的简称；它变更时 catalog version 会跟着变。 股票与基金的 listed_day 来自经审阅的公开交易所快照；快照之后新上市的 商品在快照更新前会保持 listed_day: null。基金一律使用 fund 板别，包含 STAR 与创业板追踪基金；涨跌幅规则请读 tracking_board。深市基金以交易所 公布的 20% 涨跌幅基金名单为准：名单内是 star 或 chinext，其余是 main（股票型，10%）或 none（债券、商品、QDII、货币或 REIT，10%）。

代号依日期解析。同一天一个拼法对到两个 instrument 时回 ambiguous_symbol （409）；请用完整代号或 instrument_id。见代号。

连续合约​

GET /v2/catalog/continuous 列出每个期货商品在指定交易日的现行 .main 合约；GET /v2/catalog/continuous/{symbol} 解析单个 SHFE.rb.main 或 .cN。响应带连续 symbol、product、实际 contract 与该合约的 instrument_id。虚拟连续代号不会列在 GET /v2/catalog/instruments 的 instrument 清单里。

curl -s -H "Authorization: Bearer $VEINMESH_API_KEY" \
  "https://data.cyberun.cloud/v2/catalog/continuous?product=SHFE.rb"

分页​

Instrument 清单分页。把响应的 next_cursor 当成 cursor 传回；null 代表 结束。cursor 只属于产生它的筛选条件。

数据集与已准备的交易日​

GET /v2/catalog/datasets 列出每个数据集的分辨率、盘口档数、快照间隔，以及 该交易所已准备的交易日。

curl -s -H "Authorization: Bearer $VEINMESH_API_KEY" \
  "https://data.cyberun.cloud/v2/catalog/datasets?venue=SHFE" \
  | jq '.datasets[] | {dataset, first_day, last_day, depth, resolution}'

first_day 与 last_day 是已发布范围，不是数据源最早日期。范围外的交易日 仍可能在查找时被抓取；见数据范围。

日历​

GET /v2/catalog/calendar 返回区间内每个交易日与其 UTC 时段。要给交易所， 通常也要给商品：同一交易所的不同商品可能有不同时段样板。

curl -s -H "Authorization: Bearer $VEINMESH_API_KEY" \
  "https://data.cyberun.cloud/v2/catalog/calendar?venue=SHFE&product=SHFE.rb&from_day=2026-10-19&to_day=2026-10-23" \
  | jq '.days[] | {trading_day, sessions}'

时段标签是交易所的。night 时段从前一个日历日开始，属于响应中的交易日。不要 假设标签或固定集合；见内核概念。

日历请求有区间上限，见限制；更长的区间请分次查。