基本面
鑑權
簽名方式:每個請求用 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` |
start_date | string | 可選 | 開始日期,格式 `YYYY-MM-DD` |
end_date | string | 可選 | 結束日期,格式 `YYYY-MM-DD` |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
list | object[] | 可選 | 股息記錄列表, |
└ id | string | 可選 | 派息事件 ID |
└ desc | string | 可選 | 派息描述 |
└ symbol | string | 可選 | 證券代碼 |
└ record_date | string | 可選 | 股權登記日 |
└ ex_date | string | 可選 | 除息日 |
└ payment_date | string | 可選 | 派息日 |
└ dividend_summary | object | 可選 | 股息摘要。 |
└ ∟ title | string | 可選 | 標題 |
└ ∟ desc | string | 可選 | 派息描述 |
total | string | 可選 | 滿足條件的股票總數。 |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"list": [
{
"id": "12345",
"symbol": "AAPL.US",
"ex_date": "2026-02-07",
"payment_date": "2026-02-13",
"record_date": "2026-02-10",
"desc": "Cash dividend 0.25 USD"
}
]
}
}錯誤碼
參見錯誤碼文檔。