Pools Reserves Overview

​

Overview

​

Endpoint Matrix

​

Parameter Conventions

​

Usage Guidance

• Join with pools metadata — Link reserve snapshots to pool metadata via pool_uid for complete context
• Time-series analysis — Reserve data is optimized for chronological queries; use block/time ranges for historical analysis
• Filter by exchange — Use exchange_ids to focus on specific DEX protocols (Uniswap, Curve, etc.)
• Concentrated liquidity — Use /v1/evm/reserves/liquidity-distribution for per-tick breakdown with a configurable price window (1–10%)
• Decimals-adjusted amounts — Enable include_adjusted_amounts (off by default) to receive human-readable token amounts alongside raw base-unit values; it adds a decimals lookup, so opt in only when you need the scaled values
• Cache recent snapshots — Latest reserve states change frequently; cache with short TTL (1–5 minutes)

​

Reserve Data Models

• reserves: Array of raw token balances (base units)
• reserves_decimals_adjusted: Same values divided by each token’s decimals (e.g. / 10^18 for ETH)
• current_tick: null
• current_sqrt_price: null

• reserves: null (reserves are distributed across ticks)
• current_tick: Active tick position
• current_sqrt_price: Q64.96 sqrt price
• For per-tick distribution → use /v1/evm/reserves/liquidity-distribution

• current_bin: Active bin identifier

​

Common Patterns

{
  "chain_id": 1,
  "pool_uids": [
    "00000000000000000000000088e6a0c2ddd26feeb64f039a2c41296fcb3f5640"
  ],
  "from_timestamp": "2025-01-01T00:00:00Z",
  "to_timestamp": "2025-01-31T23:59:59Z",
  "include_adjusted_amounts": true
}

{
  "chain_id": 1,
  "pool_type_ids": [201],
  "from_block": 18000000,
  "to_block": 18001000,
  "include_adjusted_amounts": false
}

{
  "chain_id": 1,
  "pool_uid": "00000000000000000000000088e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  "from_block": 20000000,
  "to_block": 20001000,
  "price_window_percent": 5.0,
  "include_adjusted_amounts": true
}

​

Dataset Relationships

• Pools → Reserves: Join pool metadata to reserve snapshots using pool_uid
• Reserves → Swap Fees: Combine swap-fee time-series with reserve state for pool economics
• Swap Fees → Yields: Yield predictions are derived from swap fees and current reserves
• Reserves → Prices: Reserve changes drive pricing calculations in L1/L2/L3 layers
• Reserves → Transactions: Reserve snapshots link to transaction logs via _parent_tracing_ids

​

See Also

• POST /v1/evm/reserves — Reserve snapshots with decimals-adjusted amounts
• POST /v1/evm/reserves/liquidity-distribution — Per-tick liquidity distribution
• POST /evm/swaps/fees — Per-swap fee accounting
• POST /evm/yields — Yield/ROI predictions
• POST /evm/entities/pools — Pool metadata registry
• Pool Type — AMM pool classifications
• Digital Exchange — DEX protocol identifiers
• Pricing Suite Overview — Price data derived from reserves