analyze-us-bank-credit-deposit-decoupling

最快的方式：使用 FRED 公開 CSV（無需 API Key）

Step 1：安裝依賴

pip install pandas numpy requests matplotlib

Step 2：執行快速分析

cd scripts
python decoupling_analyzer.py --quick

Step 3：執行完整分析（含視覺化）

python decoupling_analyzer.py \
  --start 2022-06-01 \
  --output ../../output/decoupling_$(date +%Y-%m-%d).json

Step 4：生成視覺化圖表（Bloomberg 風格面積圖）

python visualize_decoupling.py \
  --start 2022-06-01 \
  --output ../../output/credit_deposit_decoupling_$(date +%Y-%m-%d).png

輸出範例：

{
  "period": "2022-06 to 2026-01",
  "cumulative_changes": {
    "loans_billion_usd": 2070.5,
    "deposits_billion_usd": 506.8,
    "gap_billion_usd": 1563.7
  },
  "deposit_dynamics": {
    "max_drawdown_billion_usd": -1200.0,
    "max_drawdown_date": "2023-04-12",
    "recovery_from_trough_billion_usd": 1706.8,
    "recovery_ratio": 1.42
  },
  "assessment": {
    "decoupling_status": "severe",
    "deposit_stress_ratio": 0.755,
    "phase": "recovery_but_lagging"
  }
}