Skip to content
@fxmacrodata

FXMacroData

Real-time forex macroeconomic API for all major currency pairs sourced from central bank announcements.
README.md

FXMacroData 📊

Official-source macroeconomic and FX data for research and backtesting.

FXMacroData provides macroeconomic observations, FX data and central-bank releases sourced from central banks and statistical agencies. Use supplied publication timestamps and provenance for point-in-time research.

Subscribe to FXMacroData for non-USD data, full available history, FX, commodities and positioning. Use the public USD workflow to evaluate the API before connecting your subscription.

📈 Coverage

Explore the current data coverage for available currencies, indicators and history.

Category Indicators
Monetary policy Policy rate, interbank rate, overnight deposit rate
Economy GDP growth, inflation (CPI/HICP), trade balance, current account, retail sales
Labour market Unemployment, employment, participation rate, non-farm payrolls
Government bonds 2y–30y yields, inflation-linked bonds
Positioning & commodities CFTC Commitment of Traders, gold, silver, platinum
Other Money supply, inflation expectations, house prices

Browse the full matrix at Data Coverage.

🚀 Start here

pip install fxmacrodata
from fxmacrodata import Client

# The key is sent as an X-API-Key header, not in the URL.
client = Client(api_key="YOUR_API_KEY")

# Macroeconomic releases, with announcement timestamps
data = client.get_indicator("eur", "inflation", start_date="2023-01-01")

# Upcoming releases
calendar = client.get_calendar("usd")

An async client is available as AsyncClient. Both depend only on requests and aiohttp, and work directly with pandas.

📦 Repositories

Repo What it is
fxmacrodata Official Python SDK — sync + async clients (PyPI)
mcp-server-fxmacrodata MCP server, for using the data from Claude and other AI agents
examples Runnable examples across backtesting and analysis frameworks
ocaml-fxmacrodata OCaml client (opam)
FXMacroData.jl Julia client
astrbot-plugin-fxmacrodata AstrBot plugin exposing the full MCP tool set

🤖 AI agents & MCP

The API is available as a hosted Model Context Protocol server, so an agent can query macro data, release calendars, and FX rates as tools:

https://mcp.fxmacrodata.com/mcp

See the MCP Server docs for client setup, or run the self-hosted server.

💡 Why it exists

  • Point-in-time research — use supplied publication timestamps and revision metadata when constructing historical datasets
  • Official sources only — central banks and statistical agencies, with provenance on every response
  • Release-aware — a calendar of upcoming releases with confirmed vs assumed times, not just historical series
  • Built for machines — REST, GraphQL, OpenAPI, and MCP

💰 Access

Plan Access
Individual Subscription for personal research and trading, including non-USD data, full available history, FX, positioning and commodities
Enterprise Subscription for institutional use, with team access and administrative controls
USD evaluation Public USD macroeconomic data within the public-history window, without an API key

Compare subscriptions for current access and terms. Commercial redistribution is a separate add-on.

🔌 Endpoint & authentication

All endpoints live under https://api.fxmacrodata.com/v1/. Authenticate with an X-API-Key header — an api_key query parameter is still accepted, but a key in a URL is recorded by proxies, CDNs and server access logs.

🔗 Links

Popular repositories Loading

  1. fxmacrodata fxmacrodata Public

    Python client library to give traders, quants, and analysts access to forex macroeconomic data via the FXMacroData API.

    Python 12 1

  2. FXMacroData.jl FXMacroData.jl Public

    Julia client for the FXMacroData API — official-source forex, macroeconomic indicators, release calendars and COT positioning

    Julia 1

  3. gloomberb-fxmacrodata gloomberb-fxmacrodata Public

    Native FXMacroData research panes, macro charts and commands for Gloomberb

    TypeScript 1 1

  4. .github .github Public

    Real-time forex macroeconomic API for all major currency pairs sourced from central bank announcements.

  5. mcp-server-fxmacrodata mcp-server-fxmacrodata Public

    MCP server for the FXMacroData API — macroeconomic indicators, release calendars, COT, commodities, and forex for AI agents. Works with Claude Desktop, Cursor, VS Code, OpenClaw, and any MCP client.

    Python

  6. examples examples Public

    Example gallery for apps built with data from FXMacroData

    Python

Repositories

Showing 10 of 171 repositories
  • claude-plugin-fxmacrodata Public

    FXMacroData plugin for Claude Code: official-source FX, macroeconomic and central-bank data

    fxmacrodata/claude-plugin-fxmacrodata's past year of commit activity
    0 MIT 0 0 0 Updated Nov 6, 2026
  • last30days-skill Public Forked from mvanhorn/last30days-skill

    AI agent skill that researches any topic across Reddit, X, YouTube, HN, Polymarket, and the web - then synthesizes a grounded summary

    fxmacrodata/last30days-skill's past year of commit activity
    Python 0 MIT 6,178 0 0 Updated Nov 5, 2026
  • local-deep-research Public Forked from LearningCircuit/local-deep-research

    ~95% on SimpleQA (e.g. Qwen3.6-27B on a 3090). Supports all local and cloud LLMs (llama.cpp, Ollama, Google, ...). 10+ search engines - arXiv, PubMed, your private documents. Everything Local & Encrypted.

    fxmacrodata/local-deep-research's past year of commit activity
    Python 0 MIT 956 0 0 Updated Nov 5, 2026
  • sj-fxmacrodata Public

    C++17 response ownership, strict JSON pointers and native sj.h snapshots for FXMacroData clients.

    fxmacrodata/sj-fxmacrodata's past year of commit activity
    C++ 0 MIT 0 0 0 Updated Nov 5, 2026
  • fastjson-fxmacrodata Public

    Complete FXMacroData JSON as independent native FastJSON views, preserving original responses and number text.

    fxmacrodata/fastjson-fxmacrodata's past year of commit activity
    Go 0 MIT 0 0 0 Updated Nov 4, 2026
  • asciigraph-fxmacrodata Public

    Native terminal charts for explicit FXMacroData JSON projections, preserving complete original responses.

    fxmacrodata/asciigraph-fxmacrodata's past year of commit activity
    Go 0 MIT 0 0 0 Updated Nov 4, 2026
  • golang-set-fxmacrodata Public

    Native Go set algebra for complete FXMacroData JSON snapshots, preserving original responses and numeric spelling.

    fxmacrodata/golang-set-fxmacrodata's past year of commit activity
    Go 0 MIT 0 0 0 Updated Nov 4, 2026
  • decimal-fxmacrodata Public

    Exact native decimals from complete FXMacroData JSON responses

    fxmacrodata/decimal-fxmacrodata's past year of commit activity
    Go 0 MIT 0 0 0 Updated Nov 4, 2026
  • govaluate-fxmacrodata Public

    Independent FXMacroData JSON response rules for archived Govaluate v3.0.0

    fxmacrodata/govaluate-fxmacrodata's past year of commit activity
    Go 0 MIT 0 0 0 Updated Nov 4, 2026
  • httprouter-fxmacrodata Public

    FXMacroData JSON integration for native HTTPRouter routes

    fxmacrodata/httprouter-fxmacrodata's past year of commit activity
    Go 0 MIT 0 0 0 Updated Nov 4, 2026
View all repositories