Skip to content
Official release records Historical indicators

Official economic data for research, dashboards and trading

Explore historical inflation, GDP, employment and policy rates through one consistent API across 22 supported currency codes. Build research notebooks, dashboards and trading systems with official-source data and release calendars. Check each series for history depth, retained revisions and publication-time evidence.

Start 14-Day Free Trial Full API access Explore Features

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

Announcement record fxmacrodata.com
200 OK JSON
GET /api/v1/announcements/eur/consumer_confidence
Response · announcement replay EUR/USD · EUR
Real announcement replay
EUR/USD around the active EUR announcement
1.1205
Loading --:-- UTC
Loading announcement
Consensus -- Actual -- 1D FX --
Announcement day -- Next day --
Spot Announcement day
Official announcements Publication evidence History by series
Docs
22 production API currencies
21 markets tracked
41 API paths
Calendar Open the release calendar
Listed in Claude’s plugin directory

Two ways to use FXMacroData

Research the economy, trade on releases, or build your own product

Use official economic data in your own analysis or display it to your audience. Explore the workflow and the plan that fits.

For research and trading

Study economic history and follow new releases

For analysts comparing inflation, growth, jobs and policy, and traders monitoring the same official releases. Use the data in notebooks, dashboards and automated workflows.

What is FXMacroData? For traders Watch the overview · 2 min 18 sec
  • Historical indicators across 22 supported currency codes. Check each series for units, frequency and available history.
  • Release calendar with confirmed official schedules and available release values.
  • Alerts by email, push and chat apps when a release lands, plus webhooks and live streams for your own code.
  • Publication evidence and retained revisions where available. The release-speed page distinguishes measured latency from missing evidence.
  • 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

Check research coverage Connect AI

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 supported currency codes, with source and publication metadata where available.
  • 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 Builder resources

Plans

Access that grows with the way you use the data

Every plan includes the same data; plans differ in how you are licensed to use it.

Compare pricing
Individual Research and trading

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

USD 50/month

14-day free trial · one person · cancel anytime

Start 14-day free trial
Business Teams of 2 to 10 people

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

USD 250/month

14-day free trial · up to 10 people

See the Business plan
Add-on Commercial redistribution

Show FXMacroData to your own users, with attribution, on top of Individual or Business.

From USD 10/month

per 100 measured users · a solo project with Individual starts at USD 60/month

See licence pricing

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.

Start 14-day free trial
★★★★★ 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 ->

No key needed

Explore a sample before starting your trial

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.

Economic release calendar Follow the economic releases behind your research CPI, jobs, GDP and central-bank decisions across 22 supported currency codes. View confirmed schedules and available actuals, previous values and forecasts. Open the calendar
Start 14-day free trial What is FXMacroData?

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 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 benefits

Turn every macro release into a tradable timestamp

Economic histories, release calendars, exports, MCP and API access support research and trading from the same stored data. Check retained versions and publication evidence for each analysis.

Start 14-day free trial View all product features
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

Official macro announcement records

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

Learn more Calendar

Release calendar and calendar feeds

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

Learn more AI tools

MCP server and AI research tools

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

Learn more Downloads

CSV and JSON data export

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

Learn more Python

Python SDK and REST API

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

Learn more Dashboards

FX dashboards and analysis views

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

Learn more

Backtest coverage

Check coverage before you subscribe

Start 14-day free trial Data coverage API Docs
Coverage by currency and release type 22 production API currencies · 21 markets tracked

Backtest coverage

Check the data behind your research

Check currency, indicator, and history depth before choosing a research universe, then check the publication and revision evidence required by your analysis.

Currencies

22 production API currencies · 21 markets tracked

API paths

41 documented API paths

History depth

By series available observation history
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.6y External trade 1959-09-30 67.1y
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

Available history by release type

8 types
Check coverage Browse API reference
Every API endpoint, including market consensus 41 API paths

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 Gold, Treasury and Energy Fundamentals 2 Market Context 3 COT Positioning 3 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

native fundamentals

Gold, Treasury and Energy Fundamentals

2 paths

Source-level reserves, custody, Treasury financing, cross-border holdings and physical energy data.

GET /api/v1/native

Native source definitions

Individual API key required
GET /api/v1/native/{source}

Reserves, Treasury and energy history

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

3 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)
GET /api/v1/positioning

CFTC instrument and report definitions

Individual API key required
GET /api/v1/positioning/{instrument}

CFTC contract positioning history

Individual API key required

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.

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.

 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.
Start 14-day free trial

Ask ChatGPT. Check the source.

See ChatGPT retrieve inflation data through FXMacroData, compare the figures and create a sourced morning briefing in this 45-second demonstration.

English captions included. Recorded example: US headline CPI, August and September 2026.

Watch on YouTube Connect your AI assistant

Listed in Claude’s plugin directory

Your macro research, inside Claude.

Bring official-source economic data, release calendars and currency research into your conversations with the FXMacroData plugin.

Add to Claude See what you can do

Requires a paid Claude plan. Start with public USD data; protected data requires FXMacroData access.

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

Showing API data inside your own product? See licence pricing

Guides for Wix WordPress Netlify Webflow Squarespace React
Live widget Economic calendar

Latest research

Recent FX macro notes

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

GBP/USD rises to 1.3402; rate spreads set the tone — FX Market Recap, Oct 22

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

2026-10-22 07:02 UTC
EUR/JPY trades near 177.34; rate spreads set the tone — FX Market Recap, Oct 21 News

EUR/JPY trades near 177.34; rate spreads set the tone — FX Market Recap, Oct 21

Yen strength was broad, while the gold slide kept the cross-asset picture open. Confirmation now rests on rate spreads and positioning.

2026-10-21 07:00 UTC
Claude Macro Research: Introducing the FXMacroData Plugin HowTo

Claude Macro Research: Introducing the FXMacroData Plugin

Install the FXMacroData Claude plugin and build a sourced release agenda, inflation review or currency brief with three practical starter prompts.

2026-10-21 02:46 UTC

FAQ

Short answers before you choose a plan

How does the free trial work?

Eligible new Individual and Business customers get 14 days free, with a payment method required. Your selected subscription starts billing when the trial ends. Cancel online through your billing portal before then to avoid a charge. We send a reminder one day before your trial ends.

Do I need Business to get the full dataset?

No. Both plans include the same data and 1,000,000 API requests a month. Individual is USD 50/month for one person: solo engineers and one-person projects, including commercial development, trading and research. Business is USD 250/month for teams of two or more people, covering up to 10 people, member API keys, admin roles and company invoices. Large organisations can arrange a custom Enterprise agreement with our team.

Can I publish the data in my app or newsletter?

Add Commercial Redistribution to either plan for customer-facing display with FXMacroData attribution. It starts at USD 10/month per audience block, with a one-block minimum. Each block covers up to 100 measured users or recipients, or 1,000 declared public-feed followers. For a solo project with 300 active app users, the total is USD 80/month: USD 50 for Individual + USD 30 for the add-on, before tax after the trial. App users are an audience, not Business seats. Raw resale and API pass-through are not included.

Can I cancel anytime?

Yes. You can cancel your trial or subscription whenever you want from your billing portal with a button click. After cancellation, you keep paid access through the end of the billing period you have already paid for. Enterprise terms are handled through the direct agreement.

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.

Forecasts and Consensus

How real-time is the central bank data?

Releases are available through dashboards, the API and streams. Publication evidence varies by release; see the release-speed page for measured latency and unavailable evidence.

Release Speed

How can I check coverage and historical depth?

Coverage and history start dates vary by currency and indicator. Check the series you need before subscribing. Forecast and market-consensus availability also depends on the indicator, with the same coverage on both paid plans.

Data Coverage

Start today

Start with a 14-day free trial

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

Start 14-day free trial Compare plans

Questions? info@fxmacrodata.com

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