Get financial events from the financial calendar: the time, associated country or region, and importance of important events such as speeches by political leaders, international meetings and forums. Useful for building event schedules and trading risk alerts.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Available on these API plans: Startup Standard Professional Enterprise
Response Data
data is an array; each element is one financial event, such as a speech by a political leader, an international meeting or a forum. Unlike “Economic Data”, this endpoint does not return numeric fields such as published values or forecast values. The example on the right is the actual response for 2026-10-19 04:00 to 2026-10-20 04:00 UTC with language omitted (Chinese): 4 items were returned, and the example keeps 2.
Empty Results for English QueriesOn 2026-10-26 (UTC), queries for the same time range returned schedules with
zh, while any value other thanzh(e.g.,enorzh-tw) returnedcode="0"anddata=[]. To retrieve the available schedules, omitlanguageor passzh; the content is returned in Chinese. An empty English result does not establish that there are no scheduled events in that range. This describes the behavior observed on that date.
The time range is filtered by release timeThis endpoint filters by the release time
publish_timestamp; see the table below for what different parameter combinations return. We recommend passing both parameters. The time range you can query depends on the schedules that have been tracked. This endpoint has nointervalorlimitparameter, so the rule in Timestamps and Pagination of deriving the time range frominterval×limitdoes not apply to this endpoint.
| Time Parameters Passed | Data Returned |
|---|---|
Both start_time and end_time | Data with start_time ≤ publish_timestamp < end_time; the start time is included and the end time is excluded |
Only start_time | Data from the start time to now |
Only end_time | All tracked data before the end time |
| Neither | All tracked data up to now |
200 · application/json · See the response example in the right panel.
| Field | Type | Always Returned | Description |
|---|---|---|---|
code | string | Yes | Business status code; "0" means success |
msg | string | No | Result message; not returned on success |
data | array of object | Yes | List of financial events; each element is one event |
data[].calendar_name | string | Yes | Event name (description), e.g., 美国财长贝森特发表讲话 (“US Treasury Secretary Bessent delivers a speech”) |
data[].country_code | string | No | Code of the country or region associated with the event, e.g., USA, CHN; not a uniform ISO code, and not necessarily where the event is held. Some events do not return this field |
data[].country_name | string | Yes | Country or region name; may be an empty string |
data[].publish_timestamp | integer (int64) | Yes | Release or event time, timestamp in milliseconds (UTC); whether it is an exact time is indicated by has_exact_publish_time |
data[].importance_level | integer | Yes | Importance, with values 1, 2 and 3; the larger the number, the more important |
data[].has_exact_publish_time | integer | Yes | Whether there is a specific release time: 1 means there is a specific time; 2 means there is no specific time, in which case publish_timestamp can only be used as a reference for the date (in financial events and central bank activities, the time of such events is usually 16:05 UTC, i.e., 00:05 Beijing time) |
API Plans
Only the API plans marked Yes in the table below can call this endpoint. For the price of each plan, see API Plans.
| API Plan | Access |
|---|---|
| Hobbyist | ❌ No |
| Startup | ✅ Yes |
| Standard | ✅ Yes |
| Professional | ✅ Yes |
| Enterprise | ✅ Yes |
Use This Endpoint with AI
Pick a task and click Open in ChatGPT or Open in Claude: the AI reads this page first and then gives you the result. You can also click Copy and paste the full prompt into the AI tool you use.
This endpoint provides data through the REST API. Use the prompts above to have AI write the request code. For the tools available through MCP, see CoinGlass MCP.
Use Cases
| Scenario | Description |
|---|---|
| Event schedule | List speeches by political leaders, international meetings and other events for the next few days on a dashboard or in an app, marked by importance. |
| Trading risk alerts | Alert traders before important speeches and meetings, and lower leverage or pause automated strategies when necessary. |
| Syncing to a personal calendar | Export the events to a calendar file and import it into a phone or computer calendar. |
| Event impact research | Align event times with price data to review market performance before and after important events. |
Related Endpoints
| Endpoint | How It Differs |
|---|---|
| Economic Data | Macroeconomic indicators with published, forecast and previous values |
| Central Bank Activities | Speeches by central bank officials, meetings and report releases around the world |
| News | News coverage related to the events |
| Token Unlock List | Token unlock schedules of crypto projects |
FAQ
When has_exact_publish_time is 2, what time does publish_timestamp represent?
2 means there is no specific release time, and publish_timestamp only indicates roughly which day it falls on. In financial events and central bank activities, the time of such events is usually 16:05 UTC (00:05 Beijing time); when displaying it, we recommend showing “All day” and not treating it as an exact time. 1 means there is a specific time.
Why can't I find future events?
If end_time is omitted, the current time is used. To see future schedules, pass both start_time (e.g., the current time) and a future end_time, e.g., the millisecond timestamp of the current time plus 7 days. How far into the future you can query depends on the schedules that have been tracked.
Why do some events have no country_code?
Some events do not return country_code, and their country_name is an empty string, e.g., 美国总统特朗普发表讲话 (“US President Trump delivers a speech”). Check whether the field exists before reading it; when filtering by country or region, you can also check calendar_name.
Which importance_level is the most important?
The values are 1, 2 and 3; the larger the number, the more important. If you only care about major events, you can keep only 3.
Learn More: Financial Events
What Do Financial Events Include?
Mainly financial calendar items without specific numeric values, such as speeches by national leaders and finance officials, international meetings and financial forums. For indicator releases with numeric values, use the Economic Data endpoint.
Why Do Financial Events Affect Crypto?
Important speeches and meetings may reveal the direction of fiscal, monetary or regulatory policy; the market adjusts its expectations accordingly, and the prices of risk assets such as crypto may fluctuate as a result.
How Do I Handle Events Without a Specific Time?
For events whose has_exact_publish_time is 2, only the approximate day can be determined. When displaying them, we recommend marking them as “All day”; for reminders, use the start of that day.