Option Volatility Smile

GET /api/v1.0/quote/{symbol}/option-iv-smile

Get the option Implied Volatility Smile curve across strike prices for a specified (or nearest upcoming) expiry date. Uses expire_time to select the expiry date, or the nearest unexpired date when omitted. Returns Call IV, Put IV, and Average IV (percent) by strike price. Supported markets: US / HK / JP.

Request

Parameter	Type	In	Required	Description
symbol	string	path	yes	Option underlying symbol (path param), e.g. US.TSLA / US.AAPL / HK.00700
expire_time	string	query	no	Target expiry date yyyy-MM-dd; omit to automatically pick the nearest available expiry
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-iv-smile?expire_time=1&index_option_type=1' \
  -H 'Authorization: Bearer <AccessToken>' | jq

Response

Field	Type	Description
data.items	object[]
data.items[].strike_price	string	Strike price (divided by 1e9)
data.items[].strike_date	integer	Expiry date YYYY-MM-DD
data.items[].call_iv	number	Call implied volatility (percent)
data.items[].put_iv	number	Put implied volatility (percent)
data.items[].avg_iv	number	Average implied volatility (percent)

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": {
    "items": [
      {
        "strike_price": "example",
        "strike_date": 0,
        "call_iv": "example",
        "put_iv": "example",
        "avg_iv": "example"
      }
    ]
  }
}