基本面
鑑權
簽名方式:每個請求用 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=。 |
獲取公司主要機構股東和個人股東信息。
請求
查詢參數
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
symbol | string | 必填 | 證券代碼,例如 `AAPL.US` |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
shareholder_list | object[] | 可選 | 股東列表, |
└ shareholder_id | string | 可選 | 股東 ID |
└ shareholder_name | string | 可選 | 股東名稱 |
└ percent_of_shares | string | 可選 | 持股比例 |
└ shares_changed | string | 可選 | 持股變動 |
└ report_date | string | 可選 | 報告日期 |
└ stocks | array | 可選 | 關聯標的 |
└ institution_type | string | 可選 | 機構類型 |
total | integer | 可選 | 股東總數 |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"forward_url": "",
"total": 33,
"shareholder_list": [
{
"shareholder_name": "Timothy D. Cook",
"percent_of_shares": "2.84",
"institution_type": "",
"report_date": "2026-04-21",
"shareholder_id": "0",
"shares_changed": "0",
"stocks": []
}
]
}
}錯誤碼
參見錯誤碼文檔。