API Documentation

GET /api/regime

Get the current liquidity score status including composite score, momentum, confidence, and key drivers.

Example Request

curl https://dollarliquidity.com/api/regime

Example Response

{
  "status": "risk-on",
  "momentum": "improving",
  "confidence": "high",
  "compositeScore": 0.72,
  "dliTight": -0.72,
  "subScores": [
    { "group": "A", "label": "Policy / Reserves", "score": -0.85, "weight": 0.30 },
    { "group": "B", "label": "Funding / Plumbing", "score": -0.42, "weight": 0.30 },
    { "group": "C", "label": "Credit / Intermediation", "score": -0.91, "weight": 0.20 },
    { "group": "D", "label": "Risk / Price", "score": -0.55, "weight": 0.20 }
  ],
  "momentum7d": -0.12,
  "concentration": 0.68,
  "drivers": [
    {
      "indicatorId": "tga",
      "weight": 0.12,
      "zScore": -1.3,
      "contribution": 0.156,
      "direction": "easing"
    }
  ],
  "updatedAt": "2026-02-09T06:00:00.000Z"
}

Caching

Cache-Control: public, s-maxage=3600, stale-while-revalidate=21600

GET /api/series/{id}

Get time series data for a specific indicator, including z-scores, percentiles, and metadata.

Available Indicator IDs

tga, fed-balance-sheet, onrrp, vix, hy-spread, real-yield-10y, dollar-index, sofr-iorb, srf, bank-cash-buffer, net-liquidity, m2

Query Parameters

Example Request

curl "https://dollarliquidity.com/api/series/tga?days=90"

Example Response

{
  "data": [
    { "date": "2026-02-07", "value": 742.3, "zScore": -0.85 },
    { "date": "2026-02-06", "value": 748.1, "zScore": -0.78 }
  ],
  "meta": {
    "lastAvailableDate": "2026-02-07",
    "percentile": 42,
    "source": "fresh"
  }
}

GET /api/correlation

Get rolling correlations, lead-lag analysis, and score backtest data between the liquidity score and risk assets (BTC, SPX, QQQ, GOLD).

Example Request

curl https://dollarliquidity.com/api/correlation

Caching

Cache-Control: public, s-maxage=900, stale-while-revalidate=1800

Code Examples

Python

import requests

regime = requests.get("https://dollarliquidity.com/api/regime").json()
print(f"Status: {regime['status']}, DLI: {regime['dliTight']}, Score: {regime['compositeScore']}")

tga = requests.get("https://dollarliquidity.com/api/series/tga?days=30").json()
latest = tga["data"][0]
print(f"TGA: {latest['value']}B (z-score: {latest['zScore']})")

JavaScript

const regime = await fetch("https://dollarliquidity.com/api/regime")
  .then(r => r.json());

console.log(`Score: ${regime.status}, DLI: ${regime.dliTight}, Value: ${regime.compositeScore}`);

const tga = await fetch("https://dollarliquidity.com/api/series/tga?days=30")
  .then(r => r.json());

console.log(`TGA: ${tga.data[0].value}B`);

Usage Notes

• No API key or authentication required
• Data refreshes every 6 hours
• Please use responsibly — avoid exceeding 60 requests per minute
• Suitable for personal projects, research, and educational use
• For commercial use or higher rate limits, contact [email protected]