TVL Overview

​

Overview

​

Endpoint Matrix

​

Parameter Conventions

​

Usage Guidance

• Pool ranking — Use TVL to rank pools by liquidity depth
• Liquidity migration — Track TVL changes over time to identify liquidity flows
• Protocol health — Monitor aggregate TVL across pools for protocol-level metrics
• Risk assessment — Filter pools by minimum TVL for routing and execution quality
• Dashboards — Build TVL charts and leaderboards with full provenance

​

TVL Calculation

tvl_usd = sum(token_amounts[i] x fiat_price[i])

• token_amounts[i] is the decimals-adjusted reserve amount for token i
• fiat_price[i] is the USD price for token i at the snapshot time

​

Common Patterns

{
  "chain_id": 1,
  "from_timestamp": "2025-12-01T00:00:00Z",
  "to_timestamp": "2025-12-20T00:00:00Z",
  "min_tvl_usd": 1000000
}

{
  "chain_id": 1,
  "pool_uids": [
    "00000000000000000000000088e6a0c2ddd26feeb64f039a2c41296fcb3f5640"
  ],
  "from_block": 19000000,
  "to_block": 19100000
}

​

Dataset Relationships

• Reserves → TVL: Reserve snapshots provide token amounts for TVL calculation
• Prices → TVL: Fiat prices provide USD conversion for TVL
• Pools → TVL: Join pool metadata to TVL snapshots using pool_uid
• TVL → Yields: TVL can be used alongside yields for liquidity-adjusted ROI analysis

​

See Also

• POST /evm/tvl — TVL snapshots endpoint
• POST /evm/reserves — Pool reserves (input to TVL)
• POST /evm/entities/pools — Pool metadata registry
• POST /evm/yields — Yield predictions
• Pool Type — AMM pool classifications