Market
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=. |
Browse upcoming earnings reports and recent results, with EPS and revenue estimates.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
date | string | Required | Start date, `YYYYMMDD`. Paginate by passing the returned `next_date`. |
date_end | string | Required | End date, `YYYYMMDD`. |
types[] | string | Required | Event category: `report`, `dividend`, `split`, `ipo`, `macrodata`, `closed`, `meeting`, `merge`. |
markets[] | string | Optional | Market filter, e.g. `US`, `HK`, `CN`. If omitted, all markets. |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
date | string | Optional | Response date |
list | object[] | Required | List of calendar date groups |
count | integer | Optional | Number of events on this date |
infos | object[] | Required | List of calendar events |
id | string | Optional | Event ID |
symbol | string | Optional | Security symbol |
market | string | Optional | Market |
counter_name | string | Optional | Security name |
type | string | Optional | Event type |
activity_type | string | Optional | Activity type |
datetime | string | Optional | Event datetime |
date_type | string | Optional | Date type |
content | string | Optional | Event content description |
currency | string | Optional | Currency |
star | integer | Optional | Importance rating (1-3) |
icon | string | Optional | Icon URL |
chart_uid | string | Optional | Chart identifier |
financial_market_time | string | Optional | Financial market time |
data_kv | object[] | Optional | Key-value data pairs |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"date": "2026-04-30",
"list": [
{
"date": "2026-04-30",
"count": 2228,
"infos": [
{
"id": "12345",
"symbol": "AAPL.US",
"market": "US",
"counter_name": "Apple Inc.",
"event_type": "",
"activity_type": "",
"date": "2026-05-14",
"datetime": "",
"content": "",
"star": 0,
"currency": "",
"icon": "",
"chart_uid": "",
"date_type": "",
"financial_market_time": "",
"data_kv": []
}
]
}
]
}
}Error code
See the Error Codes page for the full list of error codes.