Liquidity Score Changelog

Impact Notes

• The SunSwap V2 adapter is score-ineligible and valid profiles retain the activation-pending capability gate while the scoring consumer's memory behavior is remediated and revalidated
• The complete 21-target producer remains enabled so direct-route reliability, identity, reserve, output, and block-bracket evidence continue to accumulate
• Missing, failed, stale, malformed, multi-hop-only, or identity-mismatched routes remain target-level capability gates; no stale proof or manual capacity substitutes for current direct evidence
• SunSwap census rows remain excluded from liquidity scoring, price consensus, direct-source precedence, visible pool selection, and V8 liquidity scoring

Impact Notes

• Activation is limited to the reviewed SunSwap V2 factory, pair runtime, and SUN Smart Router profile on Tron; Raydium CLMM, Orca Whirlpool, and other native cohorts remain shadow-only
• Every accepted profile must prove the exact factory pair, token order, reserves, direct route, 0.3% constant-product output, bounded latest-state block bracket, freshness, and current target identity
• Missing, failed, stale, malformed, multi-hop-only, or identity-mismatched routes remain target-level capability gates; no stale proof or manual capacity substitutes for current direct evidence
• SunSwap census rows remain excluded from liquidity scoring, price consensus, direct-source precedence, visible pool selection, and V8 liquidity scoring

Impact Notes

• Activation is limited to the reviewed Base Aerodrome Slipstream factory and QuoterV2 runtimes; Optimism Uniswap V3, Solana CLMM, SunSwap, Fluid, and other unratified cohorts remain shadow-only
• Every accepted profile must prove the retained pool through the factory's exact token and signed tick-spacing binding and pass independent generation, identity, price, freshness, curve, and retained-TVL validation
• Mature fresh last-known-good profiles can remain in the bounded route-only observation set across a temporary liquidity shortlist rotation without changing aggregate TVL, volume, visible pools, price consensus, target publication, or V8 liquidity scoring
• Missing, stale, price-drifted, malformed, or identity-mismatched profiles remain capability-gated; aggregate liquidity is never substituted as executable depth

Impact Notes

• Only census-confirmed classic Base Aerodrome pools with stable=false are eligible; generic Solidly support and Avalanche, Linea, or Sonic deployments remain out of scope
• Each candidate requires reviewed factory and implementation runtimes, exact factory getPool(token0, token1, false) binding, pool stable=false, and an unpaused factory at one pinned block
• The model uses the pool's same-block dynamic fee; any runtime, identity, pause-state, fee, reserve, or price failure remains capability-gated instead of inheriting executable depth

Impact Notes

• Incomplete paginated authoritative inventories now fail open, while complete PancakeSwap V3 authority remains scoped to concentrated-liquidity rows instead of suppressing V2 pools
• Ethereum Uniswap V2 and BSC PancakeSwap V2 candidates require a pinned canonical factory runtime, exact getPair binding, and same-block token-order, reserve, and decimals reads before becoming score-eligible
• Other V2 forks and any identity, factory, reserve, or price failure remain shaped or capability-gated evidence rather than inheriting executable depth

Impact Notes

• Roughly 460 retained Raydium standard pools (USDC, USDT, USD1 pairs) move from capability-gated rows to exact constant-product execution models with score-eligible reserve-based simulations
• USD1 gains its first score-eligible Solana exit routes; USDC and USDT gain substantially deeper Solana route surfaces
• Counter-asset references derived this way are recorded as referencePriceSource "pool-implied"; token-identity and balance failures still fail closed to incomplete-exact-capture

Impact Notes

• LUSD/3Crv-style metapools no longer treat the 3Crv quote side as an unknown token for effective TVL and pool-stress calculations
• Composite quote aliases continue to flow through the existing balance-health haircut, so one-sided pools remain penalized for imbalance while no longer receiving an additional unknown-token penalty
• The change applies to all configured composite pool aliases rather than special-casing one stablecoin

Impact Notes

• Large malformed rows removed by the retained-pool anti-poisoning gate no longer strand the public dataset behind an inflated raw-TVl baseline
• The raw top-10 covered TVL remains in cron metadata, while the guard uses an additional quality-adjusted top-10 guard TVL for near/hard threshold decisions
• True top-asset coverage collapses still fail hard when the previous baseline had meaningful effective liquidity

Impact Notes

• Pools above the large-pool TVL threshold are dropped when 24-hour volume is below the minimum-volume floor regardless of the volumeMeasured diagnostic flag
• Pool-state-only direct sources can still expand coverage with smaller eligible pools, but large zero-volume rows no longer bypass the retained-pool anti-poisoning guard
• Volume-to-TVL outlier checks, blocked-DEX filtering, protocol caps, and post-filter aggregate rebuilds continue to run around the stricter retained-pool gate

Impact Notes

• GeckoTerminal and CoinGecko Onchain Curve pools remain skipped on Ethereum, Base, Arbitrum, and Polygon to avoid duplicate Curve API coverage
• Curve pools on unsupported native-API chains such as Plasma can now contribute retained liquidity, challenger-pool evidence, and DEX price observations after the normal TVL, price sanity, protocol-cap, and dedupe gates
• This lets single-chain assets such as Yuzu USD surface Plasma Curve liquidity evidence instead of depending only on aggregator prices when the native Curve API has no chain coverage

Impact Notes

• Retained pools below the $50K DEX price-observation floor can still contribute to liquidity scoring when otherwise eligible, but no longer publish dex_price_usd or price_sources_json rows
• DEX price median weighting now uses canonical source families: DeFiLlama and direct API at 1.0, CoinGecko Onchain and GeckoTerminal at 0.85, DexScreener and CoinGecko tickers at 0.55
• Fallback rows that claim high-trust protocol names can no longer receive primary-source median weight solely from the protocol label

Impact Notes

• CoinGecko Onchain and GeckoTerminal pool rows whose tracked-token price fails the existing peg-aware DEX observation sanity gate are rejected before staging
• Already-staged rows with implausible tracked-token prices are skipped during scoring merge, so malformed discovery rows cannot inflate coin or global TVL until their staging TTL expires
• Carbon DeFi chain-suffixed secondary-source ids now normalize to the DefiLlama `carbon-defi` protocol cap, adding a cap-level backstop for Carbon rows
• Rows without a measured token price still flow through the existing TVL, volume, dedupe, protocol-cap, and retained-pool quality gates

Impact Notes

• CoinGecko Onchain, GeckoTerminal, DexScreener, and CoinGecko ticker staging can no longer persist non-finite, negative, or over-cap TVL values
• The scoring cron skips legacy staged rows above the same sanity ceiling before they can affect global TVL, coverage drift, or DEX price observations
• Valid high-liquidity pools below the ceiling continue through the existing dedupe, protocol-cap, and retained-pool quality gates

Impact Notes

• Absolute TVL Depth fallback: `20 * log10(tvl / 100_000) + 20` → `35 * log10(tvl / 700_000)`; coins without market cap data no longer gain ~24 points of unearned TVL Depth
• Aerodrome/Velodrome Slipstream price observations now derive from on-chain sqrt_ratio instead of reserve ratios; concentrated liquidity pools no longer emit biased spot prices when one side lacks a tracked USD price
• Slipstream pools where sqrt_ratio is unusable and one side has no tracked price are now dropped entirely (no reserve-ratio fallback derivation)

Impact Notes

• Non-Curve DeFiLlama pools that share token symbols with a Curve pool no longer inherit Curve registry metadata, balance ratios, token prices, or metapool-adjusted TVL
• CoinGecko/GeckoTerminal provider ids with underscores or provider suffixes normalize to the same canonical protocol family as DeFiLlama ids during pool-identity construction
• Staged discovery now skips a staged exact pool-id row when it uniquely matches one primary DeFiLlama UUID row by chain, protocol, token set, and pool-shape family, while ambiguous same-pair staged buckets still remain separate

Impact Notes

• Intraday PancakeSwap volume no longer collapses toward zero until UTC rollover just because the current day bucket has only accumulated partial activity
• Fresh non-swap day buckets can no longer zero out yesterday's still-relevant trading activity, because trailing volume now comes from summed hourly swap buckets
• The PancakeSwap direct fetch keeps bounded batching under The Graph row cap while staying on official subgraph entities instead of adding a new historical block lookup dependency

Impact Notes

• CoinGecko tickers fallback and discovery staging no longer drop every post-March-2026 ticker row just because CoinGecko now returns `trust_score = null`
• Orderbook fallback ticker intake now requires finite USD price/volume plus a stable exchange identifier, improving sanitization without depending on deprecated metadata
• Balancer direct API pools now reserve and dedupe by the true pool address, restoring exact-id confirmation against staged discovery and overlap checks

Impact Notes

• GeckoTerminal, CoinGecko Onchain, and DexScreener staging rows that claim Balancer, Fluid, Raydium, Orca, Meteora, PancakeSwap, Aerodrome, or Velodrome liquidity now require authoritative exact-id confirmation when the matching direct fetch succeeded cleanly on that chain
• The guard fails open when the authoritative source is unavailable or degraded, so discovery sources still recover coverage during native-source incidents instead of hard-zeroing the row
• Liquidity cron metadata now records `stagedPoolsSkippedByAuthoritativeProtocol` separately from exact-id and derived-identity dedupe skips

Impact Notes

• TVL Depth uses effective-TVL-to-market-cap ratio on a log scale (35 × log10(ratio / 0.0007)), with absolute fallback for coins without market cap data
• Volume Activity recalibrated: 38 × (log10(V/T) + 3) — zero line at 0.1% V/T, tops at ~32% V/T. USDC/USDT now score 86-90 instead of 52-56
• Pool Quality measures quality retention (qualityAdjustedTvl / totalTvl, rescaled from 15-80% range to 0-100). Fully size-independent
• Weights rebalanced from 35/20/22.5/15/7.5 to 30/20/20/20/10 — structural quality (Pool Quality + Durability = 40%) now matches depth + activity (50%)
• Coins like BOLD and LUSD with high relative depth ratios see significant score improvements; large-cap coins with low relative depth see depth dimension scores decrease but compensate through volume, durability, and diversity

Impact Notes

• Bunni is now excluded during crawl intake and DeFiLlama pool processing instead of being treated as a live DEX venue
• Retained-pool filters and challenger snapshots ignore Bunni even if stale rows or unexpected inputs survive earlier gates
• Liquidity scores, dexPriceUsd, and downstream DEX cross-checks no longer count Bunni TVL, pool counts, or protocol medians

Impact Notes

• Sub-threshold direct API pools now still block later exact-address staged duplicates from re-entering scoring with incompatible TVL semantics
• GeckoTerminal and CoinGecko discovery rows can no longer inflate liquidity by resurrecting the same exact direct pool after the direct row was excluded from scoring
• Balancer stablecoin pools now dedupe correctly against Balancer direct API even when DefiLlama labels the row as generic `balancer-v3` without stable subtype metadata

Impact Notes

• Pools that are skipped as duplicates or dropped by retained-pool quality filters can no longer keep influencing dex_prices
• dexPriceUsd, price_sources_json, and downstream dexPriceCheck consumers now reflect the same retained pool surface used for challenger publication and UI liquidity detail
• High-TVL discovery rows that never survive retained-pool admission can no longer manufacture near-peg DEX aggregates for depegged assets

Impact Notes

• Meteora DLMM pools now enter the direct-API merge path with measured TVL, volume, balances, and fee data
• PancakeSwap V3 pools now add protocol-native primary coverage across BSC and supported EVM chains through official Graph subgraphs
• Aerodrome Slipstream and Velodrome Slipstream pools now contribute pool-state TVL, balances, fees, and DEX-price observations via the on-chain Sugar view contracts
• Direct-source precedence over overlapping DeFiLlama rows now requires measured non-zero 24h volume, so Slipstream pool-state rows expand coverage without displacing stronger DL rows when volume telemetry is absent
• New concentrated-liquidity quality buckets now score PancakeSwap and Slipstream fee tiers consistently with existing Uni V3 logic

Impact Notes

• GeckoTerminal and CoinGecko Onchain token crawls now read multiple bounded pages instead of stopping after page 1
• DexScreener and CoinGecko tickers fallback now trigger for weak partial coverage, not only coins with zero pools or no DEX price
• Fallback orderbook rows now preserve explicit synthetic/decayed/provenance flags instead of masquerading as organic USDC pools
• Coverage confidence now incorporates protocol breadth, source-family breadth, measured balance share, measured price share, and synthetic or decayed TVL share
• Direct-API pools default to a shorter maturity assumption and Fluid reserve normalization now marks whether balances were safely measured
• Shared secondary-pool contribution logic centralizes GT/CG/staged/fallback aggregate handling to reduce drift across merge paths

Impact Notes

• Direct API and staged/fallback pools resolve tracked assets by chain+address first, with chain-scoped symbol fallback only when unique
• Cross-source pool dedupe now uses exact pool ids first and derived token-shape matches only when they are unique on both sides
• Repeated sightings of the same physical pool across direct API, staged, and fallback sources now collapse before dex_prices weighting
• Depeg challenger inputs publish from the full retained pool set instead of the visible top-pools subset
• Fluid pools with missing token decimals now fall back to neutral balance rather than using unsafe raw reserve units

Impact Notes

• Fluid top-pool rows now populate Balance and Detail when the official DexReservesResolver is deployed on that chain
• Fluid pool quality now uses measured balance health on resolver-backed EVM chains, rather than a hardcoded neutral 1.0
• Fluid fee detail now comes from the on-chain pool config (`1% = 10_000`), normalized to basis-point badges in the UI
• BSC and Plasma Fluid pools remain on neutral-balance fallback until Fluid ships the same resolver path there

Impact Notes

• Direct-API Balancer, Raydium, and Orca pools now populate top-pool balance bars and detail badges
• Measured direct-API balance ratios now feed balance-weighted aggregates, stress, and effective TVL instead of assuming 1.0
• Balancer weighted pools normalize balance health against target token weights rather than raw reserve symmetry
• Orca vault balances are normalized from raw token units before balance-health calculation
• Top-pool fee tiers now serialize as actual basis points (for example 1bp, 5bp, 30bp) across UniV3, CG-onchain, and direct APIs

Impact Notes

• Raydium lower-case poolType contract fix restores live Solana pool coverage
• Orca now paginates via cursor.next with retry/backoff and a below-threshold stop, instead of truncating after page 1
• Direct API pools are fingerprint-deduped and preferred over overlapping DeFiLlama pools before score computation
• Direct API sources merge before staged/DexScreener/CG-ticker fallbacks, preventing lower-confidence sources from claiming the same pool first
• direct_api-only rows now classify as primary coverage (confidence 1.0) instead of fallback coverage
• Fluid volume now uses one-sided USD-normalized pool volume instead of double-counting raw token legs
• Balancer intake is limited to supported stable/weighted pool families on mapped chains only

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)

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

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

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

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

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

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

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

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

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