衍生品异动摘要

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

获取单一标的近 N 个自然日的异动摘要。支持 HK、US、SH、SZ、SG、JP，需具备对应市场实时行情权限。窗口内无异动时 data.code 为 1、data.content 为空字符串。 涵盖牛熊证街货比例与分布，以及期权大单、波动率、量价、情绪和综合信号。

请求参数

参数	类型	位置	必填	说明
symbol	string	路径	是	标的代码，格式为市场.代码，例如 HK.00700。
time_range	integer	请求体	否	回溯自然日天数；不传或小于等于 0 时按 7 处理，最大 365。
language_id	integer	请求体	否	结果语言：0 简体中文（默认）、1 繁体中文、2 英语、4 泰语、5 日语。
analysis_dimensions	string[]	请求体	否	筛选项；不传或空数组表示全部。 warrant_ratio, warrant_price_distribution, option_unusual, option_volatility, option_volume_price, option_sentiment, option_comprehensive (max 7).

请求示例

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"]}'

响应字段

参数	类型	说明
ret_code	integer	网关状态码，0 表示成功。
ret_msg	string	网关提示信息。
data.code	integer	下游业务状态：0 有异动，1 无异动。
data.message	string	下游状态或提示文案。
data.time_range	string	展示用时间区间说明。
data.content	string	异动正文；无异动时为空字符串。
error.code	string	失败时的语义错误码。
error.message	string	失败时的错误信息。

响应示例

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

失败示例

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