Derivatives unusual movements

POST /api/v1.0/quote/{symbol}/unusual/derivatives

Get an unusual-movement summary for one security over the past N calendar days. Supports HK, US, SH, SZ, SG and JP; realtime quote permission for the market is required. When no movement is found, data.code is 1 and data.content is empty. Covers CBBC distribution and options block trades, volatility, volume and price, sentiment and combined signals.

Request parameters

Parameter	Type	Location	Required	Description
symbol	string	path	Yes	Security code in market.symbol format, for example HK.00700.
time_range	integer	body	No	Lookback in calendar days; omitted or nonpositive values use 7. Maximum 365.
language_id	integer	body	No	Response language: 0 Simplified Chinese (default), 1 Traditional Chinese, 2 English, 4 Thai, 5 Japanese.
analysis_dimensions	string[]	body	No	Filter values; omit or pass an empty array for all. warrant_ratio, warrant_price_distribution, option_unusual, option_volatility, option_volume_price, option_sentiment, option_comprehensive (max 7).

Request example

curl -X POST 'https://webapi.moomoo.com/api/v1.0/quote/HK.00700/unusual/derivatives' \
  -H 'Authorization: Bearer <AccessToken>' \
  -H 'Content-Type: application/json' \
  -d '{"time_range": 7, "language_id": 0, "analysis_dimensions": ["warrant_ratio"]}'

Response fields

Parameter	Type	Description
ret_code	integer	Gateway status code; 0 means success.
ret_msg	string	Gateway message.
data.code	integer	Upstream business status: 0 means movements found, 1 means none.
data.message	string	Upstream status or message.
data.time_range	string	Display description of the time range.
data.content	string	Summary text; empty when no movement is found.
error.code	string	Semantic error code on failure.
error.message	string	Error message on failure.

Response example

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "code": 1,
    "message": "",
    "time_range": "",
    "content": ""
  }
}

Error example

{
  "ret_code": -3,
  "ret_msg": "invalid request body",
  "error": {
    "code": "invalid_parameter",
    "message": "invalid request body"
  }
}