Official CPI, jobs, GDP, and central-bank releases with known-at timestamps for no-lookahead FX research, dashboards, and live systems.
Try USD endpoints without an API key for up to 100 requests/day. Subscribe for higher limits, API keys, full history, and all supported currencies.
Start here
Not ready for a key? Create a free account for USD release alerts.
Why teams trust it
Official sources
Release values come from official publishers, central banks, and statistics offices.
Release timestamps
Announcement rows preserve UTC release timestamps for event studies, dashboards, research jobs, and live systems.
Decades of history
Point-in-time records show what was known at each date, so backtests do not borrow future information.
Start here
Go directly to the data, workflows, and licensing that fit how you work.
Track releases, compare macro conditions, and move into pair-level dashboards.
For product teams Build with the APIUse examples, dashboards, widgets, and deployment patterns in your own product.
For agents AI and automationConnect models and agent frameworks through MCP, REST, and structured context.
For organizations Enterprise dataPlan team access, service requirements, governance, and commercial usage.
Explore macro data
Research library
Product workbench
FXMacroData is not just a list of endpoints. The same announcement-timestamped records connect human review, code, dashboards, and agent workflows.
Browse confirmed macro events by currency, local time, source, and release type before the data lands in a workflow.
REST API Pull the release recordUse production endpoints with consistent fields for value, announcement time, source context, pagination, and forecasts.
GET /v1/announcements/usd/inflation
{
"date": "2026-06-30",
"val": 2.7,
"announcement_datetime": 1784032200
}Review EUR/USD around macro events, then move into the same pair, release, and endpoint in code.
MCP and AI Give agents sourced macro contextLet AI tools call FXMacroData instead of relying on model memory, then return source-linked research payloads.
Product benefits
Live reporting, point-in-time history, calendars, exports, MCP, and API access all resolve to the same release-aware record, so your live workflow and backtest speak the same language.
Official publisher values are normalized into the announcement record.
The market-visible time becomes the research boundary.
Models only see values that were public at that point.
announcement_datetime <= model_time
Use central-bank and statistics-office release records with announcement timestamps for alerts, dashboards, and FX research systems.
Backtest against decades of records that preserve when each macro value was known to the market.
Learn more ->Plan around upcoming macro releases by currency through dashboards, API access, and refreshable calendar feeds.
Learn more ->Use browser tools for CFD macro maps, point-in-time backtests, FX pairs trading, and carry-trade research.
Learn more ->Ask AI tools for release-aware macro context without manually copying tables between apps.
Learn more ->Copy tested prompts for macro briefings, event risk, pair research, backtests, visuals, and MCP-native agent workflows.
Learn more ->Download release-aware macro history for notebooks, spreadsheets, archives, and downstream model inputs.
Learn more ->Bring announcement-timestamped releases and point-in-time history into notebooks, jobs, dashboards, and production systems.
Learn more ->Market summary, pair dashboards, calendars, COT, commodities, bond yields, sessions, and press releases.
Learn more ->Backtest coverage
Check currency, indicator, and history depth before choosing a research universe, then join releases by the time each value became public.
Currencies
17 production API currencies · 36 markets trackedAPI paths
21 ready-to-use datasetsHistory depth
26y point-in-time recordsFull API = fully enabled in the production REST + MCP API today. Tracked = dashboards, docs, and history published while production API access rolls out.
Europe
6 full API · 9 trackedAsia
5 full API · 12 trackedCPI, core inflation, trimmed means, PPI, PCE, and inflation-expectation releases where published.
Unemployment, employment levels, payrolls, participation, job openings, and wage measures.
Policy rates, risk-free rates, deposit rates, liquidity settings, and official balance-sheet releases.
GDP, retail sales, industrial production, durable goods, business confidence, consumer confidence, and other activity indicators.
Trade balances, current accounts, import/export data, terms of trade, and commodity-linked activity series.
Money supply, credit aggregates, central-bank reserves, FX reserves, and gold-reserve series.
Housing starts, permits, approvals, house-price indexes, and mortgage-rate series.
Government yield nodes, inflation-linked yields, breakevens, and curve-ready rates history.
API endpoint directory
Browse the complete REST surface customers ask about: market consensus predictions, announcements, release calendars, FX prices, commodities, COT positioning, press releases, sessions, sovereign data, trade, housing, and more.
Forecast Layer
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.
/api/v1/predictions/{currency}/{indicator}
Open example
Common docs paths
/api/v1/calendar/{currency}
Calendar docs
Actual values
Read published values and previous rows after an announcement is released.
/api/v1/announcements/{currency}/{indicator}
Announcement docs
Forecasts
Distinguish market consensus, central-bank, IMF, and FXMacroData forecasts, then join each one to its release.
/api/v1/predictions/{currency}/{indicator}
Forecast docs
Quickstart and keys
Create a key, use query-parameter auth, and copy starter Python requests.
api_key=YOUR_API_KEY
Quickstart
health
Health checks and low-friction API availability probes.
/api/v1/ping
Ping the API
Always freedata catalogue
Discovery and metadata for available indicators by currency.
/api/v1/data_catalogue/{currency}
Get Currently Available Macroeconomic Indicators
Always freeannouncements
Macroeconomic announcement time series with official release timestamps.
/api/v1/announcements/{currency}/latest
Get latest stored values for all indicators in a currency
Always free/api/v1/announcements/{currency}/{indicator}
Get macroeconomic indicator data
Pro (USD: no-key 100/day)predictions
Forecasts, consensus, central-bank projections, and FXMacroData predictions.
/api/v1/predictions/{currency}/{indicator}
List predictions for one indicator of a currency
Pro (USD: no-key 100/day)calendar
Upcoming macro and policy release schedules.
/api/v1/calendar/{currency}
Get upcoming economic data release dates
Always freerelease events
Polling, SSE, and WebSocket delivery for newly ingested economic releases.
/api/v1/announcements/changes
Poll recent live announcement release changes
Mixed access/api/v1/stream/events
Subscribe to real-time announcement events (SSE)
Mixed accessfactors
Precomputed macro factor scores for model inputs and cross-currency comparison.
/api/v1/factors/{currency}/{factor}
Get a precomputed FX factor for one currency
Pro (USD: no-key 100/day)fx reference rates
Daily FX spot history plus one subscriber intraday FX reference-rate endpoint.
/api/v1/forex/{base}/{quote}
Get FX spot rates
Professional subscriber API key required/api/v1/fx/intraday-reference-rates/{base}/{quote}
Get subscriber intraday FX reference rates
Professional subscriber API key required/api/v1/fx/source-universe
List public FX reference-rate pair universe
Always free/api/v1/fx/sources
List public FX reference-rate sources
Always freerates curves
Yield-curve views and pair rate differentials for rates-aware FX analysis.
/api/v1/curves/{currency}
Get curve analytics by currency
Professional subscriber API key required/api/v1/rate_differentials/{base}/{quote}
Get pair rate differentials
Professional subscriber API key requiredmarket context
FX market-session status and broad risk-on/risk-off context for timing and regime filters.
/api/v1/market_sessions
FX market session timetable
Always free/api/v1/risk_sentiment
Global risk-on / risk-off indicator
Always freecot positioning
CFTC Commitment of Traders futures positioning by currency.
/api/v1/cot/{currency}
Get CFTC Commitment of Traders (COT) data
Pro (USD: no-key 100/day)commodities
Precious metals, OPEC, and commodity-related endpoints.
/api/v1/commodities/latest
Get latest stored values for all commodity indicators
Professional subscriber API key required/api/v1/commodities/{indicator}
Get commodity indicator data
Professional subscriber API key requiredofficial updates
Central-bank press releases and policy communications from official sources.
/api/v1/press-releases/{currency}
Recent central bank press releases
Pro (USD: no-key 100/day)AI data layer
Connect AI assistants, notebooks, dashboards, and alerts to the same release-aware macro records used across the FXMacroData API and dashboard.
{
"tool": "indicator_query",
"currency": "USD",
"indicator": "inflation",
"mcp_metadata": {
"source_type": "official",
"has_announcement_datetime": true,
"point_in_time_safe": true,
"returned_count": 100
},
"next_step": "join EUR/USD around the release window"
}The fields that matter for AI answers are the same fields that matter for backtests: timing, provenance, freshness, and reproducible endpoint access.
Open source integrations
Explore a growing catalogue of merged integrations for FX research, backtesting, and macro-event-aware workflows.
Use it where you work
Move from visual inspection to code, agents, and downstream delivery without switching to a different macro dataset.
Bring live releases and point-in-time history into notebooks, jobs, and production systems.
Ask AI tools for release-aware macro context without pasting tables between apps.
Connect hosted MCP, Custom GPT, Codex plugin package, prompts, and LLM-readable docs from one setup page.
Map CFD symbols to macro drivers, then move into backtesting, pairs, and carry-trade workspaces.
Inspect EUR/USD releases and history visually before using the same data in code.
Use Copilot, Notion, Apple, Pine Script, MetaTrader, and NinjaTrader guides.
Let retrieval systems find the right docs, prompts, agent manifest, and API contract without manual routing.
Build FX dashboards, client portals, market tools, and AI workflows with APIs, widgets, and source-backed macro data.
Latest research
Dollar softness was broad, but the platinum rise left the cross-asset read unconfirmed. Rate spreads and positioning are the next tests.
2026-08-18 07:00 UTC
Dollar softness was broad, but the silver slide left the cross-asset read unconfirmed. Rate spreads and positioning are the next tests.
2026-08-17 07:00 UTC
Dollar softness was broad, but the silver rise left the cross-asset read unconfirmed. Rate spreads and positioning are the next tests.
2026-08-15 07:00 UTC
Reviews
Builders use FXMacroData to connect release calendars, macro indicators, FX data, and positioning context into transparent research workflows.
See Built with FXMacroData“FXMacroData has been extremely valuable for AXIOM FX because it gives us structured access to macroeconomic indicators, release calendars, FX data and positioning information in one place. It helps us build a more transparent, auditable and institutional-style macro research workflow.”
Plans
API access and product tools for retail investors and independent researchers.
Enterprise Institutional data accessGoverned access for institutional and sophisticated-investor workflows.
Add-on Commercial redistributionAdd rights to display or distribute FXMacroData inside your product.
FAQ
Official macro announcement records and decades of point-in-time history for FX research, no-lookahead backtests, dashboards, and live systems.
Use it through the API, Python, MCP, data export, dashboards, widgets, streaming feeds, and approved redistribution workflows. Open features.
Yes. Use /api/v1/predictions/{currency}/{indicator} for market consensus, survey, central-bank, IMF, and FXMacroData forecast rows joined to realised announcements.
Use the coverage page to check each market and indicator's history depth, then join records by their known-at release timestamp for point-in-time backtests. Open data coverage.
Support
Send the markets, indicators, and whether you need release monitoring, historical research, execution, or redistribution.