Influencer Holding Changes

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

Get a named person’s disclosed holding trades with optional symbol and side filters, sorting and cursor pagination. Dates use US Eastern time.

Parameters

Parameter	Type	In	Required	Description
influencer	string	query	yes	Enum: PELOSI, JOSH_GOTTHEIMER, MARJORIE_TAYLOR_GREENE, GIL_CISNEROS, DONALD_TRUMP.
symbol	string	query	no	Filter one symbol, e.g. US.NVDA.
direction	string	query	no	Side filter: BUY or SELL.
sort_field	string	query	no	Sort field, default DATE; also AMOUNT, PERCENT_OF_PORTFOLIO, SHARES, CHANGE_SHARES.
sort_dir	string	query	no	Sort direction, default DESCENDING; or ASCENDING.
page_flag	string	query	no	Cursor; omit on the first page and pass back pagination.page_flag.
page_size	int	query	no	Page size, default 20, max 100.

Request Example

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

Response Fields

Field	Type	Description
code	int	0 for success; non-zero business error code.
message	string	success on success; error text on failure.
trace_id	string	Request trace ID returned on failure.
data.items[].code	string	Symbol; empty when no matching security is found.
data.items[].name	string	Security name.
data.items[].direction	string	BUY or SELL.
data.items[].change_content	string	Disclosed amount band.
data.items[].description	string	Transaction description.
data.items[].stock_type	string	STOCK, OPTION, ETF or BOND.
data.items[].change_ratio	double	Change ratio in percent.
data.items[].date	string	Trade date, YYYY-MM-DD (US Eastern).
data.items[].notify_date	string	Notification date, YYYY-MM-DD (US Eastern).
pagination.completed	bool	Whether this is the last page; stop only when true.
pagination.page_flag	string	Next-page cursor.
data.timezone	string	Timestamp timezone, IANA name.
data.background_image	string	Background image URL, when present.

Error Codes

code	message	trace_id	Trigger
0	success	—	Success; no matches return an empty list.
-3	invalid parameter	Returned by the API	Correct the parameters and retry.

Response Example

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

Failure response

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