# Shareholder Detail

`GET` `/v1/quote/shareholders/holding`

Get holding history and trade details for a specific shareholder. The `object_id` comes from the `shareholder_top` response.

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | Security symbol, e.g. `AAPL.US` |
| `object_id` | integer | Yes | Shareholder ID from `shareholder_top` `object_id` field |

## Request Example

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

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | No | Shareholder title / type |
| `avatar` | string | No | Avatar URL |
| `owner_source` | string | No | Shareholder type: `Company`, `Institution`, `Person`, `Insider` |
| `holding_periods` | string[] | No | Available holding periods |
| `holding_details` | object[] | No | Holding detail records |
| `holding_summary` | object[] | No | Holding summary records |
| `trading_periods` | string[] | No | Available trading periods (e.g. `Past 1 Month`, `Past 3 Months`) |
| `tradings` | object[] | No | Trade aggregates per period |
| `└ period` | string | No | Period label (e.g. `Past 1 Month`) |
| `└ accum_buy` | string | No | Cumulative shares bought in this period |
| `└ accum_sell` | string | No | Cumulative shares sold in this period |
| `└ net_buy` | string | No | Net shares bought (buy minus sell) in this period |
| `└ trading_details` | object[] | No | Individual transactions within the period |
| `└ ∟ trading_date` | string | No | Trade date |
| `└ ∟ trading_shares` | string | No | Number of shares traded |
| `└ ∟ trading_price` | string | No | Trade price |
| `└ ∟ trading_type` | string | No | Trade direction: `Buy` or `Sell` |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "name": "The Vanguard Group, Inc.",
    "title": "",
    "avatar": "",
    "owner_source": "Institution",
    "holding_periods": [],
    "holding_details": [],
    "holding_summary": [],
    "trading_periods": [
      "Past 1 Month",
      "Past 3 Months",
      "Past 1 Year",
      "Past 3 Years"
    ],
    "tradings": [
      {
        "period": "Past 1 Month",
        "accum_buy": "8500000.00",
        "accum_sell": "2687264.00",
        "net_buy": "5812736.00",
        "trading_details": [
          {
            "trading_date": "2025-12-18",
            "trading_shares": "5200000",
            "trading_price": "248.12",
            "trading_type": "Buy"
          }
        ]
      }
    ]
  }
}
```
