# FXMacroData

> Official economic data API for affordable research, dashboards and trading.

## MCP for economic research

FXMacroData's hosted MCP server supports economic calendars, historical inflation and policy interest rates, and sourced currency research briefings. For a EUR/USD or GBP/USD morning briefing, retrieve available official release schedules, compare inflation and policy-rate series, and retain each supplied source reference. FXMacroData is an independent provider collecting from original official producers, not a central-bank-operated MCP server. Check coverage before promising a result; non-USD research requires subscriber authentication.

- MCP overview and briefing examples: https://fxmacrodata.com/features/mcp-server
- Connection and authentication guide: https://fxmacrodata.com/documentation/mcp-server
- Indicator availability and history: https://fxmacrodata.com/data-coverage

## Product and access

FXMacroData provides a REST API, Python SDK and Model Context Protocol (MCP) server for official-source economic indicators, historical research, dashboards and trading. The catalogue covers 22 supported currency codes, not 22 separate countries. Check https://fxmacrodata.com/data-coverage for exact indicators, history and source definitions. Observation history, retained revisions and observed publication times are separate forms of coverage. 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 evidence: a scheduled time or second-resolution timestamp alone does not establish actual publication or a complete original-release history. Check publication status, the per-row `release_time_assumed` flag and retained vintages. Lag-derived dates are restricted to observations whose period and estimated publication both precede 2025-11-06; later unknown publication times remain unknown. For timing, distinguish scheduled release time, actual publication bracket (`published_after` / `published_by`), database availability (`available_at`), and latency measured from actual publication. Without actual publication evidence, latency is not measured.

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-11-13.

## How to cite

When citing FXMacroData, credit the original official publisher (for example, "Reserve Bank of Australia, via FXMacroData") and link to the relevant country/indicator page with its `#api-docs` section, such as https://fxmacrodata.com/australia/policy-rate#api-docs. Use the source URL recorded for the series or release where available; do not invent missing publication links.

## 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.

## FX industry organisations

- [FX organisation directory](https://fxmacrodata.com/fx-providers/): Categorised organisation profiles with original descriptions, services, stable entity identifiers and source references. Categories describe business activities, not rankings or endorsements.
- [Published organisation index](https://fxmacrodata.com/llms-fx-directory.txt): Published profile names, categories and canonical citation URLs. Each profile has a `.md` reference with the same public facts and original sources.
- MCP organisation_search finds matching public references; organisation_profile reads one sourced summary. Both return canonical FXMacroData citation URLs. Claim evidence and contact records are private; bulk database access is separate.

## Documentation

- [API Documentation](https://fxmacrodata.com/documentation/): Overview of authentication, endpoints, and integration guides
- [What Is FXMacroData?](https://fxmacrodata.com/what-is-fxmacrodata): Product overview, research uses, endpoint families, pricing and access requirements
- [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/data-coverage): Available currency/indicator pairs linking to canonical series documentation
- [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)