基本面
鉴权
签名方式:每个请求用 App Key / Secret 签名。请求头如下:
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string · header | 必填 | OpenAPI 后台 上的账户 Access Token,作为原始 token 传入(不带 Bearer 前缀),并参与签名计算。 |
X-Api-Key | string · header | 必填 | 你的 App Key。 |
X-Timestamp | string · header | 必填 | 请求时间戳,单位秒(Unix 时间)。 |
X-Api-Signature | string · header | 必填 | HMAC-SHA256 签名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。 |
获取上市公司前 20 大股东(机构、个人、内部人)的持股数据,支持多报告期对比。object_id 可传入 shareholder_detail 查看详情。
请求
查询参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | string | 必填 | 证券代码,例如 `AAPL.US` |
响应
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
periods | array | 可选 | 可用报告期列表 |
info | object[] | 可选 | 各报告期的股东数据 |
└ period | string | 可选 | 报告期标签(如 `Latest`) |
└ share_holders | object[] | 可选 | 股东列表(最多 20 条) |
└ ∟ object_id | string | 可选 | 股东唯一 ID,可传入 `shareholder_detail` |
└ ∟ name | string | 可选 | 股东名称 |
└ ∟ shares_held | string | 可选 | 持股数量 |
└ ∟ percent_shares_held | string | 可选 | 持股比例,含 `%` 符号(如 `9.71%`) |
└ ∟ shares_changed | string | 可选 | 持股变动数量(正增负减) |
└ ∟ percent_shares_changed | string | 可选 | 持股比例变动,含 `%` 符号 |
└ ∟ filing_date | string | 可选 | 申报日期 |
└ ∟ period | string | 可选 | 报告期标签(如 `Latest`) |
└ ∟ title | string | 可选 | 股东类型(机构 / 个人 / 内部人) |
响应 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"
}
]
}
]
}
}错误码
参见错误码文档。