经济日历事件(实际/预期/前值)
按国家、重要级别、类别关键词和日期区间获取宏观经济日历事件(利率决议、就业、通胀等),输出日期、时刻、货币区、重要级别、预期/前值等结构化字段,可直接用于量化信号、AI 交易智能体与宏观研究
概览
做量化或交易智能体最怕的不是没数据,是宏观事件"什么时候出、市场预期多少"拿不到结构化的版本——盯网站日历既慢又没法进代码。
这份数据把主要经济体的经济日历变成干净的 JSON:给出国家/货币区,返回本周(含已公布)的每一条宏观事件——日期、时刻、货币区、重要级别、事件名、市场预期值和上期值,一行一个事件,可直接进回测、交易信号或智能体的上下文。
数据说明
覆盖美元、欧元、英镑、日元、人民币、加元、澳元、纽元、瑞郎约 9 个主要货币区。每条记录带重要级别(high/medium/low)与预期/前值,适合做"预期差"分析:事件发布后用实际值对照预期值(实际值本数据源不提供,需对照行情或专业宏观数据库)。时间默认按 GMT+8 输出,可用 TimeZone 改为任意偏移;Time Filter 可选"显示事件时刻"或"显示距事件开始的剩余时间",做倒计时看板时选后者。
数据为滚动周度窗口:包含本周已公布和未来几天待公布的事件,适合做每日/每周刷新的日历看板;更早的历史区间不在覆盖范围。类别用事件名称英文关键词过滤(如 CPI、GDP、Claims);事件 ID 为稳定生成的唯一标识,同一事件跨次运行不变。
结果长什么样
一条记录对应一个经济事件(示例为本周美国高重要性事件):
| ID | Date | Time | Zone | Currency | Importance | Event | Forecast | Previous |
|---|---|---|---|---|---|---|---|---|
| 110051664652747 | 17/11/2026 | 21:30 | united states | USD | high | Core Retail Sales m/m | 0.4% | 0.9% |
| 257888096211787 | 17/11/2026 | 21:30 | united states | USD | high | Retail Sales m/m | 0.1% | 0.8% |
应用场景
量化信号与回测辅助:把"事件时间 + 预期值 + 前值"挂进策略,在数据发布窗口前后调整仓位或做预期差研究。
AI 交易智能体:给智能体一份结构化的本周宏观事件清单,让它在利率决议、非农等事件前主动降杠杆或等待确认。
交易日历看板与晨报:每天刷新一次,按重要级别排序生成当日高影响事件提醒;用剩余时间模式做倒计时展示。
适用边界
数据来自国际财经日历聚合 feed(Investing.com 全站被 Cloudflare 拦截,实测纯 HTTP 与真实浏览器均 403,故不可直连);覆盖美元、欧元、英镑、日元、人民币、加元、澳元、纽元、瑞郎约 9 个主要货币区(非 45+ 国全量);数据源不提供已公布实际值,actual 恒为空字符串,预期/前值可用;只含本周滚动窗口(含本周已公布事件),更早历史或更远未来需另择数据源;categories 按事件名英文关键词过滤(feed 无类别元数据);事件 id 为确定性合成值(feed 无原生 id);时间默认按 GMT+8 输出,可用 timeZone 改偏移
- 适合用于
- 需要本周即将发布的宏观事件清单(利率决议、就业、通胀数据)来安排交易或复盘
- 给量化信号或 AI 交易智能体喂结构化的宏观事件上下文(预期值 vs 前值)
- 交易台或研究团队的每周经济日历看板与晨报数据源
- 不要用于
- 需要历史实际公布值做回测(数据源不含 actual,历史事件请用专业宏观数据库)
- 需要 45+ 国全量小国日历或细分类别字段(本源覆盖约 9 个主要货币区)
- 需要本周以外任意历史/未来区间(数据源为滚动周度窗口)
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1数据源有速率限制(HTTP 429,冷却窗口约几分钟),自动按 Retry-After 等待重试最多 3 次(总等待预算 300 秒),仍失败时任务以可重试错误结束
- 2请求的国家无法识别时以明确报错结束并列出支持的货币区清单
- 3日期区间与本周数据不相交时返回 0 条并在日志提示(不报错)
- 4个别条目时间无法解析时跳过该条,不影响其余数据
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- Country
country选填string单个国家/经济体的日历事件,如 united states、euro zone、japan、china(大小写不敏感),也可直接填货币代码 USD/EUR/GBP/JPY/CNY/CAD/AUD/NZD/CHF;留空取全部货币区。欧元区成员国(germany/france 等)统一归入 euro zone。示例united states - Countries (multiple)
countries选填array<string>多个国家/经济体,与 Country 可同时使用(取并集);两项都留空取全部货币区。示例["euro zone","united kingdom"] - Importances
importances选填string(enum)只取指定重要级别的事件;留空取全部(含假期类条目)。可选值high(高影响)highmedium(中影响)mediumlow(低影响)low - Categories
categories选填string按事件名称关键词过滤(英文、不区分大小写、子串匹配),如 CPI、GDP、Rate、Claims;留空取全部类别。示例CPI - From Date
fromDate选填string起始日期,YYYY-MM-DD 格式;数据源提供本周(含已公布)的滚动周度日历,日期区间超出本周时可能返回 0 条;留空取本周全部。示例2026-11-16 - To Date
toDate选填string结束日期,YYYY-MM-DD 格式(含当日);留空取本周全部。示例2026-11-22 - TimeZone
timeZone选填string输出时间所用时区,GMT 偏移格式,如 'GMT +2:00'、'GMT -5:30'、'GMT+8';留空按 GMT +8:00 输出。示例GMT +8:00 - Time Filter
timeFilter选填string(enum)time 字段的显示方式:time_only 显示事件时刻,time_remain 显示距事件开始的剩余时间(如 '2d 3h 15m',已开始的事件显示 0m)。可选值time_only(显示事件时刻)time_onlytime_remain(显示剩余时间)time_remain默认值time_only
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- ID
idinteger事件唯一标识;同一事件跨次运行保持稳定(按货币区+原始时间+事件名生成)示例110051664652747 - Date
datestring事件日期,DD/MM/YYYY 格式(按请求时区换算)示例17/11/2026 - Time
timestring事件时刻 HH:MM(按请求时区);timeFilter=time_remain 时为剩余时间(如 '2d 3h 15m',已开始的事件为 0m)示例21:30 - Zone
zonestring事件所属国家/经济体(小写),如 united states、euro zone;未收录货币区直接显示货币代码小写示例united states
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"id": 110051664652747,
"date": "17/11/2026",
"time": "21:30",
"zone": "united states",
"currency": "USD",
"importance": "high",
"event": "Core Retail Sales m/m",
"actual": "<actual>",
"forecast": "0.4%",
"previous": "0.9%",
"retrieved_at": "2026-11-17T06:31:06+00:00",
"data_type": "economic_calendar_event"
}调用方式
本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=SpiderByte/economic-calendar-data",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。