期權行權概率

GET /v1/quote/{symbol}/option-exercise-probability

獲取期權合約的行權概率分析。

請求參數

參數	類型	位置	必填	說明
symbol	string	路徑	是	期權合約代碼（必須是期權合約，不能傳正股代碼），例 HK.TCH260528C230000。
limit	int	查詢	否	最大返回條數上限，範圍 1~1000；不填返回合約全部歷史。

請求示例

curl '$ip/v1/quote/HK.TCH260528C230000/option-exercise-probability' | jq

響應字段

返回 data.item_list[]（時間序列）：

字段	類型	說明
timestamp	int64	數據時間（毫秒時間戳）。
security_price	float	標的當時價格。
strike_probability	float	行權概率（百分數，0-100；如 97.915 表示 97.915%）。

限制範圍

• 支持市場：HK / US / JP 正股期權 + HK / US 指數期權。
• 僅支持期權合約代碼作為入參；傳入正股代碼會返回 invalid_parameter。
• 不支持區間篩選；按合約整段歷史返回，僅可用 limit 截取最新 N 條。
• 後端因數據稀疏可能返回少於 limit 條數據，屬正常現象。

錯誤碼

ret_code	error.code	觸發條件	處理建議
0	—	成功	—
-3	invalid_parameter	傳正股代碼而非期權合約 / limit 不在 1-1000 / symbol 不符合格式	校正請求後重試；symbol 必須傳期權合約代碼
-10	no_data	後端無可用行權概率數據（合約停牌 / 數據不足 / 合約不存在）	換合約重試，或確認合約代碼合法
-9	permission_denied	用戶無期權數據查詢權限	聯繫賬戶負責人開通期權權限
-4	internal_error	後端內部錯誤	重試；持續失敗請聯繫後端

響應示例

{
  "ret_code": 0,
  "data": {
    "item_list": [
      {
        "timestamp": 1779465600000,
        "security_price": 441.4,
        "strike_probability": 97.915
      }
    ]
  }
}