衍生品異動摘要

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