開発者向け
認証不要の無料パブリックAPIです。Cache-Controlヘッダー付きのJSONを返します。個人プロジェクト、リサーチ、コンテンツ制作にご利用いただけます。
現在の流動性スコアの状態を取得します。複合スコア、モメンタム、信頼度、主要ドライバーを含みます。
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
リクイディティ・レンズの現在のスナップショットを取得します。量・価格・構造という3つの独立した軸それぞれに状態とサブ指標があり、さらに構造的スタンス×戦術的パルスのマトリクスセルも含みます。/api/regime とは別の製品で、単一スコアには統合されません。
curl "https://dollarliquidity.com/api/lens?lang=en"{
"quantity": {
"stance": "contracting",
"flow": -0.18,
"dial": 41,
"bufferPct": 11.2,
"bufferState": "thin",
"srfNonZeroShare90d": 0.03,
"realized": false,
"dataAsOf": "2026-08-26"
},
"price": {
"pathSpreadBps": 24,
"pathPricing": "neutral",
"realYieldPct": 1.92,
"realYieldTrendPp": 0.14,
"realYieldTrend": "rising",
"termPremiumPct": 0.34,
"termPremiumLevel": "normal",
"termPremiumTrendPp": -0.02,
"termPremiumTrend": "flat",
"curveContextBps": 48,
"dataAsOf": "2026-08-26"
},
"structure": {
"tgaFlow": 0.09,
"fiscalPulse": "draining",
"rrpBalanceB": 142.0,
"rrpBufferState": "depleted",
"billsShareContext": { "levelPct": 21.4, "direction6m": "rising" },
"fundingOverride": 0.12,
"dominantFundingLeg": null,
"cpTbillTiering": { "spreadBps": 14, "state": "normal", "trendBps": 2, "direction": "flat" },
"hyIgTiering": { "spreadBps": 118, "state": "normal", "trendBps": -3, "direction": "narrowing" },
"bankCashTiering": { "gapPp": 1.7, "state": "compressed", "trendPp": -0.5, "direction": "narrowing" },
"dataAsOf": "2026-08-26"
},
"synthesis": {
"cell": { "posture": "tightening", "pulse": "draining" },
"narrative": "…",
"dataAsOf": "2026-08-26"
},
"dataAsOf": "2026-08-26",
"updatedAt": "2026-08-27T06:00:11.203Z"
}オプションの ?lang=（en/zh/zh-Hant/ja/ko/es/fr/de、デフォルト en）は synthesis.narrative の言語のみを選びます——他のフィールドはすべて言語に依存しません。各フィールドは、対象の系列がまだウォームアップしていない場合は正直に null を返し、架空の中立値で埋めることはありません。
Cache-Control: public, s-maxage=21600, stale-while-revalidate=86400
特定指標の時系列データを取得します。z-score、パーセンタイル、メタデータを含みます。
tga, fed-balance-sheet, onrrp, vix, hy-spread, real-yield-10y, dollar-index, sofr-iorb, srf, bank-cash-buffer, net-liquidity, m2
| パラメータ | 型 | 説明 |
|---|---|---|
days | number | 日数（デフォルト365、最大4000） |
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] です。
流動性スコアとリスク資産（BTC、SPX、QQQ、GOLD）との間のローリング相関、リード・ラグ分析、スコアのバックテストデータを取得します。
curl https://dollarliquidity.com/api/correlationCache-Control: public, s-maxage=900, stale-while-revalidate=1800
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']})")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` を付けてください。