Standardized financial metrics for crypto protocols — revenue, fees, earnings, TVL, treasury, token incentives, and project-level fundamentals via REST API.
- 01protocol revenue and earnings
- 02fee and TVL time series
- 03fundamentals dashboards
- 04comparative sector analysis
- 05LLM-friendly Breakdown endpoints
| Variable | Scope | Description |
|---|---|---|
| TOKEN_TERMINAL_API_KEY | Server | Token Terminal API key from tokenterminal.com billing page. Server-only. |
Use Token Terminal's REST API for protocol fundamentals. Base URL `https://api.tokenterminal.com/v2`, authenticate with `Authorization: Bearer $TOKEN_TERMINAL_API_KEY`. Core endpoints: `GET /projects` to enumerate protocols, `GET /projects/{id}/metrics` for time-series of revenue/fees/earnings, `GET /metrics` for the metric catalog, and the new `GET /projects/{id}/breakdowns/{metric}` endpoints which return LLM-ready tabular slices. Cache responses — fundamentals only update daily.
- ⚑API access requires the API plan — the free web tier does not include programmatic access.
- ⚑Rate limit is 1000 requests/minute per key; bursts past it return 429.
- ⚑Most metrics refresh on a daily cadence (some weekly) — polling more often than once an hour wastes quota with zero new data.
- ⚑Project IDs are slugs (e.g. `aave`, `uniswap`) — they can change on rebrands; always fetch `/projects` and resolve by canonical id rather than hardcoding.
- ⚑Definitions of "revenue" and "earnings" follow Token Terminal's accounting model, which differs from raw protocol fee feeds — read the metric definitions before comparing across providers.