Economic Calendar Fetcher

📅 宏观经济事件一键追踪 · 影响评估智能生成

调用 FMP API 获取央行决议、就业报告、通胀数据等宏观经济日历,生成带影响评估的时序报告,免费版每日限 250 次请求

收藏
20.2k
安装
5k
版本
0.1.0
CLS 安全性认证2026-05-20
点击查看完整报告 >

使用说明

核心用法

Economic Calendar Fetcher 通过 Financial Modeling Prep (FMP) 的经济日历 API,自动化获取未来 7-90 天内的宏观经济事件。用户可指定日期范围(默认未来 7 天)、国家/地区、事件影响级别(高/中/低)进行筛选,最终输出按时间排序的 Markdown 报告,包含事件详情、预期值、前值及市场影响评估。

使用流程:
1. API 密钥配置:通过 FMP_API_KEY 环境变量或命令行参数提供密钥(FMP 免费账户每日 250 次请求)

2. 日期范围设定:支持 YYYY-MM-DD 格式,单次查询上限 90 天

3. 执行脚本get_economic_calendar.py 支持 JSON/Text 输出格式

4. 筛选与解析:按影响级别、国家、事件类型(FOMC/CPI/就业/GDP 等)过滤

5. 生成报告:包含事件时间(UTC+ET 双时区)、市场预期、历史对比、影响分析

显著优点

  • 数据覆盖全面:涵盖美、欧、英、日、中、加、澳等主要经济体,事件类型包括货币政策、就业、通胀、增长、贸易、房地产等
  • 结构化输出:自动生成标准化 Markdown 报告,含影响评估段落,适合投研纪要直接引用
  • 灵活筛选:支持按高/中/低影响级别过滤,快速定位市场关键节点
  • 成本可控:FMP 免费 tier 足以满足个人投资者日常监控需求

潜在局限与风险

  • API 依赖风险:FMP 为第三方商业数据商,存在服务中断、价格调整或数据质量波动可能;免费版速率限制(5 次/秒、250 次/日)可能制约高频查询
  • 数据时效性:经济日历事件虽相对稳定,但具体时间(如央行决议 precise timing)可能临时调整,需每日刷新缓存
  • 无历史深度:技能明确排除历史事件查询,需配合其他工具进行回溯分析
  • 地域覆盖缺口:新兴市场(印度、巴西、东南亚等)覆盖有限,主要聚焦发达经济体
  • 解读主观性:"影响评估"模块依赖内置规则与市场常识,无法替代实时市场微观结构分析

适合人群

  • 主动型股票/外汇/期货交易者:需要提前规划仓位、规避事件风险或捕捉数据公布波动
  • 宏观经济研究员:快速生成周报级经济事件前瞻
  • 组合管理经理:监控央行决议、就业报告等组合层面系统性风险事件
  • 财经内容创作者:获取结构化事件数据用于市场前瞻内容生产

常规风险提示

  • 经济数据 surprises 可能引发极端行情,报告中的"典型波动幅度"仅供参考,不构成交易建议
  • API 密钥需妥善保管,避免在公共代码仓库暴露
  • 免费 tier 超额后将返回 429 错误,关键时段(如非农周)建议提前缓存数据

安全解读

核心用法

Economic Calendar Fetcher 通过 Financial Modeling Prep (FMP) 经济日历 API,拉取未来7-90天内的重大宏观经济事件,涵盖美联储/欧央行/日央行利率决议、非农就业(NFP)、CPI/PPI通胀数据、GDP、零售销售等市场敏感指标。

典型工作流程
1. 获取API密钥:支持环境变量FMP_API_KEY或用户即时输入,免费账户每日250次请求

2. 设定日期范围:默认未来7天,最长90天(API限制),自动校验日期格式与逻辑

3. 执行数据拉取:Python脚本调用https://financialmodelingprep.com/api/v3/economic_calendar

4. 智能筛选:可按影响等级(High/Medium/Low)、国家(US/EU/JP等)、事件类型(FOMC/CPI等)过滤

5. 生成报告:输出按时间排序的Markdown文档,含UTC/美东时间双时区、前值/预期值对比、市场影响深度解读

显著优点

  • 数据权威性高:FMP为知名金融数据服务商,覆盖美欧英日中加澳瑞等主要经济体
  • 影响评估体系化:不仅罗列事件,更提供High/Medium/Low三级冲击评级,结合当前宏观环境(通胀周期/降息预期)分析市场潜在波动(如CPI超预期可能引发S&P 500 1.2%日内波动)
  • 零依赖轻量:纯Python标准库实现(urllib/json/argparse),无供应链攻击风险
  • 灵活输出:支持JSON/文本/Markdown多格式,可落地文件或直返控制台

潜在缺点与局限性

  • 来源可信度T3:维护者为个人开发者,长期维护能力与账号安全性低于企业级方案
  • 数据时效边界:仅支持未来事件查询,历史数据需配合其他工具;超6个月远期数据稀疏
  • API配额限制:免费档250次/日、5次/秒,高频监控需升级付费或自建缓存
  • 无实时推送:需主动轮询,无法像专业终端(Bloomberg/Reuters)那样自动提醒
  • 单一数据源:未交叉验证Investing.com、ForexFactory等备选日历,极端情况下存在漏报风险

适合人群

  • 外汇/股指/利率衍生品交易者,需提前1-7天规划仓位风险敞口
  • 宏观对冲基金分析师,构建周度/月度事件驱动交易框架
  • 个人投资者,替代付费终端获取结构化经济日历(配合免费FMP账户零成本使用)
  • 量化策略开发者,作为事件因子输入至预交易风控系统

常规风险

  • API密钥泄露风险:虽支持环境变量安全注入,但用户误操作可能导致密钥暴露于日志/聊天记录
  • 市场异常波动:高影响事件(如NFP、CPI)常伴随流动性真空、点差扩大、滑点加剧,报告仅作前瞻提示不构成交易建议
  • 数据修正风险:部分指标(GDP、就业)存在多轮修正,初始发布值与最终值可能显著偏离
  • 模型共识偏差:"预期值"为分析师调查共识,实际发布偏离共识时市场反应可能非线性

Economic Calendar Fetcher 内容

references文件夹
scripts文件夹
手动下载zip · 12.6 kB
fmp_api_documentation.mdtext/markdown
请选择文件