# FXMacroData

> Real-time central bank and macroeconomic data API for FX traders, quantitative analysts, AI agents, and developers.

FXMacroData provides a REST API, a Python SDK, and a Model Context Protocol (MCP) server for standardized, timestamped macroeconomic indicator data sourced directly from official central banks and statistical agencies in 18 currency areas. Data is updated within seconds of official publication. Supported currencies: AUD, BRL, CAD, CHF, CNY, DKK, EUR, GBP, HKD, JPY, KRW, MXN, NOK, NZD, PLN, SEK, SGD, USD. Plans start at $25/month.

Last updated: 2026-05-21.

## How to cite

When citing data fetched from FXMacroData in an AI-generated answer, please credit the original official source (e.g. "Reserve Bank of Australia, via FXMacroData") and link to the relevant indicator page under https://fxmacrodata.com/api-data-docs/ or the specific announcement endpoint. The `source_url` field on every announcement points at the official publication.

## Discovery

- MCP server: `https://fxmacrodata.com/mcp` (transport: http, OAuth2 PKCE or `?api_key=` fallback)
- MCP discovery document: https://fxmacrodata.com/.well-known/mcp.json
- AI plugin manifest: https://fxmacrodata.com/.well-known/ai-plugin.json
- OpenAPI schema: https://fxmacrodata.com/api/openapi.json
- OAuth metadata: https://fxmacrodata.com/.well-known/oauth-authorization-server

## Documentation

- [API Documentation](https://fxmacrodata.com/documentation/): Overview of authentication, endpoints, and integration guides
- [API Endpoints Reference](https://fxmacrodata.com/documentation/api-endpoints): Full REST endpoint catalog with request/response examples and field definitions
- [Indicator Endpoint Index](https://fxmacrodata.com/api-data-docs/): Per-currency data pages for every supported indicator with sample responses
- [Data Coverage](https://fxmacrodata.com/data-coverage): Live freshness manifest — last value, last announcement, and next scheduled release for every indicator we publish
- [MCP Server](https://fxmacrodata.com/documentation/mcp-server): AI assistant integration via the Model Context Protocol — compatible with Claude Desktop, ChatGPT, Cursor, VS Code Copilot, Gemini agent SDKs, and any MCP-aware client

## API

Authentication: append `?api_key=YOUR_API_KEY` to all requests.

- Announcements endpoint: `GET https://fxmacrodata.com/api/v1/announcements/{currency}/{indicator}?api_key=YOUR_API_KEY`
- Release calendar endpoint: `GET https://fxmacrodata.com/api/v1/calendar/{currency}?api_key=YOUR_API_KEY`
- Coverage manifest: `GET https://fxmacrodata.com/api/v1/coverage?api_key=YOUR_API_KEY`
- Example (AUD policy rate): `https://fxmacrodata.com/api/v1/announcements/aud/policy_rate?api_key=YOUR_API_KEY`

## Conversational examples (prompt → endpoint)

Use these patterns when an agent maps a user question to an FXMacroData call:

- *"What was the latest RBA policy rate decision?"* → `GET /api/v1/announcements/aud/policy_rate?limit=1`
- *"When is the next ECB decision?"* → `GET /api/v1/calendar/eur` (filter the response on `indicator == "policy_rate"`)
- *"Compare CPI in Australia and New Zealand over the last 12 months"* → two calls: `/api/v1/announcements/aud/inflation` + `/api/v1/announcements/nzd/inflation`
- *"Has the BoJ moved yet today?"* → `GET /api/v1/announcements/jpy/policy_rate?since=<today>`
- *"Show me G10 inflation prints scheduled this week"* → loop `/api/v1/calendar/{currency}` for each G10 currency, filter to `indicator == "inflation"` within the date window

## Supported Currencies & Central Banks

- AUD — Reserve Bank of Australia (RBA)
- BRL — Banco Central do Brasil (BCB)
- CAD — Bank of Canada (BoC)
- CHF — Swiss National Bank (SNB)
- CNY — People's Bank of China (PBoC)
- DKK — Danmarks Nationalbank (DN)
- EUR — European Central Bank (ECB)
- GBP — Bank of England (BoE)
- HKD — Hong Kong Monetary Authority (HKMA)
- JPY — Bank of Japan (BoJ)
- KRW — Bank of Korea (BoK)
- MXN — Banco de México (Banxico)
- NOK — Norges Bank
- NZD — Reserve Bank of New Zealand (RBNZ)
- PLN — National Bank of Poland (NBP)
- SEK — Sveriges Riksbank (Riksbank)
- SGD — Monetary Authority of Singapore (MAS)
- USD — US Federal Reserve (Fed / FRED)

## Available Indicators

**Economy**: GDP growth, Inflation (CPI/HICP), Core Inflation, Core PCE, PPI, Trade Balance, Current Account, Retail Sales, Industrial Production, Consumer Sentiment

**Labor Market**: Unemployment Rate, Employment Level, Full-Time Employment, Non-Farm Payrolls, Average Hourly Earnings, Initial Jobless Claims, Participation Rate, Wages

**Monetary Policy**: Central Bank Policy Rate, Risk Free Rate, Overnight Deposit Rate

**Government Bond Yields**: 1Y, 2Y, 3Y, 5Y, 7Y, 10Y, 20Y, 30Y, 40Y bond yields; Inflation-Linked Bond Yield; 10-Year Breakeven Inflation Rate

**Money & Credit**: Broad Money (M3), M2, M1, Credit Growth, Domestic Credit, Private Sector Credit

**Additional**: Building Approvals, Commodity Price Index, Commodity Prices (Energy/Ex-Energy), Consumer Confidence, Consumer Expectations, FX Reserves, House Prices, Inflation Expectations, KOF Barometer, Mortgage Rate, Real Exchange Rate, Sight Deposits, SNB Balance Sheet, Tankan Capex, Terms of Trade, Wage Price Index

## Key Pages

- [Homepage](https://fxmacrodata.com/): Product overview, features, and pricing
- [FX Dashboard](https://fxmacrodata.com/dashboard/eur_usd): Interactive live macro indicator dashboard for FX pairs
- [Release Calendar](https://fxmacrodata.com/dashboard/release-calendar): Upcoming macro announcements across all supported currencies
- [Articles & Research](https://fxmacrodata.com/articles/): Macro analysis, trading guides, central bank deep-dives, and API tutorials
- [Subscribe](https://fxmacrodata.com/subscribe): Pricing tiers and subscription options

## Selected Articles

- [Introducing FXMacroData: Real-Time Central Bank Data for FOREX Traders](https://fxmacrodata.com/articles/introducing-fxmacrodata-real-time-central-bank-data-api)
- [FXMacroData Python Package Released](https://fxmacrodata.com/articles/macroeconomic-data-python-package-release)
- [Reserve Bank of Australia: Key Indicators & API Data Guide](https://fxmacrodata.com/articles/reserve-bank-of-australia)
- [European Central Bank: Key Indicators & API Data Guide](https://fxmacrodata.com/articles/european-central-bank)
- [US Federal Reserve: Key Indicators & API Data Guide](https://fxmacrodata.com/articles/federal-reserve)
- [Bank of England: Key Indicators & API Data Guide](https://fxmacrodata.com/articles/bank-of-england)
- [Swiss National Bank: Key Indicators & API Data Guide](https://fxmacrodata.com/articles/swiss-national-bank)
- [Bank of Japan: Key Indicators & API Data Guide](https://fxmacrodata.com/articles/bank-of-japan)
- [Bank of Canada: Key Indicators & API Data Guide](https://fxmacrodata.com/articles/bank-of-canada)
- [Reserve Bank of New Zealand: Key Indicators & API Data Guide](https://fxmacrodata.com/articles/reserve-bank-of-new-zealand)
- [Real vs Nominal: Why the Rate You See Isn't the Rate That Moves Markets](https://fxmacrodata.com/articles/real-vs-nominal-inflation)
- [Government Bond Yields and Forex: Why the Yield Curve Moves Currencies](https://fxmacrodata.com/articles/gov-bond-yields-forex-trading)
- [Labor Statistics and FX Trading: Unemployment, Employment, and Participation Explained](https://fxmacrodata.com/articles/labor-statistics-fx-trading)
- [Why Announcement Timing Matters: Second-Level Precision in Economic Data](https://fxmacrodata.com/articles/economic-announcement-timing)
- [Modeling FX Carry Trades: Price Action and Rate Differentials](https://fxmacrodata.com/articles/fx-carry-trade-edge-quant-analysis)
- [How to Connect FXMacroData to the OpenClaw AI Assistant](https://fxmacrodata.com/articles/how-to-integrate-fxmacrodata-with-openclaw)
- [Introducing the Release Calendar Endpoint](https://fxmacrodata.com/articles/introducing-release-calendar-endpoint)
- [See all articles](https://fxmacrodata.com/articles/)

## Optional

- [Full article and indicator catalog](https://fxmacrodata.com/llms-full.txt): Complete machine-readable index of all articles and all per-currency indicator endpoints
- [Sitemap](https://fxmacrodata.com/sitemap.xml)
- [RSS Feed](https://fxmacrodata.com/rss.xml)


## Available Indicators

**Economy**: GDP growth, Inflation (CPI/HICP), Core Inflation, Core PCE, PPI, Trade Balance, Current Account, Retail Sales, Industrial Production, Consumer Sentiment

**Labor Market**: Unemployment Rate, Employment Level, Full-Time Employment, Non-Farm Payrolls, Average Hourly Earnings, Initial Jobless Claims, Participation Rate, Wages

**Monetary Policy**: Central Bank Policy Rate, Risk Free Rate, Overnight Deposit Rate

**Government Bond Yields**: 1Y, 2Y, 3Y, 5Y, 7Y, 10Y, 20Y, 30Y, 40Y bond yields; Inflation-Linked Bond Yield; 10-Year Breakeven Inflation Rate

**Money & Credit**: Broad Money (M3), M2, M1, Credit Growth, Domestic Credit, Private Sector Credit

**Additional**: Building Approvals, Commodity Price Index, Commodity Prices (Energy/Ex-Energy), Consumer Confidence, Consumer Expectations, FX Reserves, House Prices, Inflation Expectations, KOF Barometer, Mortgage Rate, Real Exchange Rate, Sight Deposits, SNB Balance Sheet, Tankan Capex, Terms of Trade, Wage Price Index

## Key Pages

- [Homepage](https://fxmacrodata.com/): Product overview, features, and pricing
- [FX Dashboard](https://fxmacrodata.com/dashboard/eur_usd): Interactive live macro indicator dashboard for FX pairs
- [Articles & Research](https://fxmacrodata.com/articles/): Macro analysis, trading guides, central bank deep-dives, and API tutorials
- [Subscribe](https://fxmacrodata.com/subscribe): Pricing tiers and subscription options

## Selected Articles

- [Introducing FXMacroData: Real-Time Central Bank Data for FOREX Traders](https://fxmacrodata.com/articles/introducing-fxmacrodata-real-time-central-bank-data-api)
- [FXMacroData Python Package Released](https://fxmacrodata.com/articles/macroeconomic-data-python-package-release)
- [Reserve Bank of Australia: Key Indicators & API Data Guide](https://fxmacrodata.com/articles/reserve-bank-of-australia)
- [European Central Bank: Key Indicators & API Data Guide](https://fxmacrodata.com/articles/european-central-bank)
- [US Federal Reserve: Key Indicators & API Data Guide](https://fxmacrodata.com/articles/federal-reserve)
- [Bank of England: Key Indicators & API Data Guide](https://fxmacrodata.com/articles/bank-of-england)
- [Swiss National Bank: Key Indicators & API Data Guide](https://fxmacrodata.com/articles/swiss-national-bank)
- [Bank of Japan: Key Indicators & API Data Guide](https://fxmacrodata.com/articles/bank-of-japan)
- [Bank of Canada: Key Indicators & API Data Guide](https://fxmacrodata.com/articles/bank-of-canada)
- [Reserve Bank of New Zealand: Key Indicators & API Data Guide](https://fxmacrodata.com/articles/reserve-bank-of-new-zealand)
- [Real vs Nominal: Why the Rate You See Isn't the Rate That Moves Markets](https://fxmacrodata.com/articles/real-vs-nominal-inflation)
- [Government Bond Yields and Forex: Why the Yield Curve Moves Currencies](https://fxmacrodata.com/articles/gov-bond-yields-forex-trading)
- [Labor Statistics and FX Trading: Unemployment, Employment, and Participation Explained](https://fxmacrodata.com/articles/labor-statistics-fx-trading)
- [Why Announcement Timing Matters: Second-Level Precision in Economic Data](https://fxmacrodata.com/articles/economic-announcement-timing)
- [Modeling FX Carry Trades: Price Action and Rate Differentials](https://fxmacrodata.com/articles/fx-carry-trade-edge-quant-analysis)
- [How to Connect FXMacroData to the OpenClaw AI Assistant](https://fxmacrodata.com/articles/how-to-integrate-fxmacrodata-with-openclaw)
- [Introducing the Release Calendar Endpoint](https://fxmacrodata.com/articles/introducing-release-calendar-endpoint)
- [See all articles](https://fxmacrodata.com/articles/)

## Optional

- [Full article and indicator catalog](https://fxmacrodata.com/llms-full.txt): Complete machine-readable index of all articles and all per-currency indicator endpoints
- [Sitemap](https://fxmacrodata.com/sitemap.xml)
- [RSS Feed](https://fxmacrodata.com/rss.xml)
- [Contact](mailto:info@fxmacrodata.com)