TVL across chains & protocols
Total value locked per protocol and per chain, USD-denominated and captured at block boundaries, for deterministic reads and reproducible series.
On-chain · Fundamentals data API
On-chain TVL, supply, and holders, in one schema.
Total value locked, circulating and total supply, holder counts, and protocol-level metrics across major chains and DeFi protocols. Indexed directly from chain, block-anchored on every record, and delivered through the same credential and JSON schema as the rest of the SiftingIO API.
All products- RESTSnapshot + history
- Block-anchoredReplay-safe
- 99.9%Uptime SLA
- 1 credentialAcross the platform
Capabilities
Fundamentals, decoded into one schema.
Indexed directly from chain. Block-anchored on every record. The same JSON shape across protocols wherever the underlying metric exists, so your client doesn’t grow as coverage does.
Supply & issuance
Circulating, total, and max supply with issuance and burn deltas, normalized across tokens so supply schedules are directly comparable.
Holder distribution
Holder counts and active-address metrics for ownership, concentration, and growth analysis across covered assets.
Protocol-level KPIs
Fees, revenue, and protocol-specific metrics decoded into a uniform shape, so cross-protocol comparison needs no per-protocol glue code.
Block-deterministic
Every record carries block_number and ts. Historical series are reproducible and replay-safe, so research and backtests stay auditable back to the chain.
One credential across the platform
Fundamentals is a separate module, but the same API key authenticates CEX, DEX, and fundamentals. Add a module without rotating credentials.
API · Fundamentals
Snapshots and history over REST.
On-chain fundamentals update on the cadence of blocks and epochs, not ticks, so they’re served as block-anchored snapshots and historical series over REST, authenticated with the same API key as every other product, and addressing assets as chain:ASSET.
GET · latest snapshot
curl -H "X-API-Key: $KEY" \
"https://api.sifting.io/v1/last/fundamentals/eth/AAVE"200 OK · application/json
{
"chain": "eth",
"asset": "AAVE",
"protocol": "aave-v3",
"tvl_usd": "21847391043.55",
"circulating_supply": "15043912.0",
"total_supply": "16000000.0",
"holders": 184223,
"block_number": 22150318,
"t": 1777813200526
}GET · historical series
curl -H "X-API-Key: $KEY" \
"https://api.sifting.io/v1/history/fundamentals/eth/AAVE\
?metric=tvl_usd&from=2026-04-01&interval=1d"200 OK · application/json
{
"chain": "eth",
"asset": "AAVE",
"metric": "tvl_usd",
"interval": "1d",
"points": [
{ "t": 1775347200000, "v": "20431882190.12" },
{ "t": 1775433600000, "v": "20988141552.77" },
{ "t": 1775520000000, "v": "21847391043.55" }
]
}Coverage
Metrics, chains, and protocols covered.
A representative sample of supported metrics, chains, and protocols is shown below. Coverage extends beyond this list and continues to expand as each dataset meets our quality bar. Need a metric or protocol you don’t see? Request it →
Metrics
Per asset & protocol- Total value locked (TVL)
- Circulating supply
- Total & max supply
- Holder counts
- Active addresses
- Protocol fees
- Protocol revenue
- Issuance / burn
- Staking ratio
- Treasury balances
Chains
EVM + Solana- Ethereum
- Arbitrum
- Optimism
- Base
- Polygon
- BNB Chain
- Avalanche
- Solana
Protocol types
DeFi categories- Liquid staking
- Lending & borrowing
- DEX / AMM
- DEX aggregators
- Stablecoins & CDPs
- Yield & derivatives
Built for
Where research and risk teams use fundamentals.
Research & token screening
TVL trends, supply schedules, and holder growth for token research and screening, dropping into Jupyter notebooks and BI pipelines without per-protocol glue code.
Risk & exposure monitoring
Track protocol TVL, treasury balances, and holder concentration to monitor counterparty, liquidity, and concentration risk over time.
Dashboards & analytics
Protocol KPIs and supply metrics for DeFi dashboards and internal analytics, sharing one schema and one credential with live prices and swaps.
Fintech & portfolio apps
Fundamentals alongside live prices to power valuation, discovery, and portfolio features, all under a single credential and unified schema.
FAQ
On-chain fundamentals, frequently asked.
What on-chain fundamentals does the API cover?
Total value locked (TVL), circulating, total, and max supply, issuance and burn deltas, holder counts and active addresses, and protocol-level metrics such as fees and revenue. Metrics are normalized into a uniform JSON shape across tokens and protocols wherever the underlying concept exists. The full live list of metrics and supported assets is published in the API reference; coverage expands as each dataset meets our quality bar.
Which chains and protocols are supported?
Major EVM chains (Ethereum, Arbitrum, Optimism, Base, Polygon, BNB Chain, Avalanche) and Solana, plus the leading DeFi protocols on each. Per-chain and per-protocol availability is queryable through the API reference, and additional datasets are added as each integration is verified end-to-end.
Is fundamentals data delivered over REST or WebSocket?
REST. On-chain fundamentals update on the cadence of blocks, epochs, and indexing cycles rather than tick by tick, so they are served as block-anchored snapshots and historical time series over REST, authenticated with the same API key as every other SiftingIO product.
How fresh is the data, and how often is it updated?
TVL and supply are recomputed at block boundaries on each indexing cycle; holder counts and protocol KPIs refresh on a regular cadence appropriate to each metric. Every record carries ts and block_number, so reads are deterministic and historical series stay reproducible.
Is historical fundamentals data included?
Yes. Historical time series for TVL, supply, holders, and protocol KPIs are included, not gated behind a separate contract. Historical depth typically covers from the point each dataset began indexing, with deterministic timestamps so research and backtests stay reproducible.
Where does the data come from?
Metrics are computed directly from on-chain state and contract logs. We run our own indexers and full nodes across supported chains, with no reliance on third-party aggregators for primary metrics, so figures are auditable back to the chain.
How does Fundamentals relate to the Cryptocurrency (CEX) and DEX modules?
Fundamentals is sold as a separate module from the CEX cryptocurrency and DEX & DeFi modules. The same SiftingIO API key authenticates all of them; your subscription tier determines which modules your key is entitled to. Add a module without rotating credentials or changing client code.
What's the JSON schema for a fundamentals record?
A snapshot returns chain, asset, protocol, tvl_usd, circulating_supply, total_supply, holders, block_number, and t (timestamp). Historical reads return the same identifiers plus a metric, an interval, and a points array of { t, v }. Field names are consistent across assets and protocols where the underlying metric exists.
99.9% SLA · Block-anchored · Same credential
Start building with on-chain fundamentals.
Free tier included, no sales call required. Add the Fundamentals module to your account and hit the on-chain endpoints over REST, with the same auth, same schema, and same SLA as every other product.