Fundamental
Authorization
Signed mode: every request is signed with your App Key/Secret. Header set:
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string · header | Required | The account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation. |
X-Api-Key | string · header | Required | Your App Key. |
X-Timestamp | string · header | Required | Request timestamp in seconds (Unix epoch). |
X-Api-Signature | string · header | Required | HMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=. |
Get holding history and trade details for a specific shareholder. The object_id comes from the shareholder_top response.
longbridge shareholder AAPL.US --object-id 19463
longbridge shareholder 700.HK --object-id 20181
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | Security symbol, e.g. `AAPL.US` |
object_id | integer | Required | Shareholder ID from `shareholder_top` `object_id` field |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
title | string | Optional | Shareholder title / type |
avatar | string | Optional | Avatar URL |
owner_source | string | Optional | Shareholder type: `Company`, `Institution`, `Person`, `Insider` |
holding_periods | string[] | Optional | Available holding periods |
holding_details | object[] | Optional | Holding detail records |
holding_summary | object[] | Optional | Holding summary records |
trading_periods | string[] | Optional | Available trading periods (e.g. `Past 1 Month`, `Past 3 Months`) |
tradings | object[] | Optional | Trade aggregates per period |
└ period | string | Optional | Period label (e.g. `Past 1 Month`) |
└ accum_buy | string | Optional | Cumulative shares bought in this period |
└ accum_sell | string | Optional | Cumulative shares sold in this period |
└ net_buy | string | Optional | Net shares bought (buy minus sell) in this period |
└ trading_details | object[] | Optional | Individual transactions within the period |
└ ∟ trading_date | string | Optional | Trade date |
└ ∟ trading_shares | string | Optional | Number of shares traded |
└ ∟ trading_price | string | Optional | Trade price |
└ ∟ trading_type | string | Optional | Trade direction: `Buy` or `Sell` |
Response JSON example
{
"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"
}
]
}
]
}
}Error code
See the Error Codes page for the full list of error codes.