基本面

大股東排行

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

鑑權

簽名方式:每個請求用 App Key / Secret 簽名。請求頭如下:

名稱類型必填說明
Authorizationstring · header必填OpenAPI 後台 上的賬戶 Access Token,作為原始 token 傳入(不帶 Bearer 前綴),並參與簽名計算。
X-Api-Keystring · header必填你的 App Key。
X-Timestampstring · header必填請求時間戳,單位秒(Unix 時間)。
X-Api-Signaturestring · header必填HMAC-SHA256 簽名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。

獲取上市公司前 20 大股東(機構、個人、內部人)的持股數據,支持多報告期對比。object_id 可傳入 shareholder_detail 查看詳情。

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

請求

查詢參數

名稱類型必填說明
symbolstring必填證券代碼,例如 `AAPL.US`

響應

響應欄位

名稱類型必填說明
periodsarray可選可用報告期列表
infoobject[]可選各報告期的股東數據
└ periodstring可選報告期標籤(如 `Latest`)
└ share_holdersobject[]可選股東列表(最多 20 條)
└ ∟ object_idstring可選股東唯一 ID,可傳入 `shareholder_detail`
└ ∟ namestring可選股東名稱
└ ∟ shares_heldstring可選持股數量
└ ∟ percent_shares_heldstring可選持股比例,含 `%` 符號(如 `9.71%`)
└ ∟ shares_changedstring可選持股變動數量(正增負減)
└ ∟ percent_shares_changedstring可選持股比例變動,含 `%` 符號
└ ∟ filing_datestring可選申報日期
└ ∟ periodstring可選報告期標籤(如 `Latest`)
└ ∟ titlestring可選股東類型(機構 / 個人 / 內部人)

響應 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"
          }
        ]
      }
    ]
  }
}

錯誤碼

參見錯誤碼文檔。