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.
48
public REST paths
15
endpoint families
OpenAPI
schema-derived
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
USD free (last 365d) · Pro key for full history & other currencies
/api/v1/predictions/{currency}
Open example
health
Health & Infrastructure
3 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
GET
/api/v1/sla/summary
Dev-only API SLA summary
Always free
statistics releases
Statistics Releases
3 paths
Announcements, low-latency snapshots, and macro release series.
GET
/api/v1/announcements/{currency}/{indicator}
Get macroeconomic indicator data
Pro (USD: free for last 365 days)
GET
/api/v1/credit_conditions/{currency}
Bank lending standards and credit conditions
Always free
GET
/api/v1/wage_settlements/{currency}
Official wage settlement and labor-cost trackers
Always free
Forecasts, consensus, central-bank projections, and FXMacroData predictions.
GET
/api/v1/predictions/{currency}
List predictions for a currency
Pro (USD: free for last 365 days)
GET
/api/v1/predictions/{currency}/{indicator}
List predictions for one indicator of a currency
Pro (USD: free for last 365 days)
calendar
Release Calendar
1 paths
Upcoming macro and policy release schedules.
GET
/api/v1/calendar/{currency}
Get upcoming economic data release dates
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
Spot FX, market sessions, risk sentiment, and positioning surfaces.
GET
/api/v1/cot/{currency}
Get CFTC Commitment of Traders (COT) data
Pro (USD: free for last 365 days)
GET
/api/v1/curve_proxies/{currency}
Get curve slope proxies
Pro key required
GET
/api/v1/curves/{currency}
Get official curve node snapshot
Pro key required
GET
/api/v1/forex/{base}/{quote}
Get FX spot rates
Always free
GET
/api/v1/forward_curves/{currency}
Get derived forward curve segments
Pro key required
GET
/api/v1/forward_differentials/{base}/{quote}
Get pair forward-rate differentials
Pro key required
GET
/api/v1/market_sessions
FX market session timetable
Always free
GET
/api/v1/rate_differentials/{base}/{quote}
Get pair rate differentials
Pro key required
GET
/api/v1/risk_sentiment
Global risk-on / risk-off indicator
Always free
Official news and press-release endpoint families.
GET
/api/v1/news/{currency}
Official government and supranational organisation news
Always free
press releases
Press Releases
1 paths
Official central-bank press-release archive endpoints.
GET
/api/v1/press-releases/{currency}
Recent central bank press releases
Pro (USD: free for last 365 days)
GraphQL query interface for the public data surface.
GET
/api/v1/graphql
Handle Http Get
Always free
monetary policy
Monetary Policy
4 paths
Central bankers, central-bank rules, liquidity, and intervention context.
GET
/api/v1/cb_liquidity/{currency}
Central-bank liquidity operations and facility usage
Always free
GET
/api/v1/cb_rules/{currency}
Central bank FX intervention rules and exchange rate regime
Always free
GET
/api/v1/central_bankers/{currency}
Central bank officials — current and past
Always free
GET
/api/v1/fx_intervention/{currency}
Official FX intervention operations
Always free
domestic supply demand
Domestic Supply & Demand
3 paths
Housing, petrol, and electricity pricing context.
GET
/api/v1/electricity/{currency}
Household electricity prices by currency
Always free
GET
/api/v1/housing/{currency}
Housing market indicators by currency
Always free
GET
/api/v1/petrol_prices/{currency}
At-the-pump retail petrol/gasoline prices by currency
Always free
fiscal policy
Fiscal Policy
7 paths
Sovereign fiscal, debt, expense, and auction-related datasets.
GET
/api/v1/auction_metrics/{currency}
Sovereign auction microstructure metrics
Always free
GET
/api/v1/bond_issuances/{currency}
Government bond auction and issuance results
Always free
GET
/api/v1/esg/{currency}
Sovereign ESG indicators by currency
Always free
GET
/api/v1/expenses/{currency}
Government expenditure breakdown by function
Always free
GET
/api/v1/external_debt/{currency}
External debt maturity profile
Always free
GET
/api/v1/fiscal/{currency}
National government debt, tax revenue, and budget balance
Always free
GET
/api/v1/treasury_cash/{currency}
Treasury cash position and short-term funding pressure
Always free
politics
Politics & Event Risk
3 paths
Elections, geopolitical events, and major economic summits.
GET
/api/v1/economic_events
Major international economic events relevant to FX
Always free
GET
/api/v1/elections/{currency}
Political elections and FX impact by currency
Always free
GET
/api/v1/geopolitical_events
FX-relevant world events from GDELT
Always free
international trade
International Trade
6 paths
Trade structure, shipping, balance-of-payments, and cross-border flow datasets.
GET
/api/v1/bop/{currency}/{component}
Detailed balance-of-payments component series
Always free
GET
/api/v1/capital_flows/{currency}
Cross-border portfolio flow tracker
Always free
GET
/api/v1/iip/{currency}
International investment position
Always free
GET
/api/v1/services_trade/{currency}
Services trade balance
Always free
GET
/api/v1/shipping/{indicator}
Global shipping and maritime indicators
Always free
GET
/api/v1/tariffs/{currency}
Trade tariff regimes and FX impact by currency
Always free
Precious metals, OPEC, and commodity-related endpoints.
GET
/api/v1/commodities/latest
Get latest stored values for all commodity indicators
Pro key required
GET
/api/v1/commodities/{indicator}
Get commodity indicator data
Pro key required
GET
/api/v1/opec/{indicator}
OPEC oil market indicators
Always free
