跳至主要内容

代號

每個商品都叫 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 用於顯示與請求。