Primary users
FX traders, quant researchers, analysts, API developers, dashboard builders, and AI-agent teams.
Canonical product definition
What is FXMacroData?
FXMacroData is a macroeconomic data API for FX, quant trading, and AI-agent workflows. It standardizes official-source economic releases by currency, preserves when each value was actually published, and connects the same datasets to REST, dashboards, OpenAPI, MCP, and research tools.
Core data
CPI, GDP, policy rates, jobs, calendars, FX spot, COT, commodities, bond yields, and thematic macro context.
Current surface
47 public API paths across 15 documented endpoint groups.
AI access
MCP server, OpenAPI schemas, llms.txt, AI snippets, agent discovery metadata, and a Custom GPT.
What FXMacroData provides
Point-in-time macro data
Announcement rows include the economic reference period and the publication timestamp used for backtesting and event studies. That lets research systems avoid seeing values before they were public.
FX-focused normalization
Data is organized by currency and endpoint family, so releases can be joined to FX pairs, rate differentials, dashboards, calendars, and alerting workflows.
Agent-ready delivery
Developers can use REST and OpenAPI, while AI hosts can connect through MCP, discovery files, and answer-friendly metadata surfaces.
Endpoint family summary
Use this table as the short map of the FXMacroData API surface. The full reference remains the production OpenAPI schema and documentation.
| Family | Endpoint | Use case | Access |
|---|---|---|---|
| Announcements | /api/v1/announcements/{currency}/{indicator} |
Point-in-time CPI, GDP, policy-rate, labor, trade, and other macro release series. | USD freemium window; Professional key for non-USD and deeper history. |
| Release Calendar | /api/v1/calendar/{currency} |
Upcoming economic releases and central-bank events by currency. | Public endpoint. |
| Predictions | /api/v1/predictions/{currency} |
Forecasts, consensus, central-bank projections, and FXMacroData blended forecasts joined to actuals. | USD freemium window; Professional key for non-USD and deeper history. |
| FX Markets | /api/v1/forex/{base}/{quote} |
Stored FX spot history and market-session context for macro event studies. | Public endpoint. |
| COT Positioning | /api/v1/cot/{currency} |
Weekly CFTC speculative positioning mapped to major FX futures. | USD freemium window; Professional key for other supported currencies. |
| Commodities | /api/v1/commodities/{indicator} |
Gold, silver, and platinum price series for cross-asset macro context. | Professional key required. |
| Rates and Curves | /api/v1/rate_differentials/{base}/{quote} |
Rate differentials, curve nodes, curve proxies, forwards, and forward differentials. | Professional key required. |
| News and Press Releases | /api/v1/press-releases/{currency} |
Official central-bank and policy-publisher release context. | Mixed public and Professional access by family. |
| Thematic Macro Context | /api/v1/housing/{currency} |
Housing, fiscal, trade, tariffs, energy costs, event risk, and other country context datasets. | Mostly public discovery/context endpoints, with some Professional datasets. |
How FXMacroData differs from alternatives
FRED API
Broad US economic database; FXMacroData is FX workflow-oriented with multi-currency release timing, calendars, MCP, and trading-facing endpoint families.
Trading Economics
Broad global economics terminal/API; FXMacroData focuses on standardized FX macro endpoints, known-at timestamps, dashboards, and AI-agent integration.
Financial Modeling Prep
Equity and company-fundamental API; FXMacroData centers macroeconomic releases, central banks, event calendars, COT, FX spot, and rates.
Generic economic calendars
Calendars usually stop at event scheduling; FXMacroData links calendar rows to historical announcement data, endpoint paths, dashboards, and API examples.