Production API

FXMacroData API endpoints and reference

FXMacroData currently exposes 21 production API paths across 13 endpoint groups. Use the inventory below to choose the right family, then open the interactive OpenAPI reference for parameters, schemas, and response examples. The inventory and the Scalar reference are generated from the same production OpenAPI schema.

21 Production endpoint paths
13 Endpoint groups
OpenAPI 3.1 Production schema
Build in 4 calls

Start with one release, then add calendar, FX, and AI context.

These production examples cover the most common first workflow: inspect a USD macro release, plan the next event window, join FX context, and hand the same data to an agent or automation layer.

Choose a workflow Try USD inflation GraphQL API
No-key USD Latest announcement row

Anonymous USD evaluation works for recent data and discovery before checkout.

GET https://api.fxmacrodata.com/v1/announcements/usd/inflation?limit=1
Calendar Upcoming release plan

Use release-calendar rows to plan reviews, alerts, and model update windows.

GET https://api.fxmacrodata.com/v1/calendar/usd
FX context Pair history around the event

Join macro records to FX history for event studies and dashboard checks.

GET https://api.fxmacrodata.com/v1/forex/eur/usd?start_date=2026-01-01
Protected Use your API key

Append your key as the api_key query parameter shown below.

GET https://api.fxmacrodata.com/v1/announcements/eur/policy_rate?api_key=YOUR_API_KEY
Always free 8 paths

Health, catalogue discovery, release calendars, market-session status, risk sentiment, and source-discovery routes require no API key.

Individual (USD: no-key 100/day) 5 paths

Announcements, predictions, factors, press releases, and COT use mixed access: USD is public in the freemium window up to 100 no-key requests per day, while non-USD access, deeper history, or higher-volume use requires an Individual API key.

Mixed access 2 paths

Release-event streams are public for USD events and require an Individual API key for non-USD event streams.

Individual API key required 6 paths

FX rates, reference-rate history, curves, rate differentials, and commodities require an Individual API key.

Health & Infrastructure

Health checks and low-friction API availability probes.

1 path
GET
https://api.fxmacrodata.com/v1/ping Ping the API Use as a lightweight connectivity probe for scripts, status pages, and uptime checks.
Always free

Data Catalogue

Discovery and metadata for available indicators by currency.

1 path
GET
https://api.fxmacrodata.com/v1/data_catalogue/{currency} Get Currently Available Macroeconomic Indicators Use first in integrations to discover available indicator slugs, labels, units, and coverage for a currency.
Always free

Announcements

Macroeconomic announcement time series with official release timestamps.

2 paths
GET
https://api.fxmacrodata.com/v1/announcements/{currency}/latest Get latest stored values for all indicators in a currency Use to retrieve the latest stored value for every available indicator in one currency.
Always free
GET
https://api.fxmacrodata.com/v1/announcements/{currency}/{indicator} Get macroeconomic indicator data Use for historical macroeconomic time series, release timestamps, pagination, and source metadata for one indicator.
Individual (USD: no-key 100/day)

Predictions

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

1 path
GET
https://api.fxmacrodata.com/v1/predictions/{currency}/{indicator} List predictions for one indicator of a currency Use for forecasts, consensus, official projections, and FXMacroData predictions joined to the announcement they target.
Individual (USD: no-key 100/day)

Release Calendar

Upcoming macro and policy release schedules.

1 path
GET
https://api.fxmacrodata.com/v1/calendar/{currency} Get upcoming economic data release dates Use for upcoming and recent scheduled economic-release dates by currency.
Always free

Release Events & Streaming

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

2 paths
GET
https://api.fxmacrodata.com/v1/announcements/changes Poll recent live announcement release changes Use to poll recently ingested release changes when a streaming connection is not appropriate.
Mixed access
GET
https://api.fxmacrodata.com/v1/stream/events Subscribe to real-time announcement events (SSE) Use an SSE connection for low-latency release-event delivery to browser or server clients.
Mixed access

Factors

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

1 path
GET
https://api.fxmacrodata.com/v1/factors/{currency}/{factor} Get a precomputed FX factor for one currency Use for precomputed macro factor scores such as monetary stance, with optional stored components and source links.
Individual (USD: no-key 100/day)

FX Rates & Reference Rates

Daily FX spot history plus one subscriber intraday FX reference-rate endpoint.

4 paths
GET
https://api.fxmacrodata.com/v1/forex/{base}/{quote} Get FX spot rates Use for daily FX spot history between two currencies, including derived crosses where supported.
Individual API key required
GET
https://api.fxmacrodata.com/v1/fx/intraday-reference-rates/{base}/{quote} Get subscriber intraday FX reference rates Use for intraday official reference-rate observations ordered by source observation time.
Individual API key required
GET
https://api.fxmacrodata.com/v1/fx/source-universe List public FX reference-rate pair universe Use to inspect the public pair/source universe before requesting a reference-rate series.
Always free
GET
https://api.fxmacrodata.com/v1/fx/sources List public FX reference-rate sources Use to list the official FX reference-rate sources available through FXMacroData.
Always free

Rates, Curves & Differentials

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

2 paths
GET
https://api.fxmacrodata.com/v1/curves/{currency} Get curve analytics by currency Use for curve nodes, slope analytics, or derived forward segments by currency.
Individual API key required
GET
https://api.fxmacrodata.com/v1/rate_differentials/{base}/{quote} Get pair rate differentials Use to compare spot-rate or derived forward-rate spreads between two currencies.
Individual API key required

Market Context

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

2 paths
GET
https://api.fxmacrodata.com/v1/market_sessions FX market session timetable Use to determine which major FX sessions are open or closed.
Always free
GET
https://api.fxmacrodata.com/v1/risk_sentiment Global risk-on / risk-off indicator Use as a broad risk-on/risk-off indicator alongside macro and FX data.
Always free

COT Positioning

CFTC Commitment of Traders futures positioning by currency.

1 path
GET
https://api.fxmacrodata.com/v1/cot/{currency} Get CFTC Commitment of Traders (COT) data Use for weekly CFTC Commitment of Traders futures positioning, including commercial and non-commercial long/short/net exposure.
Individual (USD: no-key 100/day)

Commodities

Precious metals, OPEC, and commodity-related endpoints.

2 paths
GET
https://api.fxmacrodata.com/v1/commodities/latest Get latest stored values for all commodity indicators Use to fetch the latest stored value for every available commodity indicator in one call.
Individual API key required
GET
https://api.fxmacrodata.com/v1/commodities/{indicator} Get commodity indicator data Use for commodity time series such as precious metals where macro workflows need cross-asset context.
Individual API key required

Official Press Releases

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

1 path
GET
https://api.fxmacrodata.com/v1/press-releases/{currency} Recent central bank press releases Use for central-bank press releases and policy communications by currency.
Individual (USD: no-key 100/day)

Interactive OpenAPI reference

Search the same production schema, inspect parameters, and view response models below.