基本面
鑑權
簽名方式:每個請求用 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"
}
]
}
]
}
}錯誤碼
參見錯誤碼文檔。