快速开始 定价 类型 回测与部署 权重管理 策略库 分享 备份策略 加密货币 台股 商品期货 宏观事件 一键网页版 IDE 用 IDE 开发 远程桌面连接 工作区结构 更新 新增用户

宏观事件日历

Blave Agent 可访问全球宏观事件日历（授权数据源），包含发布时间、市场预期值、前值与实际值。

涵盖范围

涵盖主要经济体的经济数据发布与央行事件。一行一笔事件，带有预定发布时间、市场预期值、前值，以及公布后的实际值。

这份日历是滚动约五周的窗口（过去一个月加上未来数周），不是历史数据库。查询区间落在窗外会返回空结果——那代表这段范围没有数据，不是这段期间没有事件。

取用方式

Agent 通过 lib/data.py 的共用函数查询日历：

from lib.data import fetch_economic_calendar

df = fetch_economic_calendar(
    headers,
    start='2026-07-01',
    end='2026-07-31',
    countries=['US', 'CN'],
    max_priority=1,
)

返回按事件时间排序的 DataFrame，一行一笔事件。所有参数都可以省略，但不筛选会拿到所有国家、所有重要度的事件，建议先缩小范围：

• start / end — 查询区间，台北日期 'YYYY-MM-DD'，含头含尾
• countries — ISO 两码国家列表，例如 ['US', 'CN', 'TW']；省略则不限国家
• max_priority — 只保留重要度在此级以上的事件；1 最重要、3 最不重要，所以只要大事件就填 1

字段说明

• datetime — 事件时间，一律台北时间；没有公布时间的事件以当日 00:00 计
• date / time — 台北日期与 'HH:MM'；未公布发布时间的事件，时间为空
• country / country_name — 国家 ISO 两码与国名
• subject / subject_title — 指标名称，以及该次公布对应的期别
• predict — 市场预期值；没有预期值时为空
• last — 前值，即同一指标前一次公布的数值
• real — 实际值；尚未公布时为空
• unit — 数值单位
• priority — 重要度 1–3，1 最重要