The FXMacroData Python SDK provides a simple and efficient interface for fetching macroeconomic indicators and forex price history from FXMacroData.

It includes both synchronous and asynchronous clients, supports free USD endpoints, and offers a free Forex Price API for exchange rate data.

• Fetch:
  • Policy Rates
  • Inflation & CPI
  • GDP
  • Unemployment
  • Balance of Trade
  • Government Bond Yields
• Free access to USD macro data.
• Free Forex Price API (get_fx_price).
• API key required only for non-USD indicators.
• Full support for:
  • Synchronous client
  • Asynchronous client
• Lightweight: depends only on requests and aiohttp.

Install from PyPI:

pip install fxmacrodata

Or install the latest version from GitHub:

pip install git+https://github.com/fxmacrodata/fxmacrodata.git

from fxmacrodata import Client

client = Client(api_key="YOUR_API_KEY")

# Fetch macroeconomic indicators
data = client.get_indicator(
    "aud", "policy_rate",
    start_date="2023-01-01",
    end_date="2023-11-01"
)
print(data)

# Free Forex Price Endpoint
fx = client.get_fx_price("usd", "gbp", start_date="2025-01-01")
print(fx)

import asyncio
from fxmacrodata import AsyncClient

async def main():
    async with AsyncClient(api_key="YOUR_API_KEY") as client:
        # Fetch macroeconomic indicators
        data = await client.get_indicator("eur", "cpi")
        print(data)

        # Free Forex Price Endpoint
        fx = await client.get_fx_price("usd", "jpy")
        print(fx)

asyncio.run(main())

Fetches macroeconomic indicator time series data.

• currency: "usd", "aud", "eur", "gbp", "cad", "nok", "nzd", "jpy", etc.
• indicator: "policy_rate", "cpi", "inflation", "gdp", "unemployment", "trade_balance", "current_account", etc.
• API key required for non-USD.

Fetches historical FX prices between two currencies. No API key needed for USD-based queries.

MIT License © FXMacroData

• Website: https://fxmacrodata.com
• API Docs: https://fxmacrodata.com/docs
• GitHub: https://github.com/fxmacrodata/fxmacrodata
• PyPI: https://pypi.org/project/fxmacrodata/
• Readthedocs: https://fxmacrodata.readthedocs.io/en/latest/
• Zenodo: https://zenodo.org/records/18280968