Influencer Holdings
GET/api/v1.0/quote/influencer/holdingsGet a named person’s public-equity holdings with keyword search, sorting and cursor pagination. Monetary values are in USD.
Parameters
| Parameter | Type | In | Required | Description |
|---|---|---|---|---|
influencer | string | query | yes | Enum: PELOSI, JOSH_GOTTHEIMER, MARJORIE_TAYLOR_GREENE, GIL_CISNEROS, DONALD_TRUMP. |
keyword | string | query | no | Symbol or name keyword. |
sort_field | string | query | no | Sort field, default PERCENT_OF_PORTFOLIO; also SHARES, CHANGE_SHARES, DATE, AMOUNT. |
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 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>" | jqResponse 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. |
data.items[].name | string | Security name. |
data.items[].est_shares | string | Estimated shares. |
data.items[].last_change_est_shares | string | Estimated shares in the latest change; negative means sell. |
data.items[].last_change_date | string | Latest change date, YYYY-MM-DD (US Eastern). |
data.items[].percent_of_portfolio | double | Portfolio weight in percent. |
data.items[].est_position_value | string | Estimated position value (USD). |
pagination.completed | bool | Whether this is the last page; stop only when true. |
pagination.page_flag | string | Next-page cursor. |
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
json
{
"code": 0,
"message": "success",
"data": {
"items": []
},
"pagination": {"completed": true, "page_flag": ""}
}Failure response
json
{
"code": -3,
"message": "invalid parameter",
"trace_id": ""
}