期权行权概率

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
curl '$ip/v1/quote/HK.TCH260528C230000/option-exercise-probability?limit=10' | 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
      }
    ]
  }
}