Option Exercise Probability

GET /api/v1.0/quote/{symbol}/option-exercise-probability

Get the exercise probability analysis for an option contract.

Parameters

Name	Type	In	Required	Description
symbol	string	path	yes	Option contract code (must be an option contract, not an underlying stock code), e.g. HK.TCH260528C230000.
limit	int	query	no	Maximum number of records to return, range 1~1000; omit to return full history for the contract.

Request Example

curl 'https://webapi.futunn.com/api/v1.0/quote/HK.TCH260528C230000/option-exercise-probability' | jq

Response Fields

Returns data.item_list[] (time series):

Field	Type	Description
timestamp	int64	Data time (millisecond timestamp).
security_price	float	Underlying price at that time.
strike_probability	float	Exercise probability (percentage, 0-100; e.g. 97.915 means 97.915%).

Supported Markets

• Supported markets: HK / US / JP equity options + HK / US index options.
• Only option contract codes are accepted as input; passing an underlying stock code returns invalid_parameter.
• No date range filtering supported; returns the contract's full history, use limit to get only the latest N records.
• Backend may return fewer than limit records due to data sparsity, which is normal behavior.

Error Codes

ret_code	error.code	Trigger Scenario	Suggested Handling
0	—	Success	—
-3	invalid_parameter	Passed underlying stock code instead of option contract / limit not in 1-1000 / symbol format invalid	Correct request and retry; symbol must be an option contract code
-10	no_data	Backend has no exercise probability data (contract suspended / insufficient data / contract does not exist)	Try a different contract, or verify contract code is valid
-9	permission_denied	User lacks option data query permission	Contact account manager to enable option permissions
-4	internal_error	Backend internal error	Retry; if persistent, contact backend team

Response Example

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