Fundamental

Shareholder Detail

GEThttps://openapi.longbridge.com/v1/quote/shareholders/holding

Authorization

Signed mode: every request is signed with your App Key/Secret. Header set:

NameTypeRequiredDescription
Authorizationstring · headerRequiredThe account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation.
X-Api-Keystring · headerRequiredYour App Key.
X-Timestampstring · headerRequiredRequest timestamp in seconds (Unix epoch).
X-Api-Signaturestring · headerRequiredHMAC-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.

>_ CLI
longbridge shareholder AAPL.US --object-id 19463
longbridge shareholder 700.HK --object-id 20181

Request

Query parameters

NameTypeRequiredDescription
symbolstringRequiredSecurity symbol, e.g. `AAPL.US`
object_idintegerRequiredShareholder ID from `shareholder_top` `object_id` field

Response

Response properties

NameTypeRequiredDescription
titlestringOptionalShareholder title / type
avatarstringOptionalAvatar URL
owner_sourcestringOptionalShareholder type: `Company`, `Institution`, `Person`, `Insider`
holding_periodsstring[]OptionalAvailable holding periods
holding_detailsobject[]OptionalHolding detail records
holding_summaryobject[]OptionalHolding summary records
trading_periodsstring[]OptionalAvailable trading periods (e.g. `Past 1 Month`, `Past 3 Months`)
tradingsobject[]OptionalTrade aggregates per period
└ periodstringOptionalPeriod label (e.g. `Past 1 Month`)
└ accum_buystringOptionalCumulative shares bought in this period
└ accum_sellstringOptionalCumulative shares sold in this period
└ net_buystringOptionalNet shares bought (buy minus sell) in this period
└ trading_detailsobject[]OptionalIndividual transactions within the period
└ ∟ trading_datestringOptionalTrade date
└ ∟ trading_sharesstringOptionalNumber of shares traded
└ ∟ trading_pricestringOptionalTrade price
└ ∟ trading_typestringOptionalTrade 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.