开发者
免费公开 API，无需认证。返回 JSON 格式数据，含 Cache-Control 缓存头。适用于个人项目、研究和内容创作。
获取当前流动性评分状态，包含综合评分、动量、置信度和关键驱动因素。
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
获取某个指标的时间序列数据，包含 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`);