跳到主要内容

代号

每个商品都叫 VENUE.code。交易所代码在前，后面是 veinmesh 的标准形式，即使 交易所自己写得不一样。形状由交易所决定，不是全产品一套规则。

代号依日期解析：同一个拼法在不同年份可能指向不同合约，重要时请传 as_of。

期货​

目前服务的中国期货交易所，有到期月的期货是商品加四位年月：

  • SHFE.rb2701：螺纹钢，2027 年 1 月交割；
  • CZCE.AP2610：苹果，2026 年 10 月。交易所写 AP610；标准形式一律四位， AP610 是该合约交易期间有效的别名；
  • DCE.l2602F：交易所同一月份有第二个合约时，保留字母后缀。

没有月份的产品是 VENUE.product，例如 SHFE.rb。

其他交易所有自己的月份格式。不要把四位数字规则套到不使用的交易所；请以目录 为准。

选择权​

期货交易所的选择权是标的串行、C 或 P、履约价（去掉尾零）：

  • SHFE.rb2701-C-3000；
  • DCE.a2611-MS-C-4250：同一期货有多个选择权串行时，保留交易所的串行标签。

交易所挂牌的股票选择权用交易所的数字代码，例如 SSE.10011425。标的、履约价 与买卖权都是目录返回的 instrument 字段，不必自己拆代码。

股票、ETF、基金与指数​

这些用交易所代码：股票 SSE.600000、ETF SZSE.159915、指数 SSE.000300。基金或指数可能在目录里但没有已发布数据集；见 数据范围。

交易所组合​

组合是 VENUE.<type>.<leg>&<leg>，每条 leg 不带交易所前缀，顺序照交易所， 例如 DCE.SP.a2611&a2701。

连续合约​

连续合约代表一连串有到期月的合约：

  • SHFE.rb.main 是主力合约；
  • SHFE.rb.c1、.c2… 是从最近开始算的第 1、2… 个仍在交易的合约；
  • 定义到 .c12。

对目前服务的中国期货交易所，main 是前一交易日收盘持仓量最大的合约；前一个 主力仍在交易时会延续。这是那些市场的规则，不是通用定义。

连续 K 线在 contract 字段回报实际使用的合约。用 adjust=diff 或 ratio 把换月前后的价格接平；最近一段保留真实价格。连续合约要用 from_day 与 to_day，不能用时间点。

别名与身分​

交易所的特殊写法（例如 CZCE 的三位年份）可以当别名，依日期解析。同一天一个 拼法对到两个商品时回 ambiguous_symbol（409）。

自己的表请用 instrument_id：它永不变更、永不重用。symbol 用于显示与请求。