Fundamental

Top Shareholders

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

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 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.

>_ CLI
longbridge shareholder AAPL.US --top
longbridge shareholder 700.HK --top

Request

Query parameters

NameTypeRequiredDescription
symbolstringRequiredSecurity symbol, e.g. `AAPL.US`

Response

Response properties

NameTypeRequiredDescription
periodsarrayOptionalAvailable reporting periods
infoobject[]OptionalShareholder data per reporting period
└ periodstringOptionalReporting period label (e.g. `Latest`)
└ share_holdersobject[]OptionalList of shareholders (up to 20)
└ ∟ object_idstringOptionalUnique shareholder ID; pass to `shareholder_detail`
└ ∟ namestringOptionalShareholder name
└ ∟ shares_heldstringOptionalNumber of shares held
└ ∟ percent_shares_heldstringOptionalOwnership percentage, including `%` sign (e.g. `9.71%`)
└ ∟ shares_changedstringOptionalNet share count change (positive = bought, negative = sold)
└ ∟ percent_shares_changedstringOptionalChange in ownership percentage, including `%` sign
└ ∟ filing_datestringOptionalFiling date
└ ∟ periodstringOptionalReporting period label (e.g. `Latest`)
└ ∟ titlestringOptionalShareholder type (Institution / Individual / Insider)

Response JSON example

{
  "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"
          }
        ]
      }
    ]
  }
}

Error code

See the Error Codes page for the full list of error codes.