CryptoETF — Python SDK for spot crypto ETF flows

The official client for the CryptoETF API: daily net flows of every US-listed spot crypto ETF, fund by fund, plus fund AUM, the CEFI sentiment index and coin prices. Data by cryptoetf.today.

Sixteen assets: BTC, ETH, SOL, XRP, HYPE, DOGE, LINK, AVAX, HBAR, LTC, BNB, DOT, SUI, NEAR, TRX, ZEC. Zero dependencies (standard library only), typed, Python 3.9+.

Install

pip install cryptoetf

Get an API key

Sign in at cryptoetf.today and create a key in Profile → For developers. It is free.

Quick start

from cryptoetf import CryptoETF

etf = CryptoETF(api_key="...")  # or set CRYPTOETF_API_KEY

# Latest daily net flow for every asset, US$ millions
for a in etf.flows.summary()["assets"]:
    print(a["symbol"], a["date"], a["netFlowUsdM"])

# Bitcoin ETFs fund by fund
btc = etf.flows.funds("btc")
last_day = btc["days"][-1]
print([(f["ticker"], f["netFlowUsdM"]) for f in last_day["funds"]])

Responses are plain dicts with the same field names as the API, so they drop straight into pandas:

import pandas as pd

df = pd.DataFrame(etf.flows.asset("eth")["days"])

Methods

asset is a code such as btc, eth, sol, hype or a full name such as bitcoin. All values are net US$ millions: positive = inflow, negative = outflow. Full field reference: docs.cryptoetf.today.

Errors and limits

Every failed call raises CryptoETFError with status, an optional code and, on HTTP 429, retry_after in seconds:

from cryptoetf import CryptoETFError

try:
    etf.prices()
except CryptoETFError as e:
    if e.status == 429:
        print(f"rate limited, retry in {e.retry_after}s")

• Rate limit: 120 requests per minute per key. The latest limit headers are available as etf.rate_limit.
• History: the free tier covers the last 30 days. Full history will be available on a paid plan.
• Freshness: a trading day appears the next morning (UTC), before the US open. The newest day can be revised once later that day. SUI funds arrive a day later.

Options

CryptoETF(
    api_key="...",          # default: CRYPTOETF_API_KEY
    timeout=15.0,           # seconds per request
    base_url="https://api.cryptoetf.today/api/v1",
)

Related

• TypeScript SDK: cryptoetf
• No-code access for AI agents: the hosted MCP server at https://mcp.cryptoetf.today/api/mcp
• Embeddable widgets: cryptoetf.today/en/crypto-etf-widgets

Not investment advice. MIT licensed.