基本面
鑑權
簽名方式:每個請求用 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` |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
items | object[] | 必填 | 公司行動列表 |
└ id | string | 可選 | 公司行動 ID |
└ act_desc | string | 可選 | 公司行動描述 |
└ act_type | string | 可選 | 公司行動類型分類 |
└ action | string | 可選 | 公司行動代碼(如 `DividendExDate`) |
└ date | string | 可選 | 生效日期 |
└ date_str | string | 可選 | 簡短展示日期(MM.DD) |
└ date_type | string | 可選 | 日期類型標籤(如 Payment Date) |
└ date_zone | string | 可選 | 時區(如 EST) |
└ delay_content | string | 可選 | 延遲內容描述 |
└ is_delay | boolean | 可選 | 事件是否延遲 |
└ live | boolean | 可選 | 當前是否正在直播 |
└ recent | boolean | 可選 | 是否爲近期事件 |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"items": [
{
"id": "622620",
"action": "DividendExDate",
"act_type": "Distribution Plan",
"act_desc": "Cash dividend 0.27 USD",
"date": "20260514",
"date_str": "05.14",
"date_type": "Payment Date",
"date_zone": "EST",
"delay_content": "",
"is_delay": false,
"recent": false,
"live": null
}
]
}
}錯誤碼
參見錯誤碼文檔。