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.
-
Removed
Endpoint removed:
/v1/stream/events
- Added NOK added to the API. Available indicators: .
- Removed CNY coverage removed from the API.
-
Added
New endpoint available:
/v1/predictions/{currency} -
Added
New endpoint available:
/v1/predictions/{currency}/{indicator}
-
Added
New endpoint available:
/v1/stream/events
-
Added
New endpoint available:
/v1/forex/{base}/{quote}
-
Removed
Endpoint removed:
/v1/stream/events
-
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: .
- Added Per-tier rate limits are now documented and enforced on every API key: Free 30/min, Pro / Startup 300/min, Enterprise 3,000/min, with matching per-hour and per-day budgets. Anonymous traffic (no API key) is not rate-limited — we don't throttle by IP, so shared-infrastructure callers (Googlebot, ChatGPT, residential CDNs, corporate proxies) won't hit 429s just because many end users share one address. Sign up for a free key to get an individually-identified budget. See the full table in the API Reference.
- Added A per-key in-flight concurrency cap protects shared Cloud Run instances from single-key request fanouts that previously could degrade latency for other users. Limits: Free 5, Pro 20, Enterprise 100 concurrent requests.
-
Added
429 responses now include an
X-RateLimit-Windowheader identifying which budget tripped (minute,hour,day,endpoint, orconcurrency) so clients can self-throttle the right dimension. -
Improved
Pro and Enterprise keys remain effectively unlimited for normal production workloads — the new caps only bind on runaway scripts and unintended fanouts. ETag /
If-None-Matchresponses continue to bypass quota counting.
-
Improved
GDP announcement responses for all 17 covered currencies now include
pct_change_qoqandpct_change_yoyfields 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.
- 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.
-
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.
- 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.
-
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.
-
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.
- 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.
-
Changed
The indicator slug
interest_ratesis replaced bypolicy_rateacross all currencies. Update your API calls — the old slug no longer works.
- 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.