# Top Shareholders

`GET` `/v1/quote/shareholders/top`

Get the top 20 major shareholders (institutional, individual, and insider) for a listed company, with support for multi-period comparison. `object_id` can be passed to `shareholder_detail` to retrieve full holding history.

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | Security symbol, e.g. `AAPL.US` |

## Request Example

```bash
curl --request GET \
  --url 'https://openapi.longbridge.com/v1/quote/shareholders/top?symbol=<symbol>' \
  --header 'Authorization: Bearer <access_token>'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `periods` | array | No | Available reporting periods |
| `info` | object[] | No | Shareholder data per reporting period |
| `└ period` | string | No | Reporting period label (e.g. `Latest`) |
| `└ share_holders` | object[] | No | List of shareholders (up to 20) |
| `└ ∟ object_id` | string | No | Unique shareholder ID; pass to `shareholder_detail` |
| `└ ∟ name` | string | No | Shareholder name |
| `└ ∟ shares_held` | string | No | Number of shares held |
| `└ ∟ percent_shares_held` | string | No | Ownership percentage, including `%` sign (e.g. `9.71%`) |
| `└ ∟ shares_changed` | string | No | Net share count change (positive = bought, negative = sold) |
| `└ ∟ percent_shares_changed` | string | No | Change in ownership percentage, including `%` sign |
| `└ ∟ filing_date` | string | No | Filing date |
| `└ ∟ period` | string | No | Reporting period label (e.g. `Latest`) |
| `└ ∟ title` | string | No | Shareholder type (Institution / Individual / Insider) |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "info": [
      {
        "period": "Latest",
        "share_holders": [
          {
            "object_id": "148057",
            "name": "The Vanguard Group, Inc.",
            "title": "",
            "shares_held": "1426283914.00",
            "percent_shares_held": "9.71%",
            "percent_shares_changed": "0.01%",
            "shares_changed": "0.00",
            "period": "Latest",
            "filing_date": "2025/12/31"
          },
          {
            "object_id": "452583",
            "name": "BlackRock, Inc.",
            "title": "",
            "shares_held": "1138572603.00",
            "percent_shares_held": "7.75%",
            "percent_shares_changed": "-0.06%",
            "shares_changed": "-10565359.00",
            "period": "Latest",
            "filing_date": "2026/03/31"
          }
        ]
      }
    ]
  }
}
```
