Economic Calendar API

Forex Factory Economic calendar for forex & markets: this week's scheduled events with forecasts, previous values and impact ratings for USD, EUR, GBP, JPY and all major currencies. Served from a database — millisecond responses, not 20-second scrapes. All times UTC.

原始信息汇总

数据集概述：Economic Calendar API

该API提供了一种快速、高效的方式获取全球主要货币的预定经济事件数据，专为交易应用、仪表板、警报机器人和专家顾问（EA）等场景设计。

核心特性与优势

• 极速响应：数据从索引数据库中提供，而非每次请求时抓取源数据，响应时间在毫秒级别，平均延迟为579ms。
• 数据覆盖全面：涵盖所有主要货币（USD, EUR, GBP, JPY, AUD, NZD, CAD, CHF, CNY）的经济事件，包括利率决策、CPI、非农就业数据、央行讲话、PMI、节假日等。
• 丰富的数据字段：每个事件包含forecast（预测值）和previous（前值）的原始显示字符串（如"218K"、"3.2%"），以及impact（影响评级：高/中/低/节假日）。
• 标准时间格式：所有时间均采用UTC时区的ISO-8601格式，无需进行时区转换。
• 灵活的组合过滤：可在每个端点上使用currency（货币）和impact（影响评级）参数进行过滤。

API端点

端点	功能描述
GET /v1/calendar?date=YYYY-MM-DD	获取指定UTC日期的所有事件。
GET /v1/calendar/week?start=YYYY-MM-DD	获取从指定日期开始的7天窗口内的事件。
GET /v1/calendar/upcoming?hours=48	获取未来N小时内即将发生的事件（默认48小时，范围1-336小时）。

数据覆盖范围

覆盖从当前周开始滚动更新的数据，并在当天持续刷新。

典型用例

• 盘前新闻警报：轮询/v1/calendar/upcoming端点，在高影响事件发生前发送通知。
• 交易仪表板：使用/v1/calendar端点显示每日经济日历。
• EA/机器人新闻过滤器：在针对相关货币的高影响事件期间暂停交易。

错误代码

• 403：请求未通过RapidAPI发送（缺少或无效的密钥）。
• 422：参数错误（如日期格式无效、影响评级值未知）。