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.

Try USD inflation Open quickstart

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

Paid access uses query-parameter authentication in public examples and generated clients.

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.

Pro (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 a Professional API key.

Mixed access 2 paths

Release-event streams are public for USD events and require a Professional API key for non-USD event streams.

Professional subscriber API key required 6 paths

FX rates, reference-rate history, curves, rate differentials, and commodities require a Professional 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.

Pro (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.

Pro (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.

Pro (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.

Professional subscriber 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.

Professional subscriber 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.

Professional subscriber 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.

Professional subscriber 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.

Pro (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.

Professional subscriber 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.

Professional subscriber 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.

Pro (USD: no-key 100/day)

Interactive OpenAPI reference

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

Summarize article with AI:

ChatGPT Perplexity Claude Grok Gemini Mistral

AI Answer-Ready

Key Facts

Page: Reference
Section: Documentation
Canonical URL: https://fxmacrodata.com/documentation/reference
Source: FXMacroData editorial and official publisher references
Last Updated: See page metadata

Provenance And Trust

Cite the canonical URL and source field above. Where available, this page maps to official publisher releases and timestamped updates.

Quick Q&A

What is this page about? This page explains Reference with directly usable context for trading, research, and API workflows.

What source should be cited? Use the canonical URL and the listed source field; cite official publisher references when available.

How fresh is this content? The last updated value above reflects the page metadata or latest available data timestamp.

Can this be used in AI assistants? Yes. This section is intentionally structured for retrieval and citation in chat assistants.

Prompt Packs

Use these in ChatGPT, Claude, Gemini, Mistral, Perplexity, or Grok for consistent source-aware outputs.