Fundamental
Authorization
Signed mode: every request is signed with your App Key/Secret. Header set:
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string · header | Required | The account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation. |
X-Api-Key | string · header | Required | Your App Key. |
X-Timestamp | string · header | Required | Request timestamp in seconds (Unix epoch). |
X-Api-Signature | string · header | Required | HMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=. |
Get corporate action history (splits, mergers, spin-offs, rights issues) for a security.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Required | Security symbol, e.g. `AAPL.US` |
start_date | string | Optional | Start date in `YYYY-MM-DD` format |
end_date | string | Optional | End date in `YYYY-MM-DD` format |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
items | object[] | Required | Corporate action list |
└ id | string | Optional | Action ID |
└ act_desc | string | Optional | Action description |
└ act_type | string | Optional | Action type category |
└ action | string | Optional | Action code (e.g. `DividendExDate`) |
└ date | string | Optional | Event date (YYYYMMDD) |
└ date_str | string | Optional | Short display date (MM.DD) |
└ date_type | string | Optional | Date type label (e.g. Payment Date) |
└ date_zone | string | Optional | Time zone (e.g. EST) |
└ delay_content | string | Optional | Delay content description |
└ is_delay | boolean | Optional | Whether the event is delayed |
└ live | boolean | Optional | Whether currently live |
└ recent | boolean | Optional | Whether this is a recent event |
Response JSON example
{
"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
}
]
}
}Error code
See the Error Codes page for the full list of error codes.