Unusual Whales UnusualWhales API

Politician Portfolio Holders by Ticker

GET https://api.unusualwhales.com/api/politician-portfolios/holders/{ticker}

Request

Security: Bearer Auth Authorization: Bearer <token>

Path Parameters

ticker string required

Stock ticker symbol (e.g., AAPL, TSLA)

Query Parameters

aggregate_all_portfolios boolean optional

If true, aggregates all of a politicians portfolios into a single portfolio named 'aggregated'. Default is false. Note that this does not aggregate holdings within a portfolio, only across portfolios.

Responses

200 422 500

Response Body 200 OK

full_name string

The politician's name.

Example: Zoe Lofgren
id string

The portfolio ID.

Example: 5fbe81ac-1157-4bc8-9d76-c77e6164fe25
max_amount number

The portfolio's maximum share quantity.

Example: 143
mid_amount number

The portfolio's midpoint share quantity.

Example: 76
min_amount number

The portfolio's minimum share quantity.

Example: 9
owner string

The portfolio owner's name.

Example: self
Try It GET
Path Parameters
Query Parameters

Request Sample
curl -X GET "https://api.unusualwhales.com/api/politician-portfolios/holders/{ticker}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
Response Example 200
{
  "data": [
    {
      "full_name": "Zoe Lofgren",
      "id": "5fbe81ac-1157-4bc8-9d76-c77e6164fe25",
      "max_amount": 143,
      "mid_amount": 76,
      "min_amount": 9,
      "owner": "self"
    },
    {
      "full_name": "Zoe Lofgren",
      "id": "9d28365f-7559-417b-ba26-102cefde89eb",
      "max_amount": 2386,
      "mid_amount": 1670,
      "min_amount": 954,
      "owner": "spouse"
    }
  ]
}