获取财经日历中的经济数据：各国宏观经济指标的公布时间、公布值、预测值、前值、重要程度和影响说明，支持中英文。适合做宏观数据日历和公布提醒。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 API 等级可以调用本接口：初创 标准 专业 企业
响应数据
data 为经济日历公布记录的数组，包含公布值、预测值和前值。右侧示例展示两条记录；实际日期覆盖及条数以每次响应为准，日程可能修订。
数值字段是数据源给出的原始字符串
published_value、forecast_value、previous_value、revised_previous_value都是字符串，保留数据源的原始格式：可能是数字、负数、百分比（如-0.1%）、百分比区间、空字符串，或带前导空格。单位可能写在calendar_name里。计算前请先去掉空格、处理%和空值，再转为数字。
时间范围按公布时间筛选本接口按公布时间
publish_timestamp筛选，不同传参的结果见下表，建议两个参数都传。返回当前可用的经济日历数据，实际覆盖以接口返回为准，日程可能修订；不承诺固定一个月或两个月的完整历史保留范围。本接口没有interval、limit参数，时间戳与分页中按interval×limit推算时间范围的规则不适用于本接口。
| 传入的时间参数 | 返回的数据 |
|---|---|
同时传 start_time 和 end_time | start_time ≤ publish_timestamp < end_time 的数据，包含开始时间，不包含结束时间 |
只传 start_time | 从开始时间到现在的数据 |
只传 end_time | 结束时间之前已收录的全部数据 |
| 都不传 | 到现在为止已收录的全部数据 |
200 · application/json · 响应示例见右侧面板。
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
code | string | 是 | 业务状态码，"0" 表示成功 |
msg | string | 否 | 结果说明；成功时不返回 |
data | array of object | 是 | 经济数据列表，每个元素是一项指标的一次公布 |
data[].calendar_name | string | 是 | 指标名称，例如 5月批发销售(月率)；名称中可能带有统计周期和单位，语言由 language 决定 |
data[].country_code | string | 是 | 数据源关联的国家或地区代码，例如 JPN、CAN、USA；不是统一的 ISO 代码 |
data[].country_name | string | 是 | 国家或地区名称，语言由 language 决定，例如 加拿大 或 Canada |
data[].data_effect | string | 是 | 数据对市场影响的文字说明，例如 影响较小、利多加元，英文为 Minor Impact 等 |
data[].forecast_value | string | 是 | 预测值，字符串，保留数据源的原始写法；没有预测时为空字符串 |
data[].revised_previous_value | string | 是 | 数据源的前值修正字段，字符串，保留数据源的原始写法；多为空字符串。不一定是修正后的前值，需要前值时请用 previous_value |
data[].previous_value | string | 是 | 前值：上一期的数值，字符串，保留数据源的原始写法 |
data[].publish_timestamp | integer（int64） | 是 | 公布或举行时间，毫秒时间戳（UTC）；是否为准确时刻见 has_exact_publish_time |
data[].published_value | string | 是 | 公布值（本期实际数值），字符串，保留数据源的原始写法 |
data[].importance_level | integer | 是 | 重要程度，取值 1、2、3，数字越大越重要 |
data[].has_exact_publish_time | integer | 是 | 是否有具体公布时间：1 表示有具体时间；2 表示没有具体时间，此时 publish_timestamp 只能作为日期参考（财经事件、央行动态中这类事件的时间通常为 UTC 16:05，即北京时间 00:05） |
API 等级
只有下表中标为可以的 API 等级能调用本接口。各等级价格见 API 等级。
| API 等级 | 能否调用 |
|---|---|
| 业余 | ❌ 不可以 |
| 初创 | ✅ 可以 |
| 标准 | ✅ 可以 |
| 专业 | ✅ 可以 |
| 企业 | ✅ 可以 |
用 AI 调用本接口
选一个任务，点「在 ChatGPT 中打开」或「在 Claude 中打开」，AI 会先读取本页说明，再直接给出结果；也可以点「复制」，把完整提示词粘贴到你常用的 AI 工具里。
本接口通过 REST API 提供数据，可使用上方提示词让 AI 编写调用代码。MCP 可调用的工具见 CoinGlass MCP。
应用场景
| 场景 | 说明 |
|---|---|
| 宏观数据日历 | 在看板中列出未来要公布的经济数据，按重要程度标记，提前做好准备。 |
| 数据公布提醒 | 在重要数据公布前推送提醒，交易者可提前调整仓位和杠杆。 |
| 预期差分析 | 比较公布值与预测值、前值，判断数据好于还是差于预期。 |
| 研究宏观数据影响 | 把 publish_timestamp 与交易对 K 线历史按时间对齐，研究某类数据公布前后加密货币价格的变化。 |
相关接口
| 接口 | 区别 |
|---|---|
| 财经事件 | 政要讲话、国际会议等没有数值的财经事件 |
| 央行动态 | 各国央行官员讲话、会议和报告发布 |
| 快讯 | 数据公布后的市场消息和解读 |
| 比特币 vs 美国 M2 货币供应增长 | 比特币价格与美国货币供应的长期对比 |
常见问题
不传 language，为什么返回的是英文？
本接口 language 的默认值是 en，不传时返回英文；传 zh 才返回中文，传其他值也返回英文。注意「财经事件」「央行动态」两个接口的 language 默认值是 zh，不传时返回中文，与本接口不同。
为什么查不到未来的经济数据？
省略 end_time 时默认截止请求时刻。查询未来日程时，请同时传入 start_time 和明确的未来 end_time，单位均为毫秒，结束时间不包含在结果内。只能查询接口当前可用的日程，日程可能修订。
数值字段怎么转成数字？
四个数值字段都是保留原始格式的字符串，可能是数字、负数、百分比、百分比区间、空字符串或带前导空格，单位可能写在 calendar_name 里。请先去掉空格、处理 % 和空值，再转为数字；无法解析的保留原文（建议原文和数字分两列存），做加减和排序时跳过这些值。
has_exact_publish_time 为 2 时，publish_timestamp 是什么时间？
2 表示没有具体公布时间，publish_timestamp 只能说明大概在哪一天。财经事件、央行动态中这类事件的时间通常为 UTC 16:05（北京时间 00:05），显示时建议写成「全天」，不要当作准确时刻。1 表示有具体时间。
深入了解：财经日历与经济数据
公布值、预测值、前值分别是什么？
公布值是本期实际公布的数值；预测值是市场在公布前的预期；前值是上一期的数值。公布值与预测值的差，常被称为「预期差」。
经济数据为什么会影响加密货币价格？
通胀、就业等宏观数据会改变市场对利率政策的预期，进而影响美元流动性和风险资产的表现。重要数据公布前后，加密货币价格的波动往往会放大。
如何只看重要的数据？
按 importance_level 筛选，3 为最重要的一档。也可以按 country_code 只看关心的国家或地区，例如 USA。