Primary users
Economic researchers, analysts, traders, API developers, dashboard builders and AI-agent teams.
Canonical product definition
What is FXMacroData?
FXMacroData is an economic data API for research, dashboards and trading. Explore historical inflation, GDP, employment and policy rates from official publishers through a consistent API. Use the same data in research notebooks, dashboards, trading workflows and AI tools. Check the coverage catalogue for the economies, indicators and history your project needs.
Last updated
Graph-first Web Story
A faster visual explanation of the product
See how official economic releases connect to historical analysis, cross-currency charts, dashboards and API-ready data.
Core data
CPI, GDP, policy rates, jobs, calendars, FX spot, COT, commodities, bond yields, and thematic macro context.
Current surface
41 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
Historical economic data
Compare economic indicators across supported economies and history windows. Retained revisions and publication-time evidence vary by series; observation history alone does not establish complete first-release coverage.
Consistent research access
Use a consistent interface for historical indicators, release calendars and related FX datasets. Preserve source units and frequencies when comparing economies or building a model.
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 | /v1/announcements/{currency}/{indicator} |
Historical CPI, GDP, policy-rate, labor and trade series, with retained revisions and publication evidence where available. | USD no-key announcements cover the latest 90 days, delayed 15 minutes, up to 100 requests/day. Trial or subscriber key required for other currencies, real-time releases and full available history. |
| Release Calendar | /v1/calendar/{currency} |
Upcoming economic releases and central-bank events by currency. | USD calendar is public; other supported currencies require a trial or subscriber API key. The website calendar is publicly viewable. |
| Predictions | /v1/predictions/{currency}/{indicator} |
Available forecasts joined to actuals, with survey consensus, official projections and model estimates labelled separately. | Forecast values require a trial or subscriber API key for every currency, including USD. Forecast coverage metadata is public. |
| FX Markets | /v1/forex/{base}/{quote} |
Stored official FX reference-rate history for macro research; source, fix time and derived crosses must be checked separately from tradable prices. | Trial or subscriber API key required for all pairs. |
| COT Positioning | /v1/cot/{currency} |
Weekly CFTC speculative positioning mapped to major FX futures. | USD positioning is public under the no-key fair-use allowance; trial or subscriber API key required for other supported currencies. |
| Commodities | /v1/commodities/{indicator} |
Gold, silver, and platinum price series for cross-asset macro context. | Individual or Business API key required. |
| Rates and Curves | /v1/rate_differentials/{base}/{quote} |
Rate differentials, curve nodes, curve proxies, forwards, and forward differentials. | Individual or Business API key required. |
| News and Press Releases | /v1/press-releases/{currency} |
Official central-bank and policy-publisher release context. | USD official press releases are public; trial or subscriber API key required for other supported currencies. |
| Macro Factors and Risk | /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 Business API key for other supported currencies. |
| Discovery | /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
FRED offers a broad free macroeconomic library. FXMacroData offers a consistent API for supported economies, historical research, release calendars and trading workflows. Compare the exact series, history and licence needed.
Trading Economics
Trading Economics offers broad international coverage. FXMacroData Individual is USD 50/month for one-person economic research, development and trading. Check required economies and indicators before comparing eligible plans.
Financial Modeling Prep
Equity and company-fundamental API; FXMacroData centers macroeconomic releases, central banks, event calendars, COT, FX spot, and rates.
Generic economic calendars
FXMacroData connects confirmed schedules to available historical observations, research dashboards and API documentation. Forecasts, revisions and publication evidence vary by series and release.