logo

经济日历事件(实际/预期/前值)

按国家、重要级别、类别关键词和日期区间获取宏观经济日历事件(利率决议、就业、通胀等),输出日期、时刻、货币区、重要级别、预期/前值等结构化字段,可直接用于量化信号、AI 交易智能体与宏观研究

发布者
价格
¥0.005 / 条
最近更新
2026-11-17

概览

做量化或交易智能体最怕的不是没数据,是宏观事件"什么时候出、市场预期多少"拿不到结构化的版本——盯网站日历既慢又没法进代码。

这份数据把主要经济体的经济日历变成干净的 JSON:给出国家/货币区,返回本周(含已公布)的每一条宏观事件——日期、时刻、货币区、重要级别、事件名、市场预期值和上期值,一行一个事件,可直接进回测、交易信号或智能体的上下文。

数据说明

覆盖美元、欧元、英镑、日元、人民币、加元、澳元、纽元、瑞郎约 9 个主要货币区。每条记录带重要级别(high/medium/low)与预期/前值,适合做"预期差"分析:事件发布后用实际值对照预期值(实际值本数据源不提供,需对照行情或专业宏观数据库)。时间默认按 GMT+8 输出,可用 TimeZone 改为任意偏移;Time Filter 可选"显示事件时刻"或"显示距事件开始的剩余时间",做倒计时看板时选后者。

数据为滚动周度窗口:包含本周已公布和未来几天待公布的事件,适合做每日/每周刷新的日历看板;更早的历史区间不在覆盖范围。类别用事件名称英文关键词过滤(如 CPI、GDP、Claims);事件 ID 为稳定生成的唯一标识,同一事件跨次运行不变。

结果长什么样

一条记录对应一个经济事件(示例为本周美国高重要性事件):

IDDateTimeZoneCurrencyImportanceEventForecastPrevious
11005166465274717/11/202621:30united statesUSDhighCore Retail Sales m/m0.4%0.9%
25788809621178717/11/202621:30united statesUSDhighRetail Sales m/m0.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. 1数据源有速率限制(HTTP 429,冷却窗口约几分钟),自动按 Retry-After 等待重试最多 3 次(总等待预算 300 秒),仍失败时任务以可重试错误结束
  2. 2请求的国家无法识别时以明确报错结束并列出支持的货币区清单
  3. 3日期区间与本周数据不相交时返回 0 条并在日志提示(不报错)
  4. 4个别条目时间无法解析时跳过该条,不影响其余数据

输入参数

调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。

  • Countrycountry选填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"]
  • Importancesimportances选填string(enum)
    只取指定重要级别的事件;留空取全部(含假期类条目)。
    可选值high(高影响)highmedium(中影响)mediumlow(低影响)low
  • Categoriescategories选填string
    按事件名称关键词过滤(英文、不区分大小写、子串匹配),如 CPI、GDP、Rate、Claims;留空取全部类别。
    示例CPI
  • From DatefromDate选填string
    起始日期,YYYY-MM-DD 格式;数据源提供本周(含已公布)的滚动周度日历,日期区间超出本周时可能返回 0 条;留空取本周全部。
    示例2026-11-16
  • To DatetoDate选填string
    结束日期,YYYY-MM-DD 格式(含当日);留空取本周全部。
    示例2026-11-22
  • TimeZonetimeZone选填string
    输出时间所用时区,GMT 偏移格式,如 'GMT +2:00'、'GMT -5:30'、'GMT+8';留空按 GMT +8:00 输出。
    示例GMT +8:00
  • Time FiltertimeFilter选填string(enum)
    time 字段的显示方式:time_only 显示事件时刻,time_remain 显示距事件开始的剩余时间(如 '2d 3h 15m',已开始的事件显示 0m)。
    可选值time_only(显示事件时刻)time_onlytime_remain(显示剩余时间)time_remain默认值time_only

输出数据

单条记录的字段结构,与 manifest.json 的 output.schema 同源。

  • IDidinteger
    事件唯一标识;同一事件跨次运行保持稳定(按货币区+原始时间+事件名生成)
    示例110051664652747
  • Datedatestring
    事件日期,DD/MM/YYYY 格式(按请求时区换算)
    示例17/11/2026
  • Timetimestring
    事件时刻 HH:MM(按请求时区);timeFilter=time_remain 时为剩余时间(如 '2d 3h 15m',已开始的事件为 0m)
    示例21:30
  • Zonezonestring
    事件所属国家/经济体(小写),如 united states、euro zone;未收录货币区直接显示货币代码小写
    示例united states

示例数据

以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。

output.example
{
  "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 配置
{
  "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)。

价格

每条日历事件

按实际成功返回的数据条数计费,任务失败不计费。

¥0.005/ 条

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
¥0.005 / 条