DollarLiquidity API ドキュメント

GET /api/regime

現在の流動性スコアの状態を取得します。複合スコア、モメンタム、信頼度、主要ドライバーを含みます。

リクエスト例

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

レスポンス例

{
  "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 が0-100のヘッドライン値です（80以上で引き締め、20以下で緩和）。compositeScore は旧仕様互換の [-1,+1] 形式です。coverage は実際にスコアへ算入されたグループ数・指標数を示します。dataAsOf はスコアが反映している最新データ日付であり、updatedAt は再計算のタイムスタンプにすぎず、データの鮮度を示すものではありません。

キャッシュ

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

GET /api/series/{id}

特定指標の時系列データを取得します。z-score、パーセンタイル、メタデータを含みます。

利用可能な指標ID

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

クエリパラメータ

リクエスト例

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

レスポンス例

{
  "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 は日付の昇順です——data[0] が最も古い点で、最新値は data[data.length − 1] です。

GET /api/correlation

流動性スコアとリスク資産（BTC、SPX、QQQ、GOLD）との間のローリング相関、リード・ラグ分析、スコアのバックテストデータを取得します。

リクエスト例

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

キャッシュ

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

コード例

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`);

エラー

エラーはすべて同じ形式のJSONです: `{ "error": { "code", "message", "hint", "docs" }, "status" }`。`code` は安定した機械可読の識別子（例: `unknown_series`、`endpoint_not_found`）、`hint` は次に取るべき対応を示します。未知の `/api/*` パスも同じ形式で404を返し、HTMLページは返しません。

{
  "error": {
    "code": "unknown_series",
    "message": "Unknown series id "foo".",
    "hint": "Valid ids: tga, fed-balance-sheet, … GET https://dollarliquidity.com/api lists every endpoint.",
    "docs": "https://dollarliquidity.com/en/api-docs"
  },
  "status": 404
}

ディスカバリー

エンドポイント一覧は `/api`。OpenAPI 3.1 は `/openapi.json`（別名 `/.well-known/openapi.json`）、RFC 9727 APIカタログは `/.well-known/api-catalog`、サイト索引は `/llms.txt`。各ページはMarkdownでも取得できます: `Accept: text/markdown` を送るか、パス末尾に `.md` を付けてください。

• https://dollarliquidity.com/api
• https://dollarliquidity.com/openapi.json
• https://dollarliquidity.com/.well-known/api-catalog
• https://dollarliquidity.com/llms.txt

利用上の注意

• APIキーや認証は不要です
• データは6時間ごとに更新されます
• 節度あるご利用をお願いします——毎分60リクエストを超えないようにしてください
• 個人プロジェクト、リサーチ、教育目的にご利用いただけます
• 商用利用やより高いレート上限が必要な場合は hello@dollarliquidity.com までご連絡ください