Liquidity Score Changelog
Full version history of Liquidity Score methodology decisions, from v1.0 to v4.0.
Jump to Version
LatestLatest Version
Log-scale volume, cross-chain removal, durability rebalance
Volume activity switched from linear to log-scale. Cross-chain component removed and weight redistributed to TVL depth and pool quality. Durability sub-weights rebalanced: locked liquidity removed, organic fraction reduced to 15% with sqrt curve, history-measured signals raised to 85%.
Impact Snapshot
- Volume activity now uses log-scale (33.3*log10(V/T/0.005)) — median score rises from 5 to ~35
- Cross-chain component removed; TVL Depth raised to 35%, Pool Quality to 22.5%
- Durability: organic 15% (sqrt curve), TVL stability 35%, volume consistency 25%, maturity 25%
- Locked liquidity sub-component removed from durability (no reliable data source)
v4.0Mar 10, 2026Log-scale volume, cross-chain removal, durability rebalance
Volume activity switched from linear to log-scale. Cross-chain component removed and weight redistributed to TVL depth and pool quality. Durability sub-weights rebalanced: locked liquidity removed, organic fraction reduced to 15% with sqrt curve, history-measured signals raised to 85%.
- Volume activity now uses log-scale (33.3*log10(V/T/0.005)) — median score rises from 5 to ~35
- Cross-chain component removed; TVL Depth raised to 35%, Pool Quality to 22.5%
- Durability: organic 15% (sqrt curve), TVL stability 35%, volume consistency 25%, maturity 25%
- Locked liquidity sub-component removed from durability (no reliable data source)
DetailsHide details
Log-scale volume, cross-chain removal, durability rebalance
Volume activity switched from linear to log-scale. Cross-chain component removed and weight redistributed to TVL depth and pool quality. Durability sub-weights rebalanced: locked liquidity removed, organic fraction reduced to 15% with sqrt curve, history-measured signals raised to 85%.
- Volume activity now uses log-scale (33.3*log10(V/T/0.005)) — median score rises from 5 to ~35
- Cross-chain component removed; TVL Depth raised to 35%, Pool Quality to 22.5%
- Durability: organic 15% (sqrt curve), TVL stability 35%, volume consistency 25%, maturity 25%
- Locked liquidity sub-component removed from durability (no reliable data source)
Impact Notes
- Volume activity now uses log-scale (33.3*log10(V/T/0.005)) — median score rises from 5 to ~35
- Cross-chain component removed; TVL Depth raised to 35%, Pool Quality to 22.5%
- Durability: organic 15% (sqrt curve), TVL stability 35%, volume consistency 25%, maturity 25%
- Locked liquidity sub-component removed from durability (no reliable data source)
v3.4Mar 9, 2026Retained-pool score recomputation and trusted staged-price hardening
Liquidity scoring now rebuilds every aggregate from the retained pool set after filtering/caps, while staged discovery preserves pool-quality metadata and stricter DEX-price trust rules.
- Filtered or TVL-capped pools can no longer keep influencing score inputs through stale aggregate fields
- HHI now uses the full retained pool set before display truncation; global 7d volume is pool-deduped
- Staged pool merge now dedups against token-pair fingerprints and preserves raw DEX metadata/quality multipliers
- DEX price observations require a consistent $50K post-confidence TVL floor across source families
DetailsHide details
Retained-pool score recomputation and trusted staged-price hardening
Liquidity scoring now rebuilds every aggregate from the retained pool set after filtering/caps, while staged discovery preserves pool-quality metadata and stricter DEX-price trust rules.
- Filtered or TVL-capped pools can no longer keep influencing score inputs through stale aggregate fields
- HHI now uses the full retained pool set before display truncation; global 7d volume is pool-deduped
- Staged pool merge now dedups against token-pair fingerprints and preserves raw DEX metadata/quality multipliers
- DEX price observations require a consistent $50K post-confidence TVL floor across source families
Impact Notes
- Filtered or TVL-capped pools can no longer keep influencing score inputs through stale aggregate fields
- HHI now uses the full retained pool set before display truncation; global 7d volume is pool-deduped
- Staged pool merge now dedups against token-pair fingerprints and preserves raw DEX metadata/quality multipliers
- DEX price observations require a consistent $50K post-confidence TVL floor across source families
v3.3Mar 9, 2026Separated discovery pipeline with staged pool confidence decay
Discovery sources (CG Onchain, GeckoTerminal, DexScreener, CG Tickers) now run on an independent 20-minute cron with 3x more budget. Staged pools merged into scoring with freshness confidence decay and explicit defaults contract.
- Discovery cron runs independently on 20-min trigger with ~15 min budget (was 5 min shared)
- Staged pools receive confidence decay: max(0.5, 1 - ageHours/48), excluded after 24h
- Chain-aware source routing reduces wasted API calls by skipping irrelevant chains
- Tiered priority with exponential backoff prevents looping on pool-less coins
DetailsHide details
Separated discovery pipeline with staged pool confidence decay
Discovery sources (CG Onchain, GeckoTerminal, DexScreener, CG Tickers) now run on an independent 20-minute cron with 3x more budget. Staged pools merged into scoring with freshness confidence decay and explicit defaults contract.
- Discovery cron runs independently on 20-min trigger with ~15 min budget (was 5 min shared)
- Staged pools receive confidence decay: max(0.5, 1 - ageHours/48), excluded after 24h
- Chain-aware source routing reduces wasted API calls by skipping irrelevant chains
- Tiered priority with exponential backoff prevents looping on pool-less coins
Impact Notes
- Discovery cron runs independently on 20-min trigger with ~15 min budget (was 5 min shared)
- Staged pools receive confidence decay: max(0.5, 1 - ageHours/48), excluded after 24h
- Chain-aware source routing reduces wasted API calls by skipping irrelevant chains
- Tiered priority with exponential backoff prevents looping on pool-less coins
v3.2Mar 2, 2026ReconstructedEffective TVL symbol-fallback inflation fix
Corrected effective TVL inflation when symbol fallback matched non-Curve pools to Curve entries.
- Metapool-adjusted TVL now applies only to address-matched Curve pools
- Symbol-fallback pools keep their own TVL in effective TVL calculations
- Removes accidental score inflation from cross-pool symbol collisions
DetailsHide details
Effective TVL symbol-fallback inflation fix
Corrected effective TVL inflation when symbol fallback matched non-Curve pools to Curve entries.
- Metapool-adjusted TVL now applies only to address-matched Curve pools
- Symbol-fallback pools keep their own TVL in effective TVL calculations
- Removes accidental score inflation from cross-pool symbol collisions
Impact Notes
- Metapool-adjusted TVL now applies only to address-matched Curve pools
- Symbol-fallback pools keep their own TVL in effective TVL calculations
- Removes accidental score inflation from cross-pool symbol collisions
- 71cc096
v3.1Feb 28, 2026ReconstructedAnti-duplication and protocol TVL cap normalization
Introduced fingerprint-based deduplication and DeFiLlama-anchored cap logic to suppress inflated secondary-source TVLs.
- CG/GT/DS pools deduped against DeFiLlama using token-pair fingerprints
- Secondary-source pool TVL capped and proportionally scaled by protocol-level DeFiLlama ceilings
- Global protocol and chain TVL totals kept consistent after cap reductions
DetailsHide details
Anti-duplication and protocol TVL cap normalization
Introduced fingerprint-based deduplication and DeFiLlama-anchored cap logic to suppress inflated secondary-source TVLs.
- CG/GT/DS pools deduped against DeFiLlama using token-pair fingerprints
- Secondary-source pool TVL capped and proportionally scaled by protocol-level DeFiLlama ceilings
- Global protocol and chain TVL totals kept consistent after cap reductions
Impact Notes
- CG/GT/DS pools deduped against DeFiLlama using token-pair fingerprints
- Secondary-source pool TVL capped and proportionally scaled by protocol-level DeFiLlama ceilings
- Global protocol and chain TVL totals kept consistent after cap reductions
- 0b6bfb8
- 617ab25
- 1224015
- 0e54c20
v3.0Feb 28, 2026ReconstructedCoverage expansion with fallback sources
Expanded zero-pool recovery with DexScreener and CoinGecko tickers fallbacks for orderbook-heavy assets.
- DexScreener fallback adds pools for tracked coins still missing after primary crawl
- CoinGecko tickers fallback synthesizes orderbook liquidity where AMM coverage is absent
- Reduces false zero-liquidity outcomes for long-tail and niche assets
DetailsHide details
Coverage expansion with fallback sources
Expanded zero-pool recovery with DexScreener and CoinGecko tickers fallbacks for orderbook-heavy assets.
- DexScreener fallback adds pools for tracked coins still missing after primary crawl
- CoinGecko tickers fallback synthesizes orderbook liquidity where AMM coverage is absent
- Reduces false zero-liquidity outcomes for long-tail and niche assets
Impact Notes
- DexScreener fallback adds pools for tracked coins still missing after primary crawl
- CoinGecko tickers fallback synthesizes orderbook liquidity where AMM coverage is absent
- Reduces false zero-liquidity outcomes for long-tail and niche assets
- 6b2e006
- ef9bb2b
v2.2Feb 27, 2026ReconstructedNo-pool rows moved to NR semantics
Coins without DEX pools switched from score=0 placeholders to NULL (NR) semantics.
- No-liquidity rows now persist liquidity_score as NULL instead of 0
- Daily history placeholders for no-pool coins also use NULL scores
- Downstream consumers can distinguish not-rated from genuinely low-liquidity assets
DetailsHide details
No-pool rows moved to NR semantics
Coins without DEX pools switched from score=0 placeholders to NULL (NR) semantics.
- No-liquidity rows now persist liquidity_score as NULL instead of 0
- Daily history placeholders for no-pool coins also use NULL scores
- Downstream consumers can distinguish not-rated from genuinely low-liquidity assets
Impact Notes
- No-liquidity rows now persist liquidity_score as NULL instead of 0
- Daily history placeholders for no-pool coins also use NULL scores
- Downstream consumers can distinguish not-rated from genuinely low-liquidity assets
- 06c6681
v2.1Feb 25, 2026ReconstructedOnchain source upgrade and locked-liquidity durability term
Primary pool discovery moved to CoinGecko Onchain with locked-liquidity data integrated into durability scoring.
- CG Onchain became primary source (with GT fallback) for richer pool metadata
- Durability weights changed from 40/25/20/15 to 35/25/20/15/5
- Locked liquidity added as an explicit durability sub-component
DetailsHide details
Onchain source upgrade and locked-liquidity durability term
Primary pool discovery moved to CoinGecko Onchain with locked-liquidity data integrated into durability scoring.
- CG Onchain became primary source (with GT fallback) for richer pool metadata
- Durability weights changed from 40/25/20/15 to 35/25/20/15/5
- Locked liquidity added as an explicit durability sub-component
Impact Notes
- CG Onchain became primary source (with GT fallback) for richer pool metadata
- Durability weights changed from 40/25/20/15 to 35/25/20/15/5
- Locked liquidity added as an explicit durability sub-component
- 361e240
- 4f6d9ed
v2.0Feb 19, 2026ReconstructedSix-component v2 liquidity model
Moved from a five-component heuristic to a six-component model with effective TVL and durability decomposition.
- Weights changed from 35/25/20/10/10 to 30/20/20/15/7.5/7.5
- TVL depth switched to effective TVL, not raw TVL only
- Durability and per-component score breakdown persisted in D1
DetailsHide details
Six-component v2 liquidity model
Moved from a five-component heuristic to a six-component model with effective TVL and durability decomposition.
- Weights changed from 35/25/20/10/10 to 30/20/20/15/7.5/7.5
- TVL depth switched to effective TVL, not raw TVL only
- Durability and per-component score breakdown persisted in D1
Impact Notes
- Weights changed from 35/25/20/10/10 to 30/20/20/15/7.5/7.5
- TVL depth switched to effective TVL, not raw TVL only
- Durability and per-component score breakdown persisted in D1
- 0254445
v1.0Feb 19, 2026ReconstructedInitial DEX liquidity score release
Launched baseline DEX liquidity scoring, API surface, and dashboard integration.
- Initial five-component composite (TVL depth, volume, pool quality, diversity, cross-chain)
- DeFiLlama-driven pool aggregation and top-pool persistence introduced
- Liquidity map endpoint and page-level leaderboard shipped
DetailsHide details
Initial DEX liquidity score release
Launched baseline DEX liquidity scoring, API surface, and dashboard integration.
- Initial five-component composite (TVL depth, volume, pool quality, diversity, cross-chain)
- DeFiLlama-driven pool aggregation and top-pool persistence introduced
- Liquidity map endpoint and page-level leaderboard shipped
Impact Notes
- Initial five-component composite (TVL depth, volume, pool quality, diversity, cross-chain)
- DeFiLlama-driven pool aggregation and top-pool persistence introduced
- Liquidity map endpoint and page-level leaderboard shipped
- a7ae273
- 443ac1b
- f26fdf3