即時央行數據源 AI Native · MCP Server

透過即時數據更快交易 宏觀發布數據

來自中央銀行和統計機構的標準化、帶時間戳的 API 數據源。官方發布後 50 毫秒內即時傳送公告。

起價 $25/月 · 14 天免費試用

覆蓋範圍地圖

對應影響外匯的宏觀樞紐

所有 14 種支援的貨幣都涵蓋在公告、日曆和外匯現貨端點中 — 這些是驅動貨幣對定價的完整宏觀樞紐。

貨幣覆蓋範圍

涵蓋主要地區的 14 種貨幣

所有支援貨幣的完整公告和外匯現貨覆蓋。 查看完整指標目錄 →

14 種貨幣 9 個公開路由 發布 + 外匯現貨 + 日曆

端點清單

可用的公告端點

按宏觀領域分組 — 透過公告 API 可用的每個指標。

類別

Economy
6 個端點
gdp
inflation
ppi
retail_sales
trade_balance
current_account_balance

類別

Labor Market
5 個端點
unemployment
employment
full_time_employment
part_time_employment
participation_rate

類別

Monetary Policy
2 個端點
policy_rate
risk_free_rate

類別

Money Supply
3 個端點
m1
m2
m3

類別

Government Bond Yields
5 個端點
gov_bond_2y
gov_bond_3y
gov_bond_5y
gov_bond_10y
inflation_linked_bond
AI 原生 · MCP Server

宏觀數據融入您的 AI 工作流程

FXMacroData MCP 伺服器讓 Claude、Cursor、VS Code 和任何與 MCP 相容的 AI 主機直接查詢即時央行數據 — 無論交易員和分析師身在何處。

Claude (網頁版與桌面版)

在 Claude 設定中將 FXMacroData 添加為遠端 MCP 連接器。以簡單的英文詢問即時政策利率、CPI、GDP 和外匯現貨歷史數據 — 無需編碼。

VS Code 與 Cursor

在編輯器的連接器面板中添加 MCP 端點。每次編碼會話中都有即時宏觀背景 — 無需複製貼上,無需切換上下文。

自訂代理與 SDK

任何 MCP 相容的執行環境。支援 OAuth 2.0 或 API 密鑰驗證的可串流 HTTP 傳輸。建立宏觀感知代理、警報和管道。

Claude claude.ai
FXMacroData 已連接
中央銀行利率的 EUR 對 USD 利率差異是多少?
indicator_query(currency="eur", indicator="policy_rate")
indicator_query(currency="usd", indicator="policy_rate")
工具結果
ECB (EUR) policy_rate: 4.25%
Fed (USD) policy_rate: 5.50%
差異: −1.25% (USD 溢價)
根據最新的中央銀行數據, 聯準會利率 5.50% 超過 歐洲央行利率 4.25%125 個基點,支持 EUR/USD 頭寸中 USD 的持續走強。
詢問外匯宏觀數據...

完整設定指南與工具參考 →

覆蓋範圍

宏觀驅動型外匯工作流程所需的一切

從經濟數據發布到訊號生成,提供完整的指標覆蓋、發布日曆和實施路徑,適用於量化交易員、系統研究員和開發人員。

回測完整性

無未來數據偏差 — 時間點數據

每個經濟數據發布都標註了其實際的 公告日期時間,而不僅僅是參考期間。當您在歷史時間窗口進行回測時,您的模型只會看到在該確切時刻公開可用的數據 — 與真實交易條件相符。與 pandas 相容 merge_asof、事件研究框架和向量化訊號管道。

數據即時性

即時央行數據源

公告數據在中央銀行和統計機構官方發布後 50 毫秒內即時傳送 — FRED, ECB, RBA, BoE, SNB, BoJ, BoC, and RBNZ。無中間延遲。無需過時輸入,即可建立即時訊號監控器、利率差異儀表板或事件觸發的執行邏輯。

數據品質

跨來源標準化

每個指標在所有支援的貨幣中都使用一致的單位、欄位名稱和 JSON 結構。無需特定於貨幣的解析邏輯。響應直接轉換為 pd.DataFrame帶有 ISO 8601 時間戳 — 準備用於 resample(), rolling()和跨貨幣價差計算。

整合

專為研究管道而建

同步和非同步 Python 客戶端、REST 端點以及用於快速原型設計的 Postman 集合。在 Jupyter notebook、排程的 Airflow 作業或即時交易訊號引擎中使用相同的數據模型 — 環境之間無需更改結構。

REST 端點覆蓋範圍

9 個專注於外匯宏觀工作流程的端點

經濟指標公告系列、發布日曆、COT 持倉、外匯即期匯率、交易時段和商品基準 — 都在一個一致的 API 中。

4 Always free Calendar, data catalogue, forex, and market sessions require no API key.
1 Pro (USD free) Announcements are mixed-access: USD is public, while non-USD currencies require a Professional API key.
2 Pro key required COT and commodities require a Professional API key for every request.

Macro Indicator Series

USD free · Pro key for others

Point-in-time macro releases with announcement timestamps

Historical macroeconomic indicator series stamped with the exact datetime of official publication. GDP, inflation, policy rates, unemployment, and more across 14 currencies.

  • Announcement-timestamped observations for event-driven backtesting
  • 14 currencies with 20+ indicators per currency
  • Central bank target metadata included where applicable
  • Period-over-period and 12-month percentage change enrichment
Announcements

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

"currency": USD
"indicator": inflation
"data[0].date": 2026-03-28
"data[0].val": 2.8
"data[0].announcement_datetime": 1772272800
"data[0].pct_change": -0.3

Forecast Layer

USD free · Pro key for others

Every release joined to consensus, central-bank and FXMacroData forecasts

A unified forecast layer attached to every macro release. Surveys, central-bank own projections, IMF World Economic Outlook, and the FXMacroData blended forecast — all returned as a list of predictions on each announcement, joined to actuals via a stable announcement_id.

  • Market consensus and survey predictions where published
  • Central-bank own projections (RBNZ MPS, BoC MPR, ECB SPF, RBA SoMP, and more)
  • IMF World Economic Outlook projections for inflation and GDP
  • FXMacroData blended forecast on every announcement, every supported currency
  • Joined to realised values via a stable announcement_id field
Predictions

GET /api/v1/predictions/{currency}

"currency": USD
"data[0].announcement_id": usd_inflation_2026-03-28
"data[0].predictions[0].prediction_type": fxmacrodata
"data[0].predictions[0].prediction_source": fxmacrodata_blended
"data[0].predictions[0].prediction_source_label": FXMacroData Blended Forecast
"data[0].predictions[0].predicted_value": 2.7

Release Scheduling

Always free

Upcoming macro release dates for every currency

Upcoming release dates sorted by announcement timestamp. Filter by currency and indicator to build targeted event monitors and scheduling pipelines.

  • 18 currencies plus commodity release schedules (COMM)
  • Optional indicator filter for targeted scheduling
  • Cross-domain rows with routing metadata for COT, commodities
  • Pre-sorted by announcement timestamp for pipeline consumption
Release Calendar

GET /api/v1/calendar/{currency}

"currency": JPY
"data[0].release": policy_rate
"data[0].announcement_datetime": 1774580400
"data[1].endpoint_family": cot
"data[1].endpoint_path": /v1/cot/jpy
"data[1].requires_api_key": true

Indicator Discovery

Always free

Discover available indicators and metadata per currency

Programmatic indicator discovery with name, unit, frequency, and forecast metadata. Use it to enumerate what is available before querying announcement series.

  • Full indicator inventory per currency with metadata
  • Unit, frequency, and official forecast flag per indicator
  • Optional capabilities flag adds route and auth discovery
  • Optional coverage flag adds cross-currency availability grid
Data Catalogue

GET /api/v1/data_catalogue/{currency}

"gdp.name": GDP
"gdp.unit": %QoQ
"gdp.frequency": Quarterly
"inflation.name": Inflation CPI
"inflation.unit": %YoY
"policy_rate.frequency": Meeting

FX Spot Rates

Always free

Daily FX spot rates with optional technical indicators

Historical daily spot-rate series for any supported currency pair. Append technical indicators like SMA, RSI, MACD, and Bollinger Bands to each row with a single query parameter.

  • Any pair combination across supported currencies
  • Optional technical indicators: SMA, RSI, MACD, Bollinger Bands
  • Date range filtering with sensible defaults
  • JSON-native output ready for charting and analysis
Forex

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

"base": EUR
"quote": USD
"data[0].date": 2026-03-28
"data[0].val": 1.0842
"data[1].date": 2026-03-27
"data[1].val": 1.0836

Session Timing

Always free

Real-time FX session and overlap timetable

Live open/close state for Sydney, Tokyo, London, and New York sessions plus overlap windows with peak-liquidity metadata. Use for market-timing, session-aware execution, and dashboard displays.

  • Four major sessions with real-time open/close state
  • Overlap windows with liquidity priority ratings
  • Historical snapshots via optional timestamp parameter
  • Holiday-aware market day detection
Market Sessions

GET /api/v1/market_sessions

"is_market_day": true
"sessions[0].name": London
"sessions[0].is_open": true
"sessions[0].seconds_to_close": 18000
"overlaps[0].name": London / New York
"overlaps[0].priority": high

Market Positioning

Pro key required

Weekly CFTC speculative positioning by currency

Net speculative positioning from the CFTC Legacy Futures-Only report. Includes open interest, long/short splits for commercial, non-commercial, and non-reportable categories with FX spot overlay metadata.

  • 8 major currencies mapped to CME FX futures contracts
  • Full long/short/spread breakdown by trader category
  • Announcement-timestamped for point-in-time accuracy
  • FX spot overlay pair metadata for charting
Commitment of Traders

GET /api/v1/cot/{currency}

"currency": GBP
"instrument": BRITISH POUND - CME
"fx_overlay.pair": GBP/USD
"data[0].date": 2026-03-24
"data[0].open_interest": 245678
"data[0].noncommercial_net": -8020

Precious Metals

Pro key required

Gold, silver, and platinum daily price series

Daily precious metals prices from official fixing sources (LBMA, spot markets) with period-over-period and rolling 12-month change enrichment for cross-asset analysis.

  • Gold (LBMA PM Fix), silver (LBMA Fix), and platinum spot
  • Consistent schema with announcement series for unified pipelines
  • Percentage change and 12-month rolling change enrichment
  • Date range filtering with sensible defaults
Commodities

GET /api/v1/commodities/{indicator}

"currency": COMM
"indicator": gold
"data[0].date": 2026-03-28
"data[0].val": 2870.00
"data[0].pct_change": 1.2
"data[0].pct_change_12m": 30.1

包含參數、驗證和範例的完整端點參考

即時串流 SSE · Server-Sent Events

即時發布通知

連接一次,即可在任何經濟數據發布時立即收到推送事件 — 涵蓋所有 18 種貨幣。免費方案:無需驗證即可獲取 USD 事件。專業方案:所有貨幣,可按指標篩選。

快速入門 (USD,無需驗證)

curl -N "https://api.fxmacrodata.com/v1/stream/events"

開發者生態系統

更快地建立您的策略堆疊

透過筆記本、API、文件和社群頻道使用此平台,這些都適合量化研究和開發者入門。

GitHub

GitHub

原生 fxmacrodata 套件,實現 pandas 和 NumPy 的無縫整合。

在 GitHub 上查看 →
Postman

Postman

使用我們預先配置的公共工作區,在幾秒鐘內測試我們的端點。

探索集合 →
Hugging Face

Hugging Face

在 Hugging Face 上探索我們的互動式數據儀表板和基本面疊加層。

查看空間 →
Kaggle

Kaggle

閱讀我們關於利率差異和宏觀數據建模的技術分析。

閱讀文章 →
RapidAPI

RapidAPI

透過 RapidAPI 市場存取我們的 API 並管理機構帳單。

在 RapidAPI 上查看 →

開發者 SDK

支援所有語言

使用官方 Python SDK 進行單行存取,或從任何語言呼叫 REST API。查詢參數驗證、JSON 回應、除 HTTP 外零依賴。

終端機
pip install fxmacrodata
from fxmacrodata import Client

client = Client(api_key="YOUR_API_KEY")

# 獲取 USD 通貨膨脹數據(免費,無需金鑰)
cpi = client.get_indicator("usd", "inflation")

# 任何支援貨幣的政策利率
rate = client.get_indicator("eur", "policy_rate")

所有語言的快速入門指南 →

1

官方 Python SDK

安裝 fxmacrodata 來自 PyPI。同步和非同步客戶端,支援 pandas 的輸出,一行程式碼即可存取資料。

2

透過 REST 支援任何語言

標準 JSON API,帶有查詢參數驗證。適用於 Go、R、Java、C#、MATLAB、Rust — 任何可以發出 HTTP 請求的語言。

3

包含 OpenAPI 規範

從已發布的 OpenAPI 綱要.

4

USD 資料免費,無需金鑰

USD 指標無需 API 金鑰即可運作,因此您可以在訂閱前探索資料結構並建立模型。

可嵌入小工具

將即時宏觀圖表新增至任何頁面

FXMacroData 儀表板中的每個圖表都有可嵌入版本。選擇一個圖表,複製一個 <iframe> 程式碼片段,然後將互動式利差交易、收益率差、通貨膨脹和即期匯率圖表新增到您的研究網站或交易部落格 — 無需 API 金鑰。

  • 9 種圖表類型 — 利差、收益率、通貨膨脹、失業率、貿易差額等
  • 任何支援的貨幣對 — EUR/USD、GBP/USD、USD/JPY 等
  • 適用於任何 HTML 頁面、WordPress、Notion 或靜態網站
EUR/USD 利差交易 利率
<iframe src="https://fxmacrodata.com/dashboard/embed/EUR_USD/carryChart" width="100%" height="400" ...></iframe>

免費資料下載

下載 CSV 或 JSON 格式的宏觀資料集

FXMacroData 儀表板中的每個指標都可供下載。USD 資料對所有使用者免費 — 無需登入。透過 Pro 訂閱解鎖所有 14 種貨幣。

  • 政策利率、通貨膨脹、GDP、失業率、貿易差額等
  • CSV 和 JSON — 適用於 pandas、R 或任何資料管道
  • 由 Google Datasets 為每種貨幣索引的結構化資料
  • USD 資料永遠免費 — 無需 API 金鑰或帳戶

常見問題

常見問題

關於 FXMacroData 常見問題的快速解答。

數據與覆蓋範圍
數據的即時性如何?

公告數據在官方央行發布後 50 毫秒內即時傳送。

包含哪些數據來源?

FXMacroData 匯總來自 FRED(聯邦儲備銀行)、ECB、RBA 以及全球其他主要央行的數據。

哪些端點是免費的,哪些是付費的?

日曆、數據目錄、外匯和市場時段是公開的。USD 公告是公開的,而非 USD 公告則需要專業 API 金鑰。COT 和商品始終需要專業 API 金鑰。

帳單與訂閱
免費試用需要信用卡嗎?

是的。14 天試用期在註冊時需要有效的信用卡。

我可以隨時取消嗎?

是的,您可以在下一個計費週期之前從您的訂閱設定中取消。

免費試用結束後會發生什麼?

除非在試用期結束前取消,否則您的訂閱將自動轉換為付費方案。您可以在帳單設定中管理此項。

量化與回測
數據是否為時間點數據/無前瞻性偏差?

是的。每個發布都包含一個 announcement_datetime欄位 — 數據實際公開的時間。當您將數據集切片到給定日期時,您只會看到該時間點發布的數據,使其可以直接用於事件驅動的回測。

我可以將其與 pandas 或回測框架一起使用嗎?

是的。所有 API 回應都返回乾淨的 JSON,可以直接轉換為 pd.DataFrame。支援貨幣之間的一致架構允許 pd.concat() 無需重新格式化。適用於 vectorbt、backtrader 和自定義事件研究管道。

技術與支援
你們支援其他程式語言嗎?

是的。官方 Python SDK 可透過 pip install fxmacrodata取得,並且 REST API 適用於任何語言 — Go、R、Java、C#、MATLAB、Rust 等。請參閱 快速入門指南 以獲取多種語言的範例。

包含哪些支援?

所有付費方案均包含針對整合和數據問題的電子郵件支援。請參閱 支援回應目標.

聯絡我們

需要專屬支援?

我們的團隊隨時準備協助您進行技術整合、客製化數據請求或銷售諮詢。