# FXMacroData documentation

> Official-source FX, macroeconomic and central-bank data for 22 currencies, with the publication timestamp on every observation. Each page below is available as HTML and as Markdown at the same path with a .md suffix.

API base URL: https://api.fxmacrodata.com
OpenAPI schema: https://api.fxmacrodata.com/openapi.json
Site overview for agents: https://fxmacrodata.com/llms.txt
Full site reference: https://fxmacrodata.com/llms-full.txt
API changelog feed (Atom): https://fxmacrodata.com/documentation/changelog.xml
System status: https://fxmacrodata.com/status

## Getting started

- [Quickstart](https://fxmacrodata.com/documentation/quickstart.md): First API request, authentication, and the Python paging loop. (HTML: https://fxmacrodata.com/documentation/quickstart)
- [API reference](https://fxmacrodata.com/documentation/reference.md): Every production endpoint path, grouped by family, with the interactive OpenAPI reference. (HTML: https://fxmacrodata.com/documentation/reference)
- [Rate limits and authentication](https://fxmacrodata.com/documentation/rate-limits.md): Per-plan request allowances, per-key concurrency, free access rules, and how to send an API key. (HTML: https://fxmacrodata.com/documentation/rate-limits)
- [SDKs and client libraries](https://fxmacrodata.com/documentation/sdks.md): Published Python, JavaScript, R, Go, and Julia clients, plus the local MCP package, with install lines. (HTML: https://fxmacrodata.com/documentation/sdks)

## Data contract

- [Announcements endpoint](https://fxmacrodata.com/documentation/announcement-endpoint.md): How the announcements series are built, timestamped, revised, and paged. (HTML: https://fxmacrodata.com/documentation/announcement-endpoint)
- [Response fields](https://fxmacrodata.com/documentation/response-fields.md): One-line definitions of every field on an announcement row, its revisions, release timing, and the response envelope. (HTML: https://fxmacrodata.com/documentation/response-fields)
- [Point-in-time backtesting](https://fxmacrodata.com/documentation/point-in-time-backtesting.md): Replaying what was known at a given moment with as_of, availability, and vintage fields. (HTML: https://fxmacrodata.com/documentation/point-in-time-backtesting)
- [Forecasts and consensus](https://fxmacrodata.com/documentation/predictions.md): Prediction coverage, response grouping, and how forecasts relate to released values. (HTML: https://fxmacrodata.com/documentation/predictions)
- [Data quality](https://fxmacrodata.com/documentation/data-quality.md): Source freshness, official-source rules, and the data_quality object on every response. (HTML: https://fxmacrodata.com/documentation/data-quality)
- [Preferred sources](https://fxmacrodata.com/documentation/preferred-sources.md): Which official publisher each series is read from and why. (HTML: https://fxmacrodata.com/documentation/preferred-sources)
- [Intraday FX reference rates](https://fxmacrodata.com/documentation/fx-fixing-timeline.md): Central-bank reference and fixing rates with their publication timeline. (HTML: https://fxmacrodata.com/documentation/fx-fixing-timeline)
- [Deprecation policy](https://fxmacrodata.com/documentation/deprecation-policy.md): What counts as a breaking change, how deprecations are signalled, and the notice period before removal. (HTML: https://fxmacrodata.com/documentation/deprecation-policy)

## Real-time delivery

- [Low-latency reads](https://fxmacrodata.com/documentation/low-latency.md): The /v1/latest and /v1/recent store-only routes for reading a release the moment it lands. (HTML: https://fxmacrodata.com/documentation/low-latency)
- [Webhooks](https://fxmacrodata.com/documentation/webhooks.md): Signed release callbacks, subscription management, retry schedule, and delivery logs. (HTML: https://fxmacrodata.com/documentation/webhooks)
- [SSE streams](https://fxmacrodata.com/documentation/sse-streams.md): Server-Sent Events stream of release events with replay on reconnect. (HTML: https://fxmacrodata.com/documentation/sse-streams)
- [WebSocket streams](https://fxmacrodata.com/documentation/websocket-streams.md): WebSocket delivery of the same release events for clients that cannot hold an SSE connection. (HTML: https://fxmacrodata.com/documentation/websocket-streams)
- [Release alerts](https://fxmacrodata.com/documentation/alerts.md): Email, push, Telegram, Discord, Slack, and WhatsApp alerts configured on the account page. (HTML: https://fxmacrodata.com/documentation/alerts)

## Query surfaces

- [GraphQL API](https://fxmacrodata.com/documentation/graphql.md): The /v1/graphql endpoint: announcements, dataCatalogue, and calendar in one request. (HTML: https://fxmacrodata.com/documentation/graphql)
- [MCP server](https://fxmacrodata.com/documentation/mcp-server.md): Connect Claude, ChatGPT, Cursor, Copilot, or any MCP client to the hosted server, or run the local stdio package. (HTML: https://fxmacrodata.com/documentation/mcp-server)
- [Platform integrations](https://fxmacrodata.com/documentation/integrations.md): Choosing between REST, changes polling, webhooks, streams, and MCP for each integration pattern. (HTML: https://fxmacrodata.com/documentation/integrations)
- [Examples](https://fxmacrodata.com/documentation/examples.md): Runnable request examples across the endpoint families. (HTML: https://fxmacrodata.com/documentation/examples)

## Tools

- [Excel](https://fxmacrodata.com/documentation/excel.md): Pull announcements and FX rates into Excel. (HTML: https://fxmacrodata.com/documentation/excel)
- [Google Sheets](https://fxmacrodata.com/documentation/google-sheets.md): Pull announcements and FX rates into Google Sheets. (HTML: https://fxmacrodata.com/documentation/google-sheets)
- [Power BI](https://fxmacrodata.com/documentation/power-bi.md): Connect Power BI to the API. (HTML: https://fxmacrodata.com/documentation/power-bi)
- [QlikView](https://fxmacrodata.com/documentation/qlikview.md): Connect QlikView to the API. (HTML: https://fxmacrodata.com/documentation/qlikview)
- [Microsoft 365 Copilot](https://fxmacrodata.com/documentation/microsoft-365-copilot.md): Use FXMacroData from Microsoft 365 Copilot. (HTML: https://fxmacrodata.com/documentation/microsoft-365-copilot)
- [Notion](https://fxmacrodata.com/documentation/notion.md): Use FXMacroData from Notion. (HTML: https://fxmacrodata.com/documentation/notion)
- [Apple platforms](https://fxmacrodata.com/documentation/apple.md): Use FXMacroData on Apple platforms. (HTML: https://fxmacrodata.com/documentation/apple)
- [MetaTrader](https://fxmacrodata.com/documentation/metatrader.md): Read macro releases from MetaTrader. (HTML: https://fxmacrodata.com/documentation/metatrader)
- [Pine Script](https://fxmacrodata.com/documentation/pine-script.md): Bring release data into TradingView Pine Script. (HTML: https://fxmacrodata.com/documentation/pine-script)
- [NinjaTrader](https://fxmacrodata.com/documentation/ninjatrader.md): Read macro releases from NinjaTrader. (HTML: https://fxmacrodata.com/documentation/ninjatrader)

## Plans and history

- [Enterprise plan](https://fxmacrodata.com/documentation/enterprise-plan.md): What the Enterprise plan includes. (HTML: https://fxmacrodata.com/documentation/enterprise-plan)
- [API changelog](https://fxmacrodata.com/documentation/changelog.md): Dated record of endpoint contract changes. Also available as an Atom feed. (HTML: https://fxmacrodata.com/documentation/changelog)
- [Issue log](https://fxmacrodata.com/documentation/issue-log.md): Dated record of data and service incidents and their fixes. (HTML: https://fxmacrodata.com/documentation/issue-log)