知名人士持倉變動

GET /api/v1.0/quote/influencer/holding-change

獲取指定知名人士的持倉買賣披露，支援標的、方向、排序和游標分頁。日期為美東日期。

請求參數

參數	類型	位置	必填	說明
influencer	string	查詢	是	知名人士枚舉：PELOSI、JOSH_GOTTHEIMER、MARJORIE_TAYLOR_GREENE、GIL_CISNEROS、DONALD_TRUMP。
symbol	string	查詢	否	按單只標的篩選，如 US.NVDA。
direction	string	查詢	否	買賣方向：BUY 或 SELL。
sort_field	string	查詢	否	排序欄位，預設 DATE；可選 AMOUNT、PERCENT_OF_PORTFOLIO、SHARES、CHANGE_SHARES。
sort_dir	string	查詢	否	排序方向，預設 DESCENDING；可選 ASCENDING。
page_flag	string	查詢	否	翻頁標記；首頁不傳，下一頁回傳 pagination.page_flag。
page_size	int	查詢	否	返回條數，預設 20，最大 100。

請求示例

curl -s "https://webapi.moomoo.com/api/v1.0/quote/influencer/holding-change?influencer=PELOSI&page_size=20" \
  -H "Authorization: Bearer <AccessToken>" | jq

響應欄位

欄位	類型	說明
code	int	成功為 0；失敗為非 0 業務錯誤碼。
message	string	成功時為 success；失敗時為錯誤訊息。
trace_id	string	失敗時由接口返回的請求追蹤 ID。
data.items[].code	string	標的代碼；未找到對應證券時為空。
data.items[].name	string	標的名稱。
data.items[].direction	string	BUY 或 SELL。
data.items[].change_content	string	披露金額區間。
data.items[].description	string	交易描述。
data.items[].stock_type	string	STOCK、OPTION、ETF 或 BOND。
data.items[].change_ratio	double	變動比例（百分數）。
data.items[].date	string	調整日期，YYYY-MM-DD（美東）。
data.items[].notify_date	string	通知日期，YYYY-MM-DD（美東）。
pagination.completed	bool	是否已到末頁；只有 true 時停止翻頁。
pagination.page_flag	string	下一頁標記。
data.timezone	string	時間戳時區，IANA 標識。
data.background_image	string	背景圖 URL（如有）。

錯誤碼

code	message	trace_id	觸發條件
0	success	—	成功；無匹配時返回空列表。
-3	invalid parameter	由接口返回	校正參數後重試。

響應示例

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "timezone": "America/New_York"
  },
  "pagination": {"completed": true, "page_flag": ""}
}

失敗響應

{
  "code": -3,
  "message": "invalid parameter",
  "trace_id": ""
}