FXMacroData API endpoints and reference
FXMacroData currently exposes 35 production API paths across 15 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.
Health, catalogue discovery, release calendars, market-session status, risk sentiment, GraphQL, USD news, and source-discovery routes require no API key.
Announcements, predictions, 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.
Release-event streams are public for USD events and require a Professional API key for non-USD event streams.
FX rates, reference-rate history, curves, rate differentials, commodities, and webhook management require a Professional API key.
MCP client access uses the FXMacroData OAuth flow when protected data is requested.
Health & Infrastructure
Health checks and low-friction API availability probes.
https://api.fxmacrodata.com/v1/health
Ping the API
Use as a service health check for API availability monitoring.
https://api.fxmacrodata.com/v1/ping
Ping the API
Use as a lightweight connectivity probe for scripts, status pages, and uptime checks.
Data Catalogue
Discovery and metadata for available indicators by currency.
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.
Announcements
Macroeconomic announcement time series with official release timestamps.
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.
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.
Predictions
Forecasts, consensus, central-bank projections, and FXMacroData predictions.
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.
Release Calendar
Upcoming macro and policy release schedules.
https://api.fxmacrodata.com/v1/calendar/{currency}
Get upcoming economic data release dates
Use for upcoming and recent scheduled economic-release dates by currency.
Release Events & Streaming
Polling, SSE, and WebSocket delivery for newly ingested economic releases.
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.
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.
wss://api.fxmacrodata.com/v1/ws/events
Subscribe to real-time announcement events (WebSocket)
Use a WebSocket connection for persistent JSON release-event delivery.
FX Rates & Reference Rates
Daily FX spot history plus official reference-rate, intraday, session-close, and source-discovery endpoints.
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.
https://api.fxmacrodata.com/v1/fx/fixing-timeline/{base}/{quote}
Deprecated: use intraday FX reference ratesDeprecated
Legacy compatibility endpoint for fixing timelines; new integrations should use intraday reference rates.
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.
https://api.fxmacrodata.com/v1/fx/reference-rates/{base}/{quote}
Get timestamped official FX reference rates
Use for timestamped official FX reference-rate observations.
https://api.fxmacrodata.com/v1/fx/session-rates/{base}/{quote}
Get official FX session-close reference rates
Use for official session-close reference rates where a workflow needs market-session alignment.
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.
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.
Rates, Curves & Differentials
Yield-curve snapshots, curve proxies, rate differentials, forward curves, and forward-rate differentials.
https://api.fxmacrodata.com/v1/curve_proxies/{currency}
Get curve slope proxies
Use for curve-slope proxies such as front-end, belly, and long-end rate relationships.
https://api.fxmacrodata.com/v1/curves/{currency}
Get official curve node snapshot
Use for official yield-curve node snapshots by currency.
https://api.fxmacrodata.com/v1/forward_curves/{currency}
Get derived forward curve segments
Use for derived forward-curve segments by currency.
https://api.fxmacrodata.com/v1/forward_differentials/{base}/{quote}
Get pair forward-rate differentials
Use for pair-level forward-rate differentials.
https://api.fxmacrodata.com/v1/rate_differentials/{base}/{quote}
Get pair rate differentials
Use to compare policy or market-rate spreads between two currencies.
Market Context
FX market-session status and broad risk-on/risk-off context for timing and regime filters.
https://api.fxmacrodata.com/v1/market_sessions
FX market session timetable
Use to determine which major FX sessions are open or closed.
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.
COT Positioning
CFTC Commitment of Traders futures positioning by currency.
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.
Commodities
Precious metals, OPEC, and commodity-related endpoints.
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.
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.
Official News & Press Releases
Central-bank news and press-release feeds for policy communication and event context.
https://api.fxmacrodata.com/v1/news/{currency}
Recent central bank news and press releases
Use for recent official central-bank news and policy communication by currency.
https://api.fxmacrodata.com/v1/press-releases/{currency}
Recent central bank press releases
Use for central-bank press-release archives by currency.
Webhooks
Subscription management and delivery logs for release-event webhooks.
https://api.fxmacrodata.com/v1/webhooks/deliveries
List webhook delivery logs
Use to inspect recent webhook delivery attempts and troubleshoot callback failures.
https://api.fxmacrodata.com/v1/webhooks/subscriptions
List webhook subscriptions
Use to list or create webhook subscriptions for release-event callbacks.
https://api.fxmacrodata.com/v1/webhooks/subscriptions/{subscription_id}
Get a webhook subscription
Use to inspect, update, or delete one webhook subscription.
https://api.fxmacrodata.com/v1/webhooks/subscriptions/{subscription_id}/rotate-secret
Rotate a webhook signing secret
Use to rotate the HMAC signing secret for one webhook subscription.
GraphQL
GraphQL query interface for the public data surface.
https://api.fxmacrodata.com/v1/graphql
Handle Http Get
Use GraphQL when a client wants to query supported FXMacroData datasets through one graph endpoint.
MCP
Model Context Protocol endpoint for AI agents and MCP-compatible clients.
https://api.fxmacrodata.com/mcp
FXMacroData MCP endpoint
Use from MCP-compatible AI clients to call FXMacroData tools and resources through the production MCP transport.
Interactive OpenAPI reference
Search the same production schema, inspect parameters, and view response models below.
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.