Documentation

API Changelog

End-consumer-facing changes to the FXMacroData API: new endpoints, expanded currency coverage, data quality improvements, and feature launches. Internal infrastructure and tooling changes are omitted.

2026-04-13 API update: 1 addition
  • Added New endpoint available: /v1/forex/{base}/{quote}
2026-04-12 API update: 1 removal
  • Removed Endpoint removed: /v1/stream/events
2026-04-10 API update: 22 additions
  • Added New endpoint available: /mcp
  • Added New endpoint available: /v1/announcements/{currency}/{indicator}
  • Added New endpoint available: /v1/calendar/{currency}
  • Added New endpoint available: /v1/commodities/{indicator}
  • Added New endpoint available: /v1/cot/{currency}
  • Added New endpoint available: /v1/data_catalogue/{currency}
  • Added New endpoint available: /v1/graphql
  • Added New endpoint available: /v1/stream/events
  • Added AUD added to the API. Available indicators: .
  • Added BRL added to the API. Available indicators: .
  • Added CAD added to the API. Available indicators: .
  • Added CHF added to the API. Available indicators: .
  • Added CNY added to the API. Available indicators: .
  • Added DKK added to the API. Available indicators: .
  • Added EUR added to the API. Available indicators: .
  • Added GBP added to the API. Available indicators: .
  • Added JPY added to the API. Available indicators: .
  • Added NZD added to the API. Available indicators: .
  • Added PLN added to the API. Available indicators: .
  • Added SEK added to the API. Available indicators: .
  • Added SGD added to the API. Available indicators: .
  • Added USD added to the API. Available indicators: .
2026-03-29 GDP responses enriched with QoQ and YoY growth fields
  • Improved GDP announcement responses for all 17 covered currencies now include pct_change_qoq and pct_change_yoy fields alongside the absolute output level. No client-side calculation needed.
  • Improved All non-bond macroeconomic indicators (inflation, unemployment, retail sales, etc.) are now included in the announcement events table returned by GET /api/v1/announcements/{currency}/{indicator}.
  • Fixed Release calendar no longer returns weekend announcement timestamps. Placeholder dates that fell on Saturday or Sunday are now shifted to the following Monday.
2026-03-28 Sub-second announcement delivery from primary government sources
  • Improved Macroeconomic releases are now ingested and available via the API within 50 milliseconds of official publication. Data is sourced directly from primary government APIs (BLS and BEA for USD; central bank APIs for other currencies), not from third-party aggregators.
  • Improved All USD indicator data now comes directly from the official BLS and BEA APIs. This removes the previous FRED relay path and improves both accuracy and timeliness.
2026-03-27 CAD GDP · per-key rate limits · enterprise access tier
  • Added CAD GDP data is now available. Fetch it at GET /api/v1/announcements/cad/gdp.
  • Added Per-key rate limiting is enforced on all endpoints. Rate limits vary by subscription tier and are documented in the API Reference.
  • Added Enterprise tier introduced for high-volume and commercial use cases. Contact us for custom limits and SLA terms.
2026-03-25 14-currency expansion · data catalogue fix
  • Added Coverage expanded from 8 to 14 currencies. CNY, SGD, SEK, DKK, PLN, and BRL are now available on the announcements, release calendar, and data catalogue endpoints.
  • Fixed Data catalogue (/api/v1/data_catalogue/{currency}) now lists only indicators that have actual data coverage. Previously, stub entries with no data were included.
  • Fixed Policy Rate frequency label in the data catalogue corrected from Daily to the actual decision-meeting cadence.
2026-03-24 MCP Server: connect AI agents directly to macro data
  • Added FXMacroData MCP Server is now live at https://fxmacrodata.com/mcp. Connect Claude, Cursor, VS Code, or any MCP-compatible AI host to live macroeconomic and central-bank data — no custom code required. Authentication uses OAuth 2.0 + PKCE. See MCP Server docs for setup instructions.
  • Added 9 MCP tools available out of the box: announcements, release calendar, data catalogue, COT positioning, commodities, and forex market sessions.
2026-03-23 GraphQL query interface
  • Added GraphQL endpoint added at POST /api/graphql. Query indicator announcements, release calendars, and data catalogue entries using standard GraphQL syntax. Authenticate with your existing Professional API key.
2026-03-22 Policy rate data quality: corrected timestamps and live sources
  • Fixed Policy rate announcement timestamps for AUD and NZD were incorrect. All historical and future records have been updated with the correct announcement hours.
  • Improved Policy rate history for EUR, GBP, JPY, USD, CAD, NOK, DKK, and KRW is now sourced directly from each central bank's decision pages, replacing the previous static snapshot CSVs.
2025-11-13 Breaking change: policy_rate replaces interest_rates slug
  • Changed The indicator slug interest_rates is replaced by policy_rate across all currencies. Update your API calls — the old slug no longer works.
2025-11-06 Public API launch
  • Added FXMacroData public API launched with 8 G10 currencies (USD, EUR, GBP, JPY, AUD, CAD, CHF, NZD) and core macroeconomic indicators: GDP, inflation, core inflation, policy rate, unemployment, trade balance, current account, retail sales, and government bond yields.
  • Added Release calendar endpoint launched: GET /api/v1/calendar/{currency} — lists upcoming economic data releases with scheduled announcement times.
  • Added COT positioning endpoint launched: GET /api/v1/cot/{currency} — weekly CFTC Commitment of Traders data for G8 futures contracts.
  • Added Commodities endpoint launched: GET /api/v1/commodities/{indicator} — daily energy prices (WTI, Brent, Natural Gas) and precious metals.
  • Added Data catalogue endpoint launched: GET /api/v1/data_catalogue/{currency} — discover which indicators are available for each currency, with metadata.