Skip to content
GodzeraFiGodzeraFi

Methodology

Every score, in the open.

GodzeraFi never hides a formula. The three engines below run in src/lib/engine/score.ts and return every sub-score with its reason.

Log-normalisation

Market quantities span many orders of magnitude, so each is mapped to 0–100 on a log10 scale between a floor and a ceiling. Values outside the range are clamped. A metric a provider did not return is null, never zero, and is excluded from the weighted average; the remaining weights are re-normalised and the coverage is reported as a confidence level (HIGH ≥ 85% of weight, MEDIUM ≥ 60%, LOW otherwise).

logNorm(v, lo, hi) = clamp( (log10(v) − log10(lo)) / (log10(hi) − log10(lo)) × 100 , 0, 100 )

Godzera Pulse (0–100)

Ranks how actively and healthily a market is moving right now. Higher is “more signal”, not “better investment”.

ComponentWeightInputSub-score
Momentum30%24h change (70%) + 1h change (30%)50 + change24h × 1.5, blended with 50 + change1h × 5, clamped 0–100
Liquidity25%Pooled DEX liquidity (USD)logNorm($1K → $1B)
Volume20%24h volume (USD)logNorm($1K → $10B)
Volatility quality15%24h range % (high–low / price, or |changes| when no range)<0.5% → 40–60 · 0.5–2% → 60–100 · 2–10% → 100 · 10–40% → 100→10 · >40% → 5
Freshness10%Age of the source snapshot≤2 min → 100 · 10 min → 60 · 60 min → 20
Pulse = Σ(weight_i × score_i) / Σ(weight_i)   over components with data
Universe: CoinGecko top 100 + GeckoTerminal trending pools + top pools on ETH / SOL / Base / Robinhood
Stablecoins are excluded; entries with < 50% coverage are not ranked.

Market Mass (0–100)

Measures how significant a market is relative to its liquidity, volume, capitalisation and activity. It is GodzeraFi’s own term — a size metric, not a quality metric.

ComponentWeightInputSub-score
Liquidity35%Pooled DEX liquiditylogNorm($1K → $1B)
Volume30%24h volumelogNorm($1K → $10B)
Market cap20%Market cap (FDV when cap unavailable)logNorm($10K → $1T)
Market activity15%24h transaction count, else turnover = volume / caplogNorm(1 → 1M txns) or logNorm(0.1% → 100% turnover)
Mass = 0.35·L + 0.30·V + 0.20·C + 0.15·A   (re-normalised over available components)

On the landing page, the MASS object is sized by the liquidity sub-score, MOTION by the volume sub-score, and ENERGY by the observed 24h range of the selected asset.

Observed risk (0–100, higher = more risk)

GodzeraFi never labels an asset SAFE or SCAM. It reports LOW / MODERATE / HIGH OBSERVED RISK from measurable market conditions, or INSUFFICIENT DATA when fewer than 40% of the weights have inputs.

ComponentWeightInputRisk sub-score
Liquidity quality30%Pooled liquidity100 − logNorm($1K → $10M)
Volume quality20%Volume ÷ liquidity<0.01× → 75 · <0.05× → 50 · 0.05–5× → 10 · 5–20× → 45 · >20× → 85
Volatility20%24h range %<5% → 10–15 · 5–20% → 15–50 · 20–60% → 50–100 · ≥60% → 100
Market age10%Oldest pool / genesis date<1 day → 100 · <7d → 70 · <30d → 40 · <180d → 20 · else 5
Concentration10%Top-10 WALLET share of supply — contract holders (pools, bridges, custody) excluded (Blockscout on EVM chains; Jupiter audit on Solana)≥50% → 100 · 30–50% → 60–100 · 10–30% → 10–60 · <10% → share
Market depth10%Pool count + main-pool share of liquidity≥5 pools → 10 · 3–4 → 25 · 2 → 45 · 1 → 65 (+10 if one pool holds >90%)

DEX-only liquidity caveat. Pooled liquidity comes from DEX pairs. For widely CEX-listed assets (CoinGecko rank ≤ 200) most depth sits on centralised venues, so the volume ÷ liquidity ratio is replaced by turnover (volume ÷ market cap: <0.1% → 60 · <1% → 30 · 1–50% → 10 · >50% → 40) and the FDV ÷ liquidity signal is not applied. For every other asset the ratio uses DEX volume (sum of observed pools) when available.

Threshold signals

SignalTrigger
Low liquiditypooled liquidity < $25K (high severity < $5K)
Unusual volume24h volume > 20× pooled liquidity
Extreme volatility24h range ≥ 40% (high severity ≥ 80%)
Very new marketoldest observed pool < 7 days (high severity < 1 day)
High FDV / liquidity ratioFDV > 200× pooled liquidity (high severity > 1000×)
Concentrated holdingstop holders ≥ 30% of supply (high ≥ 50%)
Mint / freeze authority activeSolana mint or freeze authority not revoked (from RPC / Jupiter)
Level:  score < 30 → LOW OBSERVED RISK · 30–59 → MODERATE · ≥ 60 → HIGH · coverage < 40% → INSUFFICIENT DATA
This score reflects observable market conditions and is not a guarantee of asset safety. It cannot see contract code, team behaviour, or off-chain events. Verify the sources linked on every asset page.

Known limitations

CoinGecko’s multi-chain universe carries no pooled-liquidity figure, so liquidity-weighted components fall back to the remaining weights for those rows (confidence is shown). GeckoTerminal per-chain views list pools, so an asset with many pools is represented by its deepest pool. 24h ranges for DEX-only tokens are approximated from 1h/24h moves. Holder concentration comes from Blockscout on Ethereum, Base, Arbitrum, Optimism and Robinhood Chain — the engine scores the ten largest non-contract wallets, and the asset page also shows the all-address figure with how many of the top ten are contracts — and from the Jupiter audit on Solana; it is unavailable for other chains and for natives addressed by CoinGecko id.