Skip to content

Influencer Holdings ​

GET /api/v1.0/quote/influencer/holdings

Get a named person’s public-equity holdings with keyword search, sorting and cursor pagination. Monetary values are in USD.

Parameters ​

ParameterTypeInRequiredDescription
influencerstringqueryyesEnum: PELOSI, JOSH_GOTTHEIMER, MARJORIE_TAYLOR_GREENE, GIL_CISNEROS, DONALD_TRUMP.
keywordstringquerynoSymbol or name keyword.
sort_fieldstringquerynoSort field, default PERCENT_OF_PORTFOLIO; also SHARES, CHANGE_SHARES, DATE, AMOUNT.
sort_dirstringquerynoSort direction, default DESCENDING; or ASCENDING.
page_flagstringquerynoCursor; omit on the first page and pass back pagination.page_flag.
page_sizeintquerynoPage size, default 20, max 200.

Request Example ​

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

Response Fields ​

FieldTypeDescription
codeint0 for success; non-zero business error code.
messagestringsuccess on success; error text on failure.
trace_idstringRequest trace ID returned on failure.
data.items[].codestringSymbol.
data.items[].namestringSecurity name.
data.items[].est_sharesstringEstimated shares.
data.items[].last_change_est_sharesstringEstimated shares in the latest change; negative means sell.
data.items[].last_change_datestringLatest change date, YYYY-MM-DD (US Eastern).
data.items[].percent_of_portfoliodoublePortfolio weight in percent.
data.items[].est_position_valuestringEstimated position value (USD).
pagination.completedboolWhether this is the last page; stop only when true.
pagination.page_flagstringNext-page cursor.

Error Codes ​

codemessagetrace_idTrigger
0success—Success; no matches return an empty list.
-3invalid parameterReturned by the APICorrect the parameters and retry.

Response Example ​

json
{
  "code": 0,
  "message": "success",
  "data": {
    "items": []
  },
  "pagination": {"completed": true, "page_flag": ""}
}

Failure response ​

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