# 大股东排行

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

获取上市公司前 20 大股东（机构、个人、内部人）的持股数据，支持多报告期对比。`object_id` 可传入 `shareholder_detail` 查看详情。

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | 证券代码，例如 `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 | 可用报告期列表 |
| `info` | object[] | No | 各报告期的股东数据 |
| `└ period` | string | No | 报告期标签（如 `Latest`） |
| `└ share_holders` | object[] | No | 股东列表（最多 20 条） |
| `└ ∟ object_id` | string | No | 股东唯一 ID，可传入 `shareholder_detail` |
| `└ ∟ name` | string | No | 股东名称 |
| `└ ∟ shares_held` | string | No | 持股数量 |
| `└ ∟ percent_shares_held` | string | No | 持股比例，含 `%` 符号（如 `9.71%`） |
| `└ ∟ shares_changed` | string | No | 持股变动数量（正增负减） |
| `└ ∟ percent_shares_changed` | string | No | 持股比例变动，含 `%` 符号 |
| `└ ∟ filing_date` | string | No | 申报日期 |
| `└ ∟ period` | string | No | 报告期标签（如 `Latest`） |
| `└ ∟ title` | string | No | 股东类型（机构 / 个人 / 内部人） |

### 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"
          }
        ]
      }
    ]
  }
}
```
