Macroeconomic Indicators Dashboard

📊 A static dashboard that tracks key macroeconomic indicators relevant to crypto markets.
Data updates daily via GitHub Actions and is visualized with Chart.js.

🌐 Live site: https://space-lumps.github.io/macro-financial-indicators/

---

Features

• Automated data fetches from FRED.
• Daily updates committed by GitHub Actions.
• Visualizations built with Chart.js on a static GitHub Pages site.
• Per-chart captions explaining macro relevance to crypto.
• Clean dark theme, mobile-friendly layout.

---

Charts Included

• M2 Money Stock (M2SL)
  Rising/falling liquidity as a tailwind/headwind for BTC.

• USD Broad Index (DTWEXBGS)
  Inverse relationship: weaker USD → stronger BTC.

• 2-Year and 10-Year Treasury Yields (DGS2, DGS10)
  Proxy for Fed policy and growth/inflation outlook.

• 10Y–2Y Spread (T10Y2Y)
  Curve inversion as a recession/slowdown signal.

• VIX (VIXCLS)
  Equity volatility → stress indicator for risk assets.

---

Future Integration

This macro dashboard is the first component of a larger analytics project.

• On-chain Dashboard (Dune): DeFi indicators such as stablecoin supply, DEX volume, and funding/open interest will be queried and visualized in Dune.
• Combined Streamlit App: The macro indicators from this repo will be integrated with DeFi/on-chain data into a single interactive Streamlit application.
• Goal: Provide a holistic view of how macroeconomic conditions (liquidity, rates, USD strength, volatility) interact with crypto-native flows (stablecoins, exchanges, L2 activity) to shape market behavior.

Flow: FRED → GitHub Actions → JSON → GitHub Pages (Macro) + Dune (DeFi) → Streamlit (combined app)

---

Tech Stack

• Frontend: HTML, CSS, JavaScript, Chart.js
• Automation: GitHub Actions
• Data Sources: FRED (St. Louis Fed)

---

Local Development

Clone the repo and open index.html in a browser:

git clone https://github.com/space-lumps/macro-financial-indicators.git
cd macro-dash
open index.html   # or double-click in Finder/Explorer

To run the ETL script (etl/fetch_data.py) locally and regenerate JSON data files:

1. Get your own free FRED API key: https://fred.stlouisfed.org/docs/api/api_key.html

2. Set it as a local environment variable (temporary for the session): MacOS/Linux:

export FRED_API_KEY=your_actual_key_here

or (Windows CMD):

set FRED_API_KEY=your_actual_key_here

3. Install dependencies:

pip install -r requirements.txt

4. Run the script:

python etl/fetch_data.py

Note: The GitHub Actions workflow uses a repository secret (FRED_API_KEY) for automated daily updates — the key is never exposed in code. For local runs, you must supply your own key via environment variable.

---

Note on Repository Rename

This repo was previously named macro-dash.

• GitHub auto-redirects the old repo URL, clone commands, stars, etc., to the current name.
• The GitHub Pages site URL is updated to match the new repo name (old Pages URL no longer works).
• Old clone URLs continue to work seamlessly.

---

License

MIT License Copyright (c) 2025-2026 Corin Stedman

This project is licensed under the MIT License - see the LICENSE file for details.