跳至正文
官方发布记录 时点历史数据

官方宏观发布和 FX 回测的点对点历史数据

官方 CPI、工作、GDP 以及央行发布,带有已知时间戳,用于无前瞻性 FX 研究、仪表板和实时系统。

From USD 50/月 · 14 天免费试用 · 随时取消

22 生产级 API 货币
21 追踪的市场
33 API 路径
26y 时点历史数据

无需 API 密钥即可尝试 USD 端点,每天最多 100 次请求。订阅以获得更高的限制、API 密钥、完整历史记录以及所有支持的货币。

无需密钥 · USD · 15 分钟延迟

尝试实时端点(无需密钥)
GET https://api.fxmacrodata.com/v1/announcements/usd/inflation?limit=5

{
  "currency": "USD",
  "indicator": "inflation",
  "data": [
    {
      "date": "2026-08-31",
      "val": 3.4,
      "previous_value": null,
      "announcement_datetime": 1789129800,
      "announcement_datetime_local": null
    },
    {
      "date": "2026-07-31",
      "val": 3.4,
      "previous_value": null,
      "announcement_datetime": 1786537800,
      "announcement_datetime_local": null
    }
  ]
}

Add X-API-Key 针对所有 22 货币,实时发布和完整历史。

还没有密钥?创建一个免费账户以获取 USD 发布警报。

公告记录 . fxmacrodata.com
200 OK JSON
响应 . 公告回放 EUR/USD . EUR
预览公告回放
EUR/USD 围绕活跃的 EUR 公告
1.1188 预览
加载中 --:-- UTC
正在加载公告
共识 -- 实际值 -- 1D FX --
公布日 -- 下一天 --
现货 公布日

为什么团队信任它

官方来源

发布数值来自官方发布机构、中央银行和统计局。

发布时间戳

公告行保留 UTC 发布时间戳,用于事件研究、仪表板、研究任务和实时系统。

数十年的历史数据

时点记录显示了每个日期已知的信息,因此回测不会借用未来信息。

主权汇率 · 官方来源

按国家划分的政府债券收益率,从长端向下排列。

30 年期是财政供应、通胀风险和期限溢价首先显现之处。在一个表格中比较所有已发布的市场,然后打开任何期限、国家或曲线。

Latest available observations As of
Market 30Y yield Change 52-week range vs 10Y
United StatesUSD 5.60% +0 bp 4.54–5.67% +36 bp
EurozoneEUR 4.46% +0 bp 3.76–4.53% +35 bp
JapanJPY 4.08% -5 bp 3.06–4.17% +106 bp
United KingdomGBP 5.96% -5 bp 5.18–6.04% +59 bp
SwitzerlandCHF 0.59% +1 bp 0.23–0.77% +2 bp
CanadaCAD 4.28% -3 bp 3.51–4.31% +36 bp
ChinaCNY 2.07%52W low -2 bp 2.07–2.39% +40 bp

免费小部件

在您自己的网站上放置实时经济日历。

在几分钟内将官方来源的宏观数据嵌入到博客、经纪商教育页面或交易社区中。只需一段代码,无需 API 密钥,且它会自动保持更新。

  • 现成的组件经济日历、发布倒计时、央行利率、通胀热力图、实时发布滚动条和 FX 货币对图表。
  • 由您配置选择货币、主题、语言和时区。每个小部件会根据其内容自动调整大小。
  • 免费使用(需注明出处)只要 FXMacroData 链接保持可见,在公共页面上即为免费。
实时组件 economic-calendar

产品优势

将每一次宏观发布转化为可交易的时间戳

实时报告、特定时间点历史、日历、导出、MCP 和 API 访问权限都解析为相同的感知发布记录,因此您的实时工作流和回测使用相同的语言。

发布工作流 官方来源至模型输入
发布 官方行捕获

官方发布值已归一化到公告记录中。

known_at 时间戳已保留

市场可见的时间成为研究边界。

回放 回测安全的连接

模型仅能看到当时已公开的数值。

merge_asof announcement_datetime <= model_time
发布数据 实时

官方宏观公告记录

使用带有公告时间戳的央行和统计局发布记录,用于警报、仪表板和 FX 研究系统。

为警报、仪表板和 FX 系统归一化的官方宏观发布记录
探索实时公告 ->

回测覆盖范围

查看您的时点回测可以达到多高的精度

在选择研究范围之前,请检查货币、指标和历史深度,然后按每个数值变为公开的时间点加入发布内容。

货币

22 生产级 API 货币 · 21 markets tracked

API 路径

33 即插即用的数据集

历史深度

26y 时点记录
公告覆盖范围

按发布类型划分的时间点历史数据

8 类型

API 端点目录

所有 FXMacroData 端点都在一个页面上

浏览客户询问的完整 REST 表面:市场共识预测、公告、发布日历、FX 价格、大宗商品、COT 持仓、新闻稿、交易时段、主权数据、贸易、住房等。

预测层

市场共识数据可在 Predictions 端点中获取

一个附加在每个宏观发布记录上的统一预测层。调查、央行自有预测、IMF 世界经济展望以及 FXMacroData 混合预测 —— 全部作为每次公告的预测列表返回,并通过稳定的 announcement_id 与实际值关联。

已发布的市场共识和调查预测 央行自有预测 (RBNZ MPS、BoC MPR、ECB SPF、RBA SoMP 等) IMF 世界经济展望关于通胀和 GDP 的预测 FXMacroData 对每个公告、每种支持货币的混合预测
GET 需要计划 · 包含在每个付费计划中
/api/v1/predictions/{currency}/{indicator} 打开示例

健康状况

健康状况 & 基础设施

2 路径

健康检查和低摩擦的 API 可用性探测。

GET /api/v1/health

Ping API

始终免费
GET /api/v1/ping

Ping API

始终免费

数据目录

数据目录

1 路径

按货币查看可用指标的发现与元数据。

GET /api/v1/data_catalogue/{currency}

获取当前可用的宏观经济指标

始终免费

公告

公告

3 路径

带有官方发布时间戳的宏观经济公告时间序列。

GET /api/v1/announcements/{currency}/latest

获取某种货币所有指标的最新值

始终免费
GET /api/v1/announcements/{currency}/{indicator}

获取宏观经济指标数据

个人版 (USD: 无密钥 100/天)
POST /api/v1/research/panel

构建一个在每个决策时间点已知数值的面板

需要个人 API 密钥

预测

预测

4 路径

预测、共识、央行预测以及 FXMacroData 预测。

GET /api/v1/predictions/coverage

哪些预测发布者覆盖了哪些货币(无需 API 密钥)

始终免费
GET /api/v1/predictions/coverage/{currency}

单种货币的单指标预测覆盖范围(无 API 密钥)

始终免费
GET /api/v1/predictions/{currency}

来自一家发布者的页面官方预测版本

始终免费
GET /api/v1/predictions/{currency}/{indicator}

列出一种货币指标的预测

需要个人 API 密钥

日历

发布日历

4 路径

即将发布的宏观和政策发布时间表。

GET /api/v1/calendar/{currency}

获取即将到来的经济数据发布日期

个人版 (USD: 无密钥 100/天)
GET /api/v1/calendar/{currency}/coverage

Inspect calendar archive evidence coverage and capture gaps

需要个人 API 密钥
GET /api/v1/calendar/{currency}/events/{archive_event_id}/versions

Get immutable schedule versions for an event

需要个人 API 密钥
GET /api/v1/calendar/{currency}/snapshot

Get the economic schedule known at a historical time

需要个人 API 密钥

发布事件

发布事件 & 流式传输

2 路径

针对新摄取的经济发布,提供轮询、SSE 和 WebSocket 传输。

GET /api/v1/announcements/changes

投票调查最近的实时公告发布变更

混合访问权限
GET /api/v1/stream/events

订阅实时公告事件 (SSE)

混合访问权限

因素

因素

1 路径

用于模型输入和跨货币比较的预计算宏观因子评分。

GET /api/v1/factors/{currency}/{factor}

获取单一货币的预计算 FX 因子

个人版 (USD: 无密钥 100/天)

外汇参考汇率

FX 汇率 & 参考汇率

6 路径

官方 FX 参考利率的每日、日内和时段视图。

GET /api/v1/forex/{base}/{quote}

获取 FX 即期汇率

需要个人 API 密钥
GET /api/v1/fx/intraday-reference-rates/{base}/{quote}

获取订阅者日内 FX 参考汇率

需要个人 API 密钥
GET /api/v1/fx/reference-rates/{base}/{quote}

获取带有时间戳的官方 FX 参考汇率

需要个人 API 密钥
GET /api/v1/fx/session-rates/{base}/{quote}

获取官方 FX 结算参考汇率

需要个人 API 密钥
GET /api/v1/fx/source-universe

列出公开的 FX 参考利率对全集

始终免费
GET /api/v1/fx/sources

列出公开的 FX 参考利率来源

始终免费

利率曲线

利率、曲线 & 差额

3 路径

用于利率感知型 FX 分析的收益率曲线视图和货币对利率差。

GET /api/v1/curves/{currency}

按货币获取曲线分析

需要个人 API 密钥
GET /api/v1/financial_prices/{currency}

官方金融价格和收益率曲线

需要个人 API 密钥
GET /api/v1/rate_differentials/{base}/{quote}

获取货币对利率差

需要个人 API 密钥

市场背景

市场背景

3 路径

FX 市场时段状态和广泛的风险偏好/风险规避背景,用于择时和机制过滤。

GET /api/v1/market_sessions

FX 市场交易时段时间表

始终免费
GET /api/v1/risk_sentiment

全球风险偏好 / 风险厌恶指标

始终免费
GET /api/v1/risk_sentiment/changes

记录的风险情绪变化

始终免费

cot 持仓

COT 定位

1 路径

CFTC 按货币划分的交易员持仓期货头寸。

GET /api/v1/cot/{currency}

获取 CFTC 持仓报告 (COT) 数据

个人版 (USD: 无密钥 100/天)

商品

大宗商品

2 路径

贵金属、OPEC 以及商品相关端点。

GET /api/v1/commodities/latest

获取所有商品指标的最新值

需要个人 API 密钥
GET /api/v1/commodities/{indicator}

获取商品指标数据

需要个人 API 密钥

官方更新

官方新闻稿

1 路径

来自官方渠道的央行新闻稿和政策沟通。

GET /api/v1/press-releases/{currency}

最近的央行新闻稿

个人版 (USD: 无密钥 100/天)
智能体负载 发布感知
{
  "tool": "indicator_query",
  "currency": "USD",
  "indicator": "inflation",
  "mcp_metadata": {
    "source_type": "official",
    "has_announcement_datetime": true,
    "point_in_time_safe": false,
    "assumed_release_time_count": 997,
    "returned_count": 100
  },
  "next_step": "join EUR/USD around the release window"
}

对 AI 回答至关重要的字段与对回测至关重要的字段相同:时机、来源、新鲜度和可重现的端点访问。

评论

支持真实研究产品的宏观数据

构建者使用 FXMacroData 将发布日历、宏观指标、FX 数据和仓位背景连接到透明的研究工作流中。

查看由 FXMacroData 构建的内容
★★★★★ 已验证客户
“FXMacroData 对 AXIOM FX 非常有价值,因为它让我们能够在一个地方结构化地访问宏观经济指标、发布日历、FX 数据和持仓信息。它帮助我们构建了一个更加透明、可审计且具有机构风格的宏观研究工作流。”
Fagner Oliveira 创始人兼开发者,AXIOM FX
阅读 AXIOM FX 构建故事 ->

FAQ

在选择方案前查看简短回答

FXMacroData 的用途是什么?

官方宏观公告记录和数十年的点对点历史,用于 FX 研究、无前瞻性回测、仪表板和实时系统。

我的团队如何使用这些数据?

通过 API、Python、MCP、数据导出、仪表板、小部件、流式馈送和经批准的重新分发工作流来使用它。 打开功能.

您是否提供市场共识或预测数据?

是的。使用 /api/v1/predictions/{currency}/{indicator} 用于将市场共识、调查、央行、IMF 以及 FXMacroData 预测行与已实现的公告进行关联。

我如何检查数据是否符合我的回测?

使用覆盖范围页面检查每个市场和指标的历史深度,然后通过其已知发布时间戳连接记录,进行时点回测。 开放数据覆盖范围.

支持

需要确认发布或回测工作流吗?

发送市场、指标以及您是否需要发布监控、历史研究、执行或再分发。