Skip to content
Official release records Point-in-time history

Official macro releases and point-in-time history for FX backtests

Official CPI, jobs, GDP, and central-bank releases with known-at timestamps for no-lookahead FX research, dashboards, and live systems.

Get API Key Start 14-Day Free Trial Explore Features

From USD 50/month · 14-day free trial · cancel anytime

22 production API currencies
21 markets tracked
37 API paths
26y point-in-time history

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.

No key needed · USD · 15-minute delay

Try live endpoint (no key) 
GET https://api.fxmacrodata.com/v1/announcements/usd/inflation?limit=5

{
  "currency": "USD",
  "indicator": "inflation",
  "data": [
    {
      "date": "2026-09-30",
      "val": 3.7,
      "previous_value": null,
      "announcement_datetime": 1791981000,
      "announcement_datetime_local": null
    },
    {
      "date": "2026-08-31",
      "val": 3.4,
      "previous_value": null,
      "announcement_datetime": 1789129800,
      "announcement_datetime_local": null
    }
  ]
}

Add X-API-Key for all 22 currencies, real-time releases and full history.

Start here

What is FXMacroData? 30-year bond yields by country Market consensus All endpoints API Docs Data Coverage Free Widgets

Not ready for a key? Create a free account for USD release alerts.

Announcement record . fxmacrodata.com
200 OK JSON
GET /api/v1/announcements/eur/core_inflation
Response . announcement replay EUR/USD . EUR
Real announcement replay
EUR/USD around the active EUR announcement
1.1253
Loading --:-- UTC
Loading announcement
Consensus -- Actual -- 1D FX --
Announcement day -- Next day --
Spot Announcement day
Official announcements Known-at timestamps Backtest-ready history
Docs

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.

Two ways to use FXMacroData

Trade on the data yourself, or build it into your own product

The same official releases power both. Pick the side that describes you to see what you get, a two-minute overview and the plan that fits.

For your own trading

React to economic releases in seconds

For traders who act on CPI, payrolls and central-bank decisions and need the number the moment the official source publishes it.

What is FXMacroData? For traders Watch the overview · 2 min 18 sec
  • Release calendar with exact official times for 22 currencies, and the history behind every print.
  • Alerts by email, push and chat apps when a release lands, plus webhooks and live streams for your own code.
  • Release timing measured for every release, published on the release-speed page.
  • Dashboards and AI tools: ask Claude or ChatGPT about the latest data through the MCP server.

Individual plan, USD 50/month · one person · 14-day free trial

Start 14-day free trial Open the release calendar

Explore dashboards Connect AI Release speed

For your website or app

Show official macro data to your own users

For developers and small teams putting economic data on a website, app, Telegram channel, Discord server or newsletter.

What is FXMacroData? For developers building a product Watch the overview · 2 min 19 sec
  • One API for releases, calendars, FX and bond yields across 22 currencies, each row with its publication time and source.
  • A display licence bought online: Commercial Redistribution lets your users see the data, with visible attribution.
  • Audience measured automatically, so the licence grows with your users without a manual count.
  • Widgets and official clients to get a calendar or chart on your page quickly.

Licence from USD 10/month per 100 measured users · added to an Individual or Business plan

See licence pricing Make your first request

Embeddable widgets API reference All videos

Sovereign rates · official sources

Government bond yields by country, from the long end down.

The 30-year point is where fiscal supply, inflation risk and term premium show up first. Compare every published market in one table, then open any maturity, country or curve.

30-year yields by country 10-year yields All maturities
30-year government bond yields by countryLatest readings, 52-week ranges and the spread to 10-year yields for every published market. 10-year government bond yields by countryThe global benchmark maturity, compared across markets with official-source data. Bond yield curvesEvery published maturity for one currency, with rate-differential context.

Product workbench

Move from release calendar to API, dashboard, and AI workflow.

FXMacroData is not just a list of endpoints. The same announcement-timestamped records connect human review, code, dashboards, and agent workflows.

Open API docs View dashboard
Release calendar Plan the event window

Browse confirmed macro events by currency, local time, source, and release type before the data lands in a workflow.

 REST API Pull the release record

Use 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
}
 Dashboard Inspect the FX context

Review EUR/USD around macro events, then move into the same pair, release, and endpoint in code.

 MCP and AI Give agents sourced macro context

Let AI tools call FXMacroData instead of relying on model memory, then return source-linked research payloads.

Free widgets

Put a live economic calendar on your own website.

Embed official-source macro data on a blog, broker education page or trading community in minutes. One snippet, no API key, and it keeps itself up to date.

  • Ready-made widgetsEconomic calendar, release countdown, central bank rates, inflation heatmap, live release ticker and FX pair charts.
  • Yours to configureChoose currencies, theme, language and time zone. Each widget sizes itself to its content.
  • Free with attributionFree on public pages while the FXMacroData link stays visible.
Browse free widgets Install guides
Guides for Wix WordPress Netlify Webflow Squarespace React
Live widget economic-calendar

Product benefits

Turn every macro release into a tradable timestamp

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.

View all product features Check data coverage
Release workflow official source to model input
release Official row captured

Official publisher values are normalized into the announcement record.

known_at Timestamp preserved

The market-visible time becomes the research boundary.

replay Backtest-safe join

Models only see values that were public at that point.

merge_asof announcement_datetime <= model_time
Release data Live

Official macro announcement records

Use central-bank and statistics-office release records with announcement timestamps for alerts, dashboards, and FX research systems.

Official macro release records normalized for alerts, dashboards, and FX systems
Explore realtime announcements ->
Backtesting 02

Point-in-time historical data

Backtest against decades of records that preserve when each macro value was known to the market.

Learn more ->
Calendar 03

Release calendar and calendar feeds

Plan around upcoming macro releases by currency through dashboards, API access, and refreshable calendar feeds.

Learn more ->
Tools 04

Strategy research tools

Use browser tools for CFD macro maps, point-in-time backtests, FX pairs trading, and carry-trade research.

Learn more ->
AI tools 05

MCP server and AI research tools

Ask AI tools for release-aware macro context without manually copying tables between apps.

Learn more ->
Prompts 06

FX agent prompt library

Copy tested prompts for macro briefings, event risk, pair research, backtests, visuals, and MCP-native agent workflows.

Learn more ->
Downloads 07

CSV and JSON data export

Download release-aware macro history for notebooks, spreadsheets, archives, and downstream model inputs.

Learn more ->
Python 08

Python SDK and REST API

Bring announcement-timestamped releases and point-in-time history into notebooks, jobs, dashboards, and production systems.

Learn more ->
Dashboards 09

FX dashboards and analysis views

Market summary, pair dashboards, calendars, COT, commodities, bond yields, sessions, and press releases.

Learn more ->

Backtest coverage

See how far your point-in-time backtest can go

Check currency, indicator, and history depth before choosing a research universe, then join releases by the time each value became public.

Currencies

22 production API currencies · 21 markets tracked

API paths

37 ready-to-use datasets

History depth

26y point-in-time records
Announcement starts type view
Inflation 1914-01-31 112.7y Jobs and wages 1948-01-31 78.7y Central bank policy 1975-01-02 51.8y Growth and activity 1947-03-31 79.5y External trade 1959-09-30 67.0y
Markets provided

Covered currency markets

22 full API · 21 tracked

Full API = fully enabled in the production REST + MCP API today. Tracked = dashboards, docs, and history published while production API access rolls out.

North America

2 full API · 2 tracked
USD Full API US Dollar CAD Full API Canadian Dollar

Europe

7 full API · 7 tracked
EUR Full API Euro GBP Full API British Pound CHF Full API Swiss Franc SEK Full API Swedish Krona DKK Full API Danish Krone NOK Full API Norwegian Krone HUF Full API Hungarian Forint

Asia

6 full API · 6 tracked
JPY Full API Japanese Yen TWD Full API New Taiwan Dollar MYR Full API Malaysian Ringgit THB Full API Thai Baht KRW Full API South Korean Won CNY Full API Chinese Yuan

Middle East

1 full API · 1 tracked
ILS Full API Israeli New Shekel

Oceania

2 full API · 2 tracked
AUD Full API Australian Dollar NZD Full API New Zealand Dollar

South America

2 full API · 2 tracked
BRL Full API Brazilian Real PEN Full API Peruvian Sol

Africa

1 full API · 1 tracked
NGN Full API Nigerian Naira
Announcement coverage

Point-in-time history by release type

8 types
Check coverage Browse API reference

API endpoint directory

All FXMacroData endpoints on one page

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

Market consensus data is available in the Predictions endpoint

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
GET Plan required · included in every paid plan
/api/v1/predictions/{currency}/{indicator} Open example

Common docs paths

Start from the record type.

Calendar events Find confirmed event names, release times, currencies, sources, and impact tiers. /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, send it in the X-API-Key header, and copy starter Python requests. X-API-Key: YOUR_API_KEY Quickstart
Health & Infrastructure 2 Data Catalogue 1 Announcements 3 Predictions 4 Release Calendar 4 Release Events & Streaming 2 Factors 1 FX Rates & Reference Rates 6 Rates, Curves & Differentials 3 Market Context 3 COT Positioning 1 Commodities 2 Official Press Releases 1 Event Contract Settlement 4

health

Health & Infrastructure

2 paths

Health checks and low-friction API availability probes.

GET /api/v1/health

Ping the API

Always free
GET /api/v1/ping

Ping the API

Always free

data catalogue

Data Catalogue

1 paths

Discovery and metadata for available indicators by currency.

GET /api/v1/data_catalogue/{currency}

Get Currently Available Macroeconomic Indicators

Always free

announcements

Announcements

3 paths

Macroeconomic announcement time series with official release timestamps.

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

Get latest values for all indicators in a currency

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

Get macroeconomic indicator data

Individual (USD: no-key 100/day)
POST /api/v1/research/panel

Build a panel of values known at each decision time

Individual API key required

predictions

Predictions

4 paths

Forecasts, consensus, central-bank projections, and FXMacroData predictions.

GET /api/v1/predictions/coverage

Which forecast publishers cover which currency (no API key)

Always free
GET /api/v1/predictions/coverage/{currency}

Per-indicator forecast coverage for one currency (no API key)

Always free
GET /api/v1/predictions/{currency}

Page official forecast vintages from one publisher

Always free
GET /api/v1/predictions/{currency}/{indicator}

List predictions for one indicator of a currency

Individual API key required

calendar

Release Calendar

4 paths

Upcoming macro and policy release schedules.

GET /api/v1/calendar/{currency}

Get upcoming economic data release dates

Individual (USD: no-key 100/day)
GET /api/v1/calendar/{currency}/coverage

Inspect calendar archive evidence coverage and capture gaps

Individual API key required
GET /api/v1/calendar/{currency}/events/{archive_event_id}/versions

Get immutable schedule versions for an event

Individual API key required
GET /api/v1/calendar/{currency}/snapshot

Get the economic schedule known at a historical time

Individual API key required

release events

Release Events & Streaming

2 paths

Polling, SSE, and WebSocket delivery for newly ingested economic releases.

GET /api/v1/announcements/changes

Poll recent live announcement release changes

Mixed access
GET /api/v1/stream/events

Subscribe to real-time announcement events (SSE)

Mixed access

factors

Factors

1 paths

Precomputed macro factor scores for model inputs and cross-currency comparison.

GET /api/v1/factors/{currency}/{factor}

Get a precomputed FX factor for one currency

Individual (USD: no-key 100/day)

fx reference rates

FX Rates & Reference Rates

6 paths

Daily, intraday and session views of official FX reference rates.

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

Get FX spot rates

Individual API key required
GET /api/v1/fx/intraday-reference-rates/{base}/{quote}

Get subscriber intraday FX reference rates

Individual API key required
GET /api/v1/fx/reference-rates/{base}/{quote}

Get timestamped official FX reference rates

Individual API key required
GET /api/v1/fx/session-rates/{base}/{quote}

Get official FX session-close reference rates

Individual API key required
GET /api/v1/fx/source-universe

List public FX reference-rate pair universe

Always free
GET /api/v1/fx/sources

List public FX reference-rate sources

Always free

rates curves

Rates, Curves & Differentials

3 paths

Yield-curve views and pair rate differentials for rates-aware FX analysis.

GET /api/v1/curves/{currency}

Get curve analytics by currency

Individual API key required
GET /api/v1/financial_prices/{currency}

Official financial prices and yield curves

Individual API key required
GET /api/v1/rate_differentials/{base}/{quote}

Get pair rate differentials

Individual API key required

market context

Market Context

3 paths

FX market-session status and broad risk-on/risk-off context for timing and regime filters.

GET /api/v1/market_sessions

FX market session timetable

Always free
GET /api/v1/risk_sentiment

Global risk-on / risk-off indicator

Always free
GET /api/v1/risk_sentiment/changes

Recorded risk-sentiment changes

Always free

cot positioning

COT Positioning

1 paths

CFTC Commitment of Traders futures positioning by currency.

GET /api/v1/cot/{currency}

Get CFTC Commitment of Traders (COT) data

Individual (USD: no-key 100/day)

commodities

Commodities

2 paths

Precious metals, OPEC, and commodity-related endpoints.

GET /api/v1/commodities/latest

Get latest values for all commodity indicators

Individual API key required
GET /api/v1/commodities/{indicator}

Get commodity indicator data

Individual API key required

official updates

Official Press Releases

1 paths

Central-bank press releases and policy communications from official sources.

GET /api/v1/press-releases/{currency}

Recent central bank press releases

Individual (USD: no-key 100/day)

settlement

Event Contract Settlement

4 paths

Signed settlement records for prediction-market contracts on official macro releases.

GET /api/v1/settlement/contracts

Contract templates for settling event contracts on official releases

Always free
GET /api/v1/settlement/contracts/{contract_id}

Settle a contract template for one release

Individual (USD: no-key 100/day)
GET /api/v1/settlement/keys

Public keys that verify signed settlement records

Always free
GET /api/v1/settlement/{currency}/{indicator}

Settlement record for one release of an announcement series

Individual (USD: no-key 100/day)
Canonical machine-readable contract: https://api.fxmacrodata.com/openapi.json

AI data layer

Give agents official FX macro data, not stale model memory

Connect AI assistants, notebooks, dashboards, and alerts to the same release-aware macro records used across the FXMacroData API and dashboard.

ChatGPT Custom GPT entry Conversational FX macro research for non-code users. Agents MCP tools Live macro calls inside Claude, Cursor, Codex, VS Code, and other hosts. Install AI agent install Choose hosted MCP, Custom GPT, Codex plugin package, prompts, or LLM catalogs. Prompts Prompt library Copyable workflows for briefings, pair checks, event risk, visuals, and backtests. Retrieval LLM-readable docs llms.txt, agent manifests, AI surface index, OpenAPI, and prompt catalogs. Builders OpenAPI + REST Machine-readable contracts for generated clients and production code.
agent payload release-aware 
{
  "tool": "indicator_query",
  "currency": "USD",
  "indicator": "inflation",
  "mcp_metadata": {
    "source_type": "official",
    "has_announcement_datetime": true,
    "point_in_time_safe": false,
    "assumed_release_time_count": 997,
    "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.

Use it where you work

Use the same release-aware records everywhere

Move from visual inspection to code, agents, and downstream delivery without switching to a different macro dataset.

REST and Python

Bring live releases and point-in-time history into notebooks, jobs, and production systems.

Dashboards

Inspect EUR/USD releases and history visually before using the same data in code.

Trading tools

Map CFD symbols to macro drivers, then move into backtesting, pairs, and carry-trade workspaces.

Integrations

Use Copilot, Notion, Apple, Pine Script, MetaTrader, and NinjaTrader guides.

Open source integrations

Use FXMacroData in established quantitative research tools for backtesting and macro-event-aware workflows.

Builders

Build FX dashboards, client portals, market tools, and AI workflows with APIs, widgets, and source-backed macro data.

Latest research

Recent FX macro notes

View all articles
Find market research and technical guides. All articles Technical articles & guides Engineering How-to guides
AUD/USD slides to 0.6911; rate spreads set the tone — FX Market Recap, Oct 16 News

AUD/USD slides to 0.6911; rate spreads set the tone — FX Market Recap, Oct 16

Dollar softness was broad; the gold slide did not confirm it across assets. Watch rate spreads and positioning for follow-through.

2026-10-16 07:00 UTC
USD CPI rises to 3.70%; AUD/USD rises to 0.7010 — FX Market Recap, Oct 15 News

USD CPI rises to 3.70%; AUD/USD rises to 0.7010 — FX Market Recap, Oct 15

FX breadth pointed to broad USD softness, but rising gold left the cross-asset tape mixed. Relative rates and positioning are the next confirmation tests.

2026-10-15 07:00 UTC
USD/JPY falls to 158.12; rate spreads set the tone — FX Market Recap, Oct 14 News

USD/JPY falls to 158.12; rate spreads set the tone — FX Market Recap, Oct 14

Yen strength was broad. The gold slide left cross-asset confirmation pending. Rate spreads and positioning decide the follow-through.

2026-10-14 07:00 UTC

Reviews

Macro data that supports real research products

Builders use FXMacroData to connect release calendars, macro indicators, FX data, and positioning context into transparent research workflows.

See Built with FXMacroData
★★★★★ Verified customer
“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.”
Fagner Oliveira Founder and Developer, AXIOM FX
Read the AXIOM FX build story ->

Plans

Access that grows with the way you use the data

Compare pricing
Individual Research and trading

Full data and API access for solo engineers, one-person projects, traders and researchers.

 Business Incorporated businesses, 2+ people

The same data licensed to your organisation, for up to 10 people with member API keys and company invoices.

 Add-on Commercial redistribution

Add rights to display or distribute FXMacroData inside your product.

FAQ

Short answers before you choose a plan

What is FXMacroData for?

Official macro announcement records and decades of point-in-time history for FX research, no-lookahead backtests, dashboards, and live systems.

How can my team use the data?

Use it through the API, Python, MCP, data export, dashboards, widgets, streaming feeds, and approved redistribution workflows. Open features.

Do you provide market consensus or forecast data?

Yes. Use /api/v1/predictions/{currency}/{indicator} for market consensus, survey, central-bank, IMF, and FXMacroData forecast rows joined to realised announcements.

How do I check if the data fits my backtest?

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

Need to confirm a release or backtest workflow?

Send the markets, indicators, and whether you need release monitoring, historical research, execution, or redistribution.

info@fxmacrodata.com