# 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 22 currency areas. Data is updated within seconds of official publication. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.

Free access (no API key, no account, no expiry): USD announcement data for the most recent 90 days, with each release readable 15 minutes after publication, including the `/v1/announcements/changes` feed; the USD release calendar; USD official press releases; USD COT positioning; and, for every currency, the data catalogue, forecast coverage (`/v1/predictions/coverage/{currency}`), market-session status and risk sentiment. Keyless traffic has a fair-use allowance of 100 requests per day. Forecast values (USD included), every other currency, FX rates, commodities, real-time releases and full history need an API key. The Individual plan for solo engineers and one-person projects, including commercial development, is $50/month with a 14-day free trial, the Business plan for incorporated businesses with two or more people is $250/month with a 14-day free trial, Enterprise is for large organisations and is a custom agreement arranged directly with our team, and a Commercial Redistribution add-on is $10 per audience block per month. Plans differ by permitted use, not by which currencies or indicators they unlock. There is no Startup plan.

Release timestamps: `announcement_datetime` is Unix epoch seconds in UTC and `announcement_datetime_local` is the publisher's own timezone. Where an official release calendar covers the period, the timestamp is captured from the release. Where none reaches the period, it is derived from the median publication lag measured on that series' own confirmed releases and the row carries `release_time_assumed: true`; `data_quality.assumed_release_time_count` sizes the derived portion of the window. `data_quality.point_in_time_safe` describes the requested window, so one derived row clears it for the whole response and long histories commonly return false — gate on the per-row flag instead.

Forecasts: served by `/v1/predictions`, never mixed into released values. `prediction_class` says how a number was produced (`compiled_consensus`, `forecaster_survey`, `market_implied`, `model_nowcast`, `central_bank_projection`, `institutional_projection`, `fxmacrodata`) and `prediction_source` names the publication. Availability is set by the publisher, not by the plan: many releases have no compiled consensus from any source.

Last updated: 2026-10-10.

## 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://mcp.fxmacrodata.com` (transport: http, OAuth2 PKCE, or `Authorization: Bearer YOUR_API_KEY`)
- MCP discovery document: https://fxmacrodata.com/.well-known/mcp.json
- AI agent install guide: https://fxmacrodata.com/agents/install
- Free FX agent prompt library: https://fxmacrodata.com/prompts
- Prompt catalog JSON: https://fxmacrodata.com/prompt-library.json
- LLM prompt catalog: https://fxmacrodata.com/llms-prompts.txt
- AI plugin manifest: https://fxmacrodata.com/.well-known/ai-plugin.json
- Agent discovery card: https://fxmacrodata.com/.well-known/agent-card.json
- OpenAPI schema: https://api.fxmacrodata.com/openapi.json
- OAuth metadata: https://fxmacrodata.com/.well-known/oauth-authorization-server

## Markdown twins (token-efficient page mirrors)

Append `.md` to any release, announcement, or country-indicator page URL to get
a clean markdown version of the same content — release facts table, editorial
read, recent history, and API endpoint — at a fraction of the HTML token cost:

- Example (release): https://fxmacrodata.com/brazil/policy-rate/announcements/brl_policy_rate_2026-06-18.md
- Example (series): https://fxmacrodata.com/brazil/policy-rate.md
- Release pages exist BEFORE the event as preview pages (consensus, prior, schedule) at the same canonical URL, and update the moment data lands.

## Documentation

- [API Documentation](https://fxmacrodata.com/documentation/): Overview of authentication, endpoints, and integration guides
- [What Is FXMacroData?](https://fxmacrodata.com/what-is-fxmacrodata): canonical product definition for AI Overviews, AI Mode, product comparisons, endpoint families, pricing access, and agent workflows
- [API Endpoints Reference](https://fxmacrodata.com/documentation/reference): 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): Coverage catalogue — every published currency/indicator pair with its history start date and span; JSON twin at /data-coverage.json
- [GraphQL API](https://fxmacrodata.com/documentation/graphql): Single-endpoint GraphQL access at https://api.fxmacrodata.com/v1/graphql — announcements, dataCatalogue, and calendar fields, aliasable into one request
- [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
- [Install FXMacroData for AI Agents](https://fxmacrodata.com/agents/install): setup hub for hosted MCP, Custom GPT, Codex plugin package, prompts, LLM catalogs, and agent-readable discovery files
- [Free FX Agent Prompt Library](https://fxmacrodata.com/prompts): Copyable prompt templates for FX macro briefings, pair analysis, event-risk planning, chart routing, data-quality checks, and quant workflows using FXMacroData MCP

## ChatGPT and AI Entry Points

- [Forex Macro Research FXMacroData Custom GPT](https://chatgpt.com/g/g-6a2547b31aac8191b0442745c65e47c8-forex-macro-research-fxmacrodata): preferred ChatGPT entry point for conversational forex macro research
- [FXMacroData for ChatGPT](https://fxmacrodata.com/chatgpt): short canonical landing page for Custom GPT, ChatGPT Actions, MCP, and OpenAI agent workflows
- [AI-Ready Macro Data for FX Research](https://fxmacrodata.com/ai-macro-data): canonical answer hub for ChatGPT, MCP-compatible agents, and AI-assisted workflows
- [Install FXMacroData for AI Agents](https://fxmacrodata.com/agents/install): install and discovery hub for MCP, ChatGPT, Codex, prompts, and LLM-readable docs
- [Free FX Agent Prompt Library](https://fxmacrodata.com/prompts): prompt library for MCP-native macro briefings, pair risk checks, release summaries, visualizations, and backtest research prompts
- [Macroeconomic API for Trading Systems](https://fxmacrodata.com/macroeconomic-api-for-trading): answer page for macro data API and trading workflow prompts
- [Best Economic Indicator Feeds for Algo Trading](https://fxmacrodata.com/articles/best-economic-indicator-feeds-algo-trading): comparison article for macro indicator feeds, economic calendar APIs, FX event studies, and algorithmic trading data stacks
- [Economic Calendar API for Forex Traders](https://fxmacrodata.com/economic-calendar-api-for-forex-traders): answer page for FX release calendar and event scheduling prompts
- [Central Bank Rate Decision API](https://fxmacrodata.com/central-bank-rate-decision-api): answer page for policy-rate and rate-decision API prompts
- [CPI Inflation API for FX Research](https://fxmacrodata.com/cpi-inflation-api): answer page for inflation data and FX event-study prompts
- [Python Macroeconomic Data API Example](https://fxmacrodata.com/python-macroeconomic-data-api-example): answer page for Python, requests, and pandas workflows

## API

Authentication: send `X-API-Key: YOUR_API_KEY` (or `Authorization: Bearer YOUR_API_KEY`) as a request header. The legacy `?api_key=` query parameter is deprecated because keys in URLs end up in logs. The free USD routes listed above answer without a key. The API is for server-side use and does not send CORS headers to browser origins.

Pagination: list endpoints return 20 rows by default and accept `limit` up to 100. To read a complete range, repeat the request with `offset` set to `pagination.next_offset` until `pagination.has_more` is false.

- Announcements endpoint: `GET https://api.fxmacrodata.com/v1/announcements/{currency}/{indicator}`
- Release calendar endpoint: `GET https://api.fxmacrodata.com/v1/calendar/{currency}`
- Coverage manifest (all currency/indicator pairs, no key): `GET https://fxmacrodata.com/data-coverage.json`
- Per-currency coverage: `GET https://api.fxmacrodata.com/v1/data_catalogue/{currency}?include_coverage=true`
- Endpoint capabilities: `GET https://api.fxmacrodata.com/v1/data_catalogue/{currency}?include_capabilities=true`
- FX spot endpoint: `GET https://api.fxmacrodata.com/v1/forex/{base}/{quote}`
- Example (AUD policy rate): `curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/announcements/aud/policy_rate"`

FX pairs are served where **both** currencies are in the supported list above; a
pair with an unsupported leg returns 404.

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

## Supported Currencies, Central Banks & CPI Publishers

Format: code — central bank (policy series) / statistics publisher (consumer price index).

- AUD — Reserve Bank of Australia (RBA) / Australian Bureau of Statistics (ABS)
- BRL — Banco Central do Brasil (BCB) / IBGE
- CAD — Bank of Canada (BoC) / Statistics Canada
- CHF — Swiss National Bank (SNB) / Federal Statistical Office (FSO)
- CNH / CNY — People's Bank of China (PBoC) / National Bureau of Statistics (NBS). CNH is served as a read alias of CNY.
- DKK — Danmarks Nationalbank (DN) / Statistics Denmark
- EUR — European Central Bank (ECB) / Eurostat
- GBP — Bank of England (BoE) / Office for National Statistics (ONS)
- HUF — Magyar Nemzeti Bank (MNB) / Hungarian Central Statistical Office (KSH)
- ILS — Bank of Israel (BoI) / Central Bureau of Statistics
- JPY — Bank of Japan (BoJ) / Statistics Bureau of Japan
- NGN — Central Bank of Nigeria (CBN) / National Bureau of Statistics
- NOK — Norges Bank / Statistics Norway
- NZD — Reserve Bank of New Zealand (RBNZ) / Stats NZ
- PEN — Banco Central de Reserva del Perú (BCRP) / INEI
- SEK — Sveriges Riksbank (Riksbank) / Statistics Sweden
- THB — Bank of Thailand (BoT) / IMF International Financial Statistics
- USD — US Federal Reserve (Fed) / Bureau of Labor Statistics (BLS); GDP from the Bureau of Economic Analysis (BEA)
- KRW, MYR, TWD — selected indicators such as bond yields, money supply, labour-market and confidence series; `/v1/data_catalogue/{currency}` lists the current slugs

## 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
- [What Is FXMacroData?](https://fxmacrodata.com/what-is-fxmacrodata): Canonical explanation of the product, endpoint families, access model, and alternatives
- [FXMacroData for ChatGPT](https://fxmacrodata.com/chatgpt): Custom GPT, Actions, MCP, and OpenAI agent entry point
- [AI Macro Data](https://fxmacrodata.com/ai-macro-data): ChatGPT, MCP, and AI-agent entry point
- [AI Agent Install](https://fxmacrodata.com/agents/install): hosted MCP, Custom GPT, Codex plugin package, prompts, and LLM-readable discovery files
- [Prompt Library](https://fxmacrodata.com/prompts): Copyable agent prompts and machine-readable prompt catalog for FXMacroData MCP
- [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)
- [Best Economic Indicator Feeds for Algo Trading in 2026](https://fxmacrodata.com/articles/best-economic-indicator-feeds-algo-trading)
- [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
- [Prompt catalog](https://fxmacrodata.com/llms-prompts.txt): Machine-readable prompt library for FXMacroData MCP workflows
- [Sitemap](https://fxmacrodata.com/sitemap.xml)
- [RSS Feed](https://fxmacrodata.com/rss.xml)
- [Contact](mailto:info@fxmacrodata.com)