Option Chain Statistics

GET /api/v1.0/quote/{code}/option-chain-statistic

Get per-expiry option chain implied volatility (IV), expected move (in currency units), and Call/Put volume summary for an underlying. Also returns the underlying's overall IV and HV (percent). Supported markets: HK / US / JP. Pass index_option_type for index underlyings; omit for equities.

Request

Parameter	Type	In	Required	Description
code	string	path	yes	Option underlying symbol (path param), e.g. US.AAPL / US.TSLA / HK.00700
index_option_type	int	query	no	Index option type (only for index underlyings; omit for equities)

Example

curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/option-chain-statistic?index_option_type=1' \
  -H 'Authorization: Bearer <AccessToken>' | jq

Response

Field	Type	Description
data.items	object[]
data.underlying_iv	number	Underlying overall implied volatility (percent)
data.underlying_hv	number	Underlying overall historical volatility (percent)
data.items[].strike_date	integer	Expiry date YYYY-MM-DD
data.items[].strike_timestamp	integer	Expiry timestamp in seconds
data.items[].product_code	string	Option chain product code
data.items[].iv	number	Implied volatility for this expiry (percent)
data.items[].expected_move	number	Expected Move for this expiry in underlying currency
data.items[].call_volume	string	Total Call volume for this expiry
data.items[].put_volume	string	Total Put volume for this expiry

Errors

ret_code	error.code	Description
0	—	Success
-3	invalid_parameter	Missing or invalid parameter
-7	invalid_symbol	Unknown symbol
-8	unsupported	Market or product is not supported
-9	permission_denied	Missing permission
-10	no_data	No data
-11	rate_limited	Too many requests

Sample

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "underlying_iv": "example",
    "underlying_hv": "example",
    "items": [
      {
        "strike_date": 0,
        "strike_timestamp": 0,
        "product_code": "example",
        "iv": "example",
        "expected_move": "example",
        "call_volume": "example"
      }
    ]
  }
}