API-Dokumentation

GET /api/regime

Rufen Sie den aktuellen Stand des Liquiditätsscores ab, inklusive Kompositwert, Momentum, Konfidenz und Haupttreibern.

Beispielanfrage

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

Beispielantwort

{
  "status": "neutral",
  "momentum": "stable",
  "confidence": "high",
  "compositeScore": 0.29,
  "previousScore": 0.29,
  "percentile5y": 42,
  "coverage": { "groups": 4, "totalGroups": 4, "indicators": 9, "totalIndicators": 10 },
  "dataAsOf": "2026-05-20",
  "drivers": [
    {
      "indicatorId": "tga",
      "weight": 0.325,
      "zScore": 1.1,
      "contribution": 0.239,
      "direction": "tightening"
    }
  ],
  "updatedAt": "2026-05-22T15:33:33.647Z"
}

percentile5y ist der 0-100-Hauptwert (≥80 angespannt, ≤20 reichlich); compositeScore ist die alte Form in [-1,+1]. coverage gibt an, wie viele Gruppen und Indikatoren den Wert tatsächlich gespeist haben. dataAsOf ist das Datum der jüngsten Daten, die der Wert abbildet — updatedAt ist nur der Zeitstempel der Neuberechnung, kein Signal für die Datenaktualität.

Caching

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

GET /api/series/{id}

Rufen Sie die Zeitreihe eines bestimmten Indikators ab, samt z-Werten, Perzentilen und Metadaten.

Verfügbare Indikator-IDs

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

Abfrageparameter

Beispielanfrage

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

Beispielantwort

{
  "data": [
    { "date": "2026-04-20", "value": 1038.0, "zScore": 1.71 },
    { "date": "2026-05-20", "value": 782.0, "zScore": 0.98 }
  ],
  "meta": {
    "lastAvailableDate": "2026-05-20",
    "zScoreMean": 441.14,
    "zScoreStd": 349.53,
    "percentile": 73,
    "source": "fresh"
  }
}

data ist aufsteigend nach Datum sortiert: data[0] ist der älteste Punkt, der neueste Wert steht in data[data.length − 1].

GET /api/correlation

Rufen Sie rollierende Korrelationen, Lead-Lag-Analysen und Backtest-Daten zwischen dem Liquiditätsscore und Risikoanlagen (BTC, SPX, QQQ, GOLD) ab.

Beispielanfrage

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

Caching

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

Codebeispiele

Python

import requests

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

tga = requests.get("https://dollarliquidity.com/api/series/tga?days=30").json()
latest = tga["data"][-1]  # data is ascending — the last element is newest
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(`Status: ${regime.status}, Score: P${regime.percentile5y}/100`);

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

const latest = tga.data[tga.data.length - 1]; // ascending — last is newest
console.log(`TGA: ${latest.value}B`);

Nutzungshinweise

• Kein API-Schlüssel und keine Authentifizierung erforderlich
• Die Daten werden alle 6 Stunden aktualisiert
• Bitte verantwortungsvoll nutzen — vermeiden Sie mehr als 60 Anfragen pro Minute
• Geeignet für private Projekte, Forschung und Bildungszwecke
• Für kommerzielle Nutzung oder höhere Limits schreiben Sie an [email protected]