암호화폐 ETF 자금 흐름 API
미국 현물 비트코인, 이더리움, 솔라나, XRP 외 12개 암호화폐 ETF 그룹의 일별 순유입·순유출을 자산별로, 그리고 그 안의 모든 펀드별로 JSON으로 제공합니다. 암호화폐 ETF 심리 지수 CEFI, 코인 가격, 주간 합계도 포함됩니다. 무료 키 하나면 되고 카드는 필요 없습니다.
기본 URL https://api.cryptoetf.today/api/v1curl https://api.cryptoetf.today/api/v1/flows/summary \
-H "Authorization: Bearer $CRYPTOETF_KEY"{
"assets": [
{ "symbol": "BTC", "asset": "bitcoin",
"date": "2026-10-22", "netFlowUsdM": -635.5 },
{ "symbol": "ETH", "asset": "ethereum",
"date": "2026-10-22", "netFlowUsdM": -110.6 },
{ "symbol": "SOL", "asset": "solana",
"date": "2026-10-22", "netFlowUsdM": -8.5 },
… 13개 더 보기
],
"updatedAt": "2026-10-23T21:47:25Z"
}세 단계로 첫 요청 보내기
헤더에 담아 보내기
둘 중 어느 헤더든 됩니다:
Authorization: Bearer <key> X-API-Key: <key>
JSON 읽기
흐름은 순액이며 단위는 백만 달러, 0.1 단위로 반올림됩니다. 양수는 유입입니다. 모든 행에 UTC 날짜가 있고, 시계열은 오래된 순 → 최신 순입니다.
엔드포인트
읽기 전용 GET 엔드포인트 8개. 열어서 실제 응답을 확인하세요.
GET/v1/flows/summary16개 자산 전체의 최신 순흐름을 한 번의 호출로.응답 ▾
{
"assets": [
{ "symbol": "BTC", "asset": "bitcoin",
"date": "2026-10-22", "netFlowUsdM": -635.5 },
{ "symbol": "ETH", "asset": "ethereum",
"date": "2026-10-22", "netFlowUsdM": -110.6 },
{ "symbol": "SOL", "asset": "solana",
"date": "2026-10-22", "netFlowUsdM": -8.5 },
… 13개 더 보기
],
"updatedAt": "2026-10-23T21:47:25Z"
}GET/v1/flows/{asset}한 자산의 일별 순흐름, 최근 30일, 오래된 순 → 최신 순.응답 ▾
{
"symbol": "BTC",
"asset": "bitcoin",
"windowDays": 30,
"days": [
…,
{"date": "2026-10-21", "netFlowUsdM": 510.8},
{"date": "2026-10-22", "netFlowUsdM": -635.5}
],
"updatedAt": "2026-10-23T21:47:25Z"
}GET/v1/flows/{asset}/funds한 자산의 같은 30일을 펀드별로: IBIT, FBTC, ETHA 등.응답 ▾
{
"symbol": "BTC",
"asset": "bitcoin",
"windowDays": 30,
"days": [
…,
{ "date": "2026-10-22", "totalUsdM": -635.5,
"funds": [
{"ticker": "IBIT", "issuer": "BlackRock", "netFlowUsdM": -254.1},
{"ticker": "FBTC", "issuer": "Fidelity", "netFlowUsdM": -217.5},
…
] }
],
"updatedAt": "2026-10-23T21:47:25Z"
}GET/v1/funds모든 펀드의 발행사, 수수료, 상장일과 현재 순자산(AUM), 보유 코인.응답 ▾
{
"assets": [
{"symbol": "BTC", "asset": "bitcoin", "totalNetAssetsUsdM": 105075.3, "date": "2026-10-22", "coinsHeld": 1289201.4613, "coinsDate": "2026-10-22", "supplySharePct": 6.4132}
],
"funds": [
{ "ticker": "IBIT", "name": "iShares Bitcoin Trust ETF",
"issuer": "BlackRock", "sponsorFeePct": 0.25,
"netAssetsUsdM": 66200.9, "coinsHeld": 811138.2604, "netAssetsDate": "2026-10-22", … },
…
],
"updatedAt": "2026-10-23T21:47:25Z"
}GET/v1/index/cefi0–100 Crypto ETF Flow Index인 CEFI, 흐름·추세·확산 구성요소 포함.응답 ▾
{
"index": "CEFI-Composite",
"current": 38,
"date": "2026-10-22",
"components": {"flow": 37, "trend": 42, "breadth": 35},
"windowDays": 30,
"history": [ { "date": "…", "value": … }, … ]
}GET/v1/prices16개 코인 전체의 현물 가격과 24시간 변동률.응답 ▾
{
"prices": [
{ "symbol": "BTC", "priceUsd": …, "change24hPct": … },
…
],
"updatedAt": "…"
}GET/v1/analytics/weekly자산별 7일 합계: 순흐름, 일평균, 유입일과 유출일.응답 ▾
{
"from": "2026-10-17", "to": "2026-10-23",
"assets": [
{"symbol": "BTC", "asset": "bitcoin", "netFlowUsdM": 446.9, "avgDailyUsdM": 111.7, "positiveDays": 3, "negativeDays": 1},
…
]
}GET/v1/tickers추적 중인 16개 자산 목록: 심볼, ID, 이름.응답 ▾
[
{ "symbol": "BTC", "asset": "bitcoin", "name": "Bitcoin" },
{ "symbol": "ETH", "asset": "ethereum", "name": "Ethereum" },
…
]자산별 엔드포인트
미국 현물 암호화폐 ETF 그룹마다 /v1/flows/{asset}에 자체 시계열이 있습니다. 전체 이름도 됩니다: bitcoin, dogecoin, avalanche.
Bitcoin ETF 자금 흐름 API
GET /v1/flows/btc10월 22일 (목)−$635.5MEthereum ETF 자금 흐름 API
GET /v1/flows/eth10월 22일 (목)−$110.6MSolana ETF 자금 흐름 API
GET /v1/flows/sol10월 22일 (목)−$8.5MXRP ETF 자금 흐름 API
GET /v1/flows/xrp10월 22일 (목)+$2.6MHyperliquid ETF 자금 흐름 API
GET /v1/flows/hyp10월 22일 (목)−$7.9MChainlink ETF 자금 흐름 API
GET /v1/flows/link10월 22일 (목)흐름 없음Hedera ETF 자금 흐름 API
GET /v1/flows/hbar10월 22일 (목)+$0.1MAvalanche ETF 자금 흐름 API
GET /v1/flows/avax10월 22일 (목)흐름 없음Dogecoin ETF 자금 흐름 API
GET /v1/flows/doge10월 22일 (목)흐름 없음Litecoin ETF 자금 흐름 API
GET /v1/flows/ltc10월 22일 (목)흐름 없음Sui ETF 자금 흐름 API
GET /v1/flows/sui10월 22일 (목)흐름 없음Polkadot ETF 자금 흐름 API
GET /v1/flows/dot10월 22일 (목)흐름 없음BNB ETF 자금 흐름 API
GET /v1/flows/bnb10월 22일 (목)흐름 없음NEAR ETF 자금 흐름 API
GET /v1/flows/near10월 22일 (목)+$0.5MTron ETF 자금 흐름 API
GET /v1/flows/trx10월 22일 (목)흐름 없음Zcash ETF 자금 흐름 API
GET /v1/flows/zec10월 22일 (목)+$14.2M/v1/flows/summary의 최신 일자, 단위 백만 달러. 각 카드를 누르면 펀드별 표가 있는 해당 자산의 흐름 페이지가 열립니다.
암호화폐 ETF 심리 지수 API
CEFI(Crypto ETF Flow Index)는 시장 전체의 ETF 자금 흐름을 0부터 100까지의 숫자 하나로 나타냅니다. 거래일마다 16개 자산의 모든 현물 ETF 순흐름을 달러로 합산하고, 세 가지 요소를 지난 1년과 비교해 점수를 매깁니다.
흐름이 0이면 50점입니다. 일반적인 유입일은 약 69점, 일반적인 유출일은 약 31점입니다. 종합 지수 하나만 있고 자산별 지수는 없습니다. 응답에는 30일 이력이 포함됩니다.
"current": 38여덟 줄로 그리는 차트
최근 22거래일의 비트코인 ETF 자금 흐름을 /v1/flows/btc 한 번 호출로 그립니다.
import os, requests
import matplotlib.pyplot as plt
r = requests.get("https://api.cryptoetf.today/api/v1/flows/btc",
headers={"X-API-Key": os.environ["CRYPTOETF_KEY"]})
days = [d for d in r.json()["days"] if d["netFlowUsdM"] != 0]
plt.bar([d["date"] for d in days], [d["netFlowUsdM"] for d in days])
plt.show()비트코인, 이더, 솔라나, XRP, Hyperliquid는 주말을 0으로 하여 모든 달력일을 반환하고, 나머지 자산은 거래일만 반환합니다.
개발자들이 만드는 것
대시보드와 차트
가격과 나란히 보는 일별 흐름, 자산별 30일 막대 차트, 시장 전체 합계.
아침 봇
전날 수치가 나오면 미국 장 개장 전에 Telegram, Discord, Slack에 게시.
뉴스레터와 노트
합계, 일평균, 유입·유출일로 정리한 자산별 주간 순위.
AI 에이전트
Claude, Cursor 또는 직접 만든 에이전트가 MCP 서버로 같은 데이터를 읽습니다. 키 불필요.
위젯 임베드
사이트나 블로그를 위한 12가지 위젯: 자금 흐름, 펀드, 순자산, CEFI. 원하는 자산, 하루부터 3개월까지, 라이트 또는 다크. 매일 아침 자동 업데이트되며 키가 필요 없습니다.
데이터 안내
개발에 앞서 수치가 무엇을 뜻하는지 확인하세요.
개발자 리소스
docs.cryptoetf.today모든 엔드포인트, 파라미터, 오류를 직접 호출해 보며 확인.OpenAPI 3 명세 ↗api.cryptoetf.today/v1/openapi.json원하는 언어로 클라이언트 생성.상태 ↗status.cryptoetf.todayREST, MCP, 일일 게시의 현재 상태.MCP 서버mcp.cryptoetf.today/api/mcpAI 어시스턴트용 읽기 전용 도구 12개.TypeScript SDK ↗npm i cryptoetfNode, Deno, Bun, 브라우저용 공식 클라이언트. 타입 지원, 의존성 없음.Python SDK ↗pip install cryptoetfPython 3.9+용 공식 클라이언트. 일반 dict로 바로 pandas에 사용.암호화폐 ETF API — 자주 묻는 질문
키, 한도, 데이터 최신성에 관한 질문. 그 밖의 문의는 — 지원
무료 비트코인 ETF 자금 흐름 API가 있나요?
네. 프로필에서 받은 키로 무료로 사용할 수 있습니다. 카드도 유료 요금제도 필요 없습니다. 비트코인 외 15개 현물 암호화폐 ETF 그룹을 다룹니다.
어떤 자산을 다루나요?
비트코인, 이더리움, 솔라나, XRP, Hyperliquid, 도지코인, 체인링크, 아발란체, 헤데라, 라이트코인, BNB, 폴카닷, Sui, NEAR, 트론, Zcash — 미국에 상장된 모든 현물 암호화폐 ETF 그룹입니다.
API가 IBIT나 FBTC 같은 펀드별 흐름을 반환하나요?
예. /v1/flows/{asset}/funds는 IBIT, FBTC, ETHA 등 한 자산에 속한 모든 펀드의 일별 순흐름을 같은 최근 30일 동안 반환합니다. 더 긴 펀드별 기록은 사이트의 자산 페이지(예: 비트코인 ETF 자금 흐름)에 있습니다.
암호화폐 ETF별 AUM을 조회할 수 있나요?
예. /v1/funds는 모든 현물 암호화폐 ETF의 발행사, 스폰서 수수료, 상장일, 현재 순자산(AUM), 보유 코인과 자산별 합계를 제공합니다. 이는 현재 시점의 스냅숏이며 기록이 아닙니다. Fidelity, Grayscale, Franklin Templeton, Canary, WisdomTree는 코인 단위 보유량을 공개하지 않으므로 해당 펀드의 coinsHeld는 null입니다.
데이터는 얼마나 자주 업데이트되나요?
거래일마다 한 번입니다. 하루치 흐름은 다음 날 아침(UTC), 미국 장 개장 전에 게시됩니다. 최신 일자는 그날 중 한 번 수정될 수 있습니다.
암호화폐 ETF 심리를 제공하는 API가 있나요?
네. /v1/index/cefi가 CEFI를 반환합니다. 모든 현물 암호화폐 ETF의 순흐름으로 만든 0–100 지수로, 흐름·추세·확산 구성요소와 30일 이력이 포함됩니다.
이력은 얼마나 받을 수 있나요?
모든 엔드포인트에서 최근 30일입니다. 더 긴 시계열은 사이트 차트에 있습니다.
요청 한도는 어떻게 되나요?
키당 분당 120회입니다. 한도를 넘으면 API가 Retry-After 헤더와 함께 429를 반환합니다. MCP 서버는 IP당 분당 60회까지 허용하며 키가 필요 없습니다.
OpenAPI 명세가 있나요?
네. OpenAPI 3 명세는 api.cryptoetf.today/v1/openapi.json에 있습니다. 인터랙티브 레퍼런스는 docs.cryptoetf.today에 있습니다.
Claude나 Cursor에서 쓸 수 있나요?
네. MCP 서버 mcp.cryptoetf.today/api/mcp를 통해 쓸 수 있습니다. 키가 필요 없고 같은 수치를 반환합니다.
전날 ETF 자금 흐름을 미국 장 개장 전에.
GET https://api.cryptoetf.today/api/v1/flows/summary