SDKs and client libraries

All clients read the key from a constructor argument or an environment variable and send it in the X-API-Key header. Without a key they return USD data on the free terms described under free access. Get a key on the account page.

pip install fxmacrodata

from fxmacrodata import Client

client = Client(api_key="YOUR_API_KEY")

# Macro releases: AUD cash rate decisions in a window
data = client.get_indicator("aud", "policy_rate", start_date="2023-01-01", end_date="2023-11-01")

# FX history, optionally with indicators computed server-side
fx = client.get_fx_price("eur", "usd", indicators="sma_20,rsi_14,macd")

# Release calendar and catalogue discovery
calendar = client.get_calendar("usd")

Optional extras add OpenBB and MCP integrations; see the package README. The Python package is also what the Python and notebook guides use.

npm install @fxmacrodata/client

import { FXMacroDataClient } from "@fxmacrodata/client";

const client = new FXMacroDataClient({ apiKey: process.env.FXMACRODATA_API_KEY });
const result = await client.announcements("aud", "policy_rate");

// Helpers for MCP hosts that need a URL or headers
import { createMcpHeaders, createMcpUrl } from "@fxmacrodata/client";
const headers = createMcpHeaders({ apiKey: process.env.FXMACRODATA_API_KEY });

install.packages("remotes")
remotes::install_github("fxmacrodata/fxmacrodata-r")

library(fxmacrodata)
fxmd_set_key("YOUR_API_KEY")   # or set FXMACRODATA_API_KEY in ~/.Renviron

rates    <- fxmd_announcements("USD", "policy_rate")
cpi      <- fxmd_announcements("USD", "inflation", start_date = as.Date("2025-01-01"))
calendar <- fxmd_calendar("USD")
fxmd_meta(rates)$source

Date columns arrive already parsed. Function reference: fxmacrodata/fxmacrodata-r.

go get github.com/fxmacrodata/fxmacrodata-go

import fxmacrodata "github.com/fxmacrodata/fxmacrodata-go"

client := fxmacrodata.NewAPIClient(fxmacrodata.NewConfiguration())
rates, _, err := client.FXMacroDataAPI.GetAnnouncements(ctx, "USD", "policy_rate").Execute()
calendar, _, err := client.FXMacroDataAPI.GetCalendar(ctx, "USD").Execute()

Source and API documentation: fxmacrodata/fxmacrodata-go.

using Pkg
Pkg.add(url="https://github.com/fxmacrodata/FXMacroData.jl")

Usage: fxmacrodata/FXMacroData.jl.

opam install fxmacrodata

Installation and dependencies: opam package. Usage and source: fxmacrodata/ocaml-fxmacrodata.

uvx mcp-server-fxmacrodata

{
  "mcpServers": {
    "fxmacrodata": {
      "command": "uvx",
      "args": ["mcp-server-fxmacrodata"],
      "env": { "FXMACRODATA_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Full setup for Claude, ChatGPT, Cursor, VS Code and other hosts is on the MCP server page.

• Generate a client from https://api.fxmacrodata.com/openapi.json with any OpenAPI generator.
• Or call it directly: curl -H "X-API-Key: YOUR_API_KEY" https://api.fxmacrodata.com/v1/announcements/eur/policy_rate?limit=1
• Officially listed integrations for DuckDB, Apache Airflow, Singer / Meltano and Hermes are available under open source integrations.