基本面

股东持仓详情

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

错误码

参见错误码文档。