基本面

股東持倉詳情

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

鑑權

簽名方式:每個請求用 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=。

獲取單個股東的持倉歷史及交易明細。object_id 來自 shareholder_top 返回結果。

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

請求

查詢參數

名稱類型必填說明
symbolstring必填證券代碼,例如 `AAPL.US`
object_idinteger必填股東 ID,來自 `shareholder_top` 的 `object_id` 字段

響應

響應欄位

名稱類型必填說明
titlestring可選股東頭銜 / 類型
avatarstring可選頭像 URL
owner_sourcestring可選股東類型:`Company`、`Institution`、`Person`、`Insider`
holding_periodsstring[]可選可用的持倉報告期列表
holding_detailsobject[]可選持倉明細記錄
holding_summaryobject[]可選持倉匯總記錄
trading_periodsstring[]可選可用的交易統計區間(如 `Past 1 Month`、`Past 3 Months`)
tradingsobject[]可選各區間交易匯總
└ periodstring可選區間標籤(如 `Past 1 Month`)
└ accum_buystring可選該區間累計買入股數
└ accum_sellstring可選該區間累計賣出股數
└ net_buystring可選該區間淨買入股數(買入減賣出)
└ trading_detailsobject[]可選該區間內的具體交易記錄
└ ∟ trading_datestring可選交易日期
└ ∟ trading_sharesstring可選交易股數
└ ∟ trading_pricestring可選交易價格
└ ∟ trading_typestring可選交易方向:`Buy` 或 `Sell`

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

錯誤碼

參見錯誤碼文檔。