moneyfeel-mri

Python client for the moneyfeel Macro & Geopolitical Risk Index.

Free programmatic access to the moneyfeel MRI — an institutional-grade macro regime classifier covering 5 regions (GLOBAL, US, EU, ASIA, EM) across 3 timeframes (Daily, Weekly, Monthly), updated daily.

Installation

pip install moneyfeel-mri

# With pandas support (recommended)
pip install moneyfeel-mri[pandas]

Get a Free API Key

1. Register at moneyfeel.it — free, no credit card
2. Go to your account page
3. Find the MRI API Access section → Generate API Key

Quick Start

from moneyfeel import MRI

client = MRI("mf_live_YOUR_KEY")

# Current regime — no auth required
current = client.current()
for region in current:
    print(region["region"], region["regime_weekly"], region["score_weekly"])

# Historical data as pandas DataFrame
df = client.history_df("US", "WEEKLY", from_date="2020-01-01")
print(df.tail())

# Latest regime
latest = client.latest("EU", "WEEKLY")
print(f"EU: {latest['regime']} | score={latest['mri_score']}")

# Performance metrics
m = client.metrics("US", "WEEKLY")[0]
print(f"Sharpe: {m['sharpe']} | CAGR: {m['cagr_strategy']}% | MaxDD: {m['max_dd']}%")

# Full CSV download
df_full = client.download("US", "WEEKLY")           # returns DataFrame
client.download("US", "WEEKLY", "us_weekly.csv")    # saves to file

All Methods

Error Handling

from moneyfeel import MRI, MRIAuthError, MRIRateLimitError
import time

client = MRI("mf_live_YOUR_KEY")

try:
    data = client.history("US", "WEEKLY")
except MRIAuthError:
    print("Invalid or revoked key — get a new one at https://moneyfeel.it/conto-iscrizione/")
except MRIRateLimitError as e:
    print(f"Rate limited — retry after {e.retry_after}s")
    time.sleep(e.retry_after)

Data Coverage

• Regions: GLOBAL · US · EU · ASIA · EM
• Timeframes: DAILY · WEEKLY · MONTHLY
• History: 2007-01-04 to present
• Updated: daily at market close

Rate Limits

Links

• 🌐 moneyfeel.it
• 📊 Live Dashboard
• 📖 API Documentation
• 🔑 Get API Key

License

CC BY-NC 4.0 — free for research and non-commercial use.