개발자
인증이 필요 없는 무료 공개 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
특정 지표의 시계열 데이터를 가져옵니다. 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`를 붙이세요.