期權鏈

GET /v1/quote/{symbol}/option-chain

獲取指定正股在指定到期日範圍內的期權鏈。

請求參數

參數	類型	位置	必填	說明
symbol	string	路徑	是	期權標的代碼，例 HK.00700、US.AAPL、HK.800000（恒指）。
start	string	查詢	否	起始到期日 yyyy-MM-dd（含），不傳則不限下界。
end	string	查詢	否	結束到期日 yyyy-MM-dd（含），不傳則不限上界。
index_option_type	int	查詢	否	指數期權類型，僅指數標的需傳，普通正股不傳。詳見命名詞典。
filter_standard	string	查詢	否	按標準/非標準期權過濾，默認 ALL。詳見命名詞典。

請求示例

curl '$ip/v1/quote/HK.00700/option-chain?start=2026-05-01&end=2026-05-31' | jq

響應字段

返回 data.option_chain[]，每元素一個 CALL 或 PUT 合約：

字段	類型	說明
code	string	期權合約代碼，例 HK.TCH260528C230000。
stock_id	uint64	期權合約內部數值 ID。
name	string	合約名稱，例 腾讯 260528 230.00 购。
lot_size	int	每手合約股數，例 100。
stock_type	string	證券類型，期權合約固定 DRVT。
option_type	string	期權方向：CALL / PUT。
stock_owner	string	標的股代碼，例 HK.00700。
strike_time	string	行權日 yyyy-MM-dd。
strike_price	number	行權價（已還原為真實數值）。
index_option_type	string	指數期權類型：NORMAL / SMALL / N/A。
expiration_cycle	string	到期週期。詳見命名詞典。
option_standard_type	string	期權規格類型：STANDARD / NON_STANDARD / N/A。

限制範圍

• 支持市場：HK / US / JP；其他市場返回 ret_code=-8 unsupported。
• 指數標的必須傳 index_option_type；普通正股不傳該參數。
• 後端單次查詢最多返回 20 個到期日（按時間近優先）；如需更多到期日，請按 start / end 區間分段拉取。

錯誤碼

ret_code	error.code	觸發條件	處理建議
0	—	成功	—
-3	invalid_parameter	symbol / start / end / index_option_type / filter_standard 取值不合法	校正請求參數後重試
-7	invalid_symbol	路徑 symbol 在證券庫查不到	通過搜索接口確認代碼合法性
-8	unsupported	symbol 市場不在 HK / US / JP	該市場不支持期權鏈，無需重試
-10	no_data	合法標的但當前區間內無任何期權合約（含過濾後為空）	視為該標的當前區間無期權數據
-5	internal_error	網關內部錯誤 / 後端調用失敗 / 超時	稍後重試或聯繫平台

響應示例

{
  "ret_code": 0,
  "ret_msg": "",
  "data": {
    "option_chain": [
      {
        "code": "HK.TCH260528C230000",
        "stock_id": 81210697,
        "name": "腾讯 260528 230.00 购",
        "lot_size": 100,
        "stock_type": "DRVT",
        "option_type": "CALL",
        "stock_owner": "HK.00700",
        "strike_time": "2026-05-28",
        "strike_price": 230,
        "index_option_type": "N/A",
        "expiration_cycle": "MONTH",
        "option_standard_type": "STANDARD"
      }
    ]
  }
}