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.
Last updated
Graph-first Web Story
A faster visual explanation of the product
The story shows the FXMacroData path from macro release timing to dashboard context, cross-currency charts, and API-ready rows. It belongs here because this is the canonical product definition page; the API reference keeps the longer walkthrough videos.
Core data
CPI, GDP, policy rates, jobs, calendars, FX spot, COT, commodities, bond yields, and thematic macro context.
Current surface
29 public API paths across 13 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 no-key evaluation up to 100/day, 15-minute release delay; Individual or Enterprise API key for non-USD, deeper history, and higher volume. |
| Release Calendar | /api/v1/calendar/{currency} |
Upcoming economic releases and central-bank events by currency. | Public endpoint. |
| Predictions | /api/v1/predictions/{currency}/{indicator} |
Forecasts, consensus, central-bank projections, and FXMacroData blended forecasts joined to actuals. | USD no-key evaluation up to 100/day, 15-minute release delay; Individual or Enterprise API key for non-USD, deeper history, and higher volume. |
| 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 no-key evaluation up to 100/day, 15-minute release delay; Individual or Enterprise API key for other supported currencies and higher volume. |
| Commodities | /api/v1/commodities/{indicator} |
Gold, silver, and platinum price series for cross-asset macro context. | Individual or Enterprise API key required. |
| Rates and Curves | /api/v1/rate_differentials/{base}/{quote} |
Rate differentials, curve nodes, curve proxies, forwards, and forward differentials. | Individual or Enterprise API key required. |
| News and Press Releases | /api/v1/press-releases/{currency} |
Official central-bank and policy-publisher release context. | Mixed public and API-key access by family. |
| Macro Factors and Risk | /api/v1/factors/{currency}/{factor} |
Derived monetary-stance factors and cross-asset risk-sentiment context for macro regime work. | USD no-key evaluation up to 100/day, 15-minute release delay; Individual or Enterprise API key for other supported currencies. |
| Discovery | /api/v1/data_catalogue/{currency} |
Per-currency indicator catalogue with coverage, history windows, and endpoint capability metadata. | Public endpoint. |
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.