基本面
鉴权
签名方式:每个请求用 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
}
]
}
}错误码
参见错误码文档。