Documentation

Methodology

Germanus measures on-chain state of Solana tokens and archives every measurement permanently. Each analysis is a snapshot: what the chain said at that moment. Snapshots of the same contract form a timeline; the cockpit places them side by side so change becomes visible. Nothing is ever revised after the fact.

How a scan works

A deep scan resolves the token's authority surface, the top 100 holders (exchange and AMM wallets separated out), their funding origins, trading history and profit/loss, plus liquidity across pools. It takes 1 to 3 minutes and up to 1,200 data-provider calls. The result is stored twice: as a full forensic report and as structured values that feed the cockpit grid and the holder table.

Archive-first & the freshness probe

Requesting a contract shows the stored dossier immediately. "Rescan" first runs a single-call probe against current market data: if total liquidity moved less than 10% versus the stored value, the archive answer is served and your scan window is not consumed. The unchanged reading is itself information. Only real movement (or an operator override) triggers a fresh deep scan.

The 5-hour window

Anyone may start one deep scan per 5 hours (enforced per anonymised IP hash). Reading the archive is never limited. Archive answers do not consume the window.

Coverage & n/a

Every value states how much data supports it: "n=2 of 30" means two of thirty wallets could be priced. Where nothing was recorded, Germanus shows n/a, never a substitute and never zero. An n/a in an older scan usually means the data point did not exist in that scan version yet.

Why no verdicts

Germanus does not label tokens safe or dangerous and does not compute a public risk score. Measured state, with sources, is the product: top-10 concentration versus the platform median says more than a traffic light, and it stays true when circumstances change. The same rule applies to community observations, which must describe and link evidence, not judge.

Data sources

Helius (RPC, holders, transactions), Birdeye (historical USD pricing behind the PnL layer), Solscan Pro (account labels, transfers), Dexscreener (pairs, liquidity, the freshness probe), Jupiter and Raydium (pool data). Reports link the sources per section.

Dynamic rows

Two cockpit groups are dynamic: "Market reality" mirrors the market-structure rows of the stored scan, "Authority surface" mirrors the authority fields. Their rows follow the scan content; every value is stored, none is fetched live.

Removal procedure

The archive is immutable by default. Substantiated notices of a rights violation go to support@germanus.app and are reviewed; see the privacy policy.

Analysis point reference

Every point below is live: it renders from stored scan data. Points that a given scan did not record show n/a in the cockpit.

Market

Liquidity: What: Total USD liquidity across all detected pools. Source: Dexscreener pairs at scan time. Limit: Pools created after the scan are not included.
Volume 24h: What: Trading volume in the 24h before the scan. Source: Dexscreener pair data. Limit: Wash trading is not filtered here.
Pools: What: Number of top liquidity pools recorded. Source: Dexscreener, capped at the top pools. Limit: Micro pools below the cap are not counted.
Top pool liquidity: What: Liquidity of the deepest single pool. Source: Dexscreener. Limit: Snapshot value; pool depth moves constantly.

Distribution

Holders on-chain: What: Total holder accounts on-chain. Source: Helius RPC / Birdeye counter. Limit: Includes dust accounts.
Holders analysed: What: Holders that entered the deep analysis. Source: Scan pipeline (top holders ex-AMM). Limit: A sample of the largest, not all holders.
Holder table rows: What: Rows recorded in the holder table. Source: Stored holder table. Limit: Up to 100 rows per scan.
Top 5: What: Supply share of the 5 largest non-AMM holders. Source: Derived from the stored holder table. Limit: Basis is the top-100 ex-AMM sample.
Top 10: What: Supply share of the 10 largest non-AMM holders. Source: Scan pipeline. Limit: Exchange custody wallets are separated out where known.
Top 20: What: Supply share of the 20 largest non-AMM holders. Source: Scan pipeline. Limit: Same basis as Top 10.
Top 50: What: Supply share of the 50 largest non-AMM holders. Source: Derived from the stored holder table. Limit: Basis is the top-100 ex-AMM sample.
Largest holder: What: Share of the single largest holder. Source: Scan pipeline. Limit: One wallet is not necessarily one owner.
Wallets > 1%: What: Wallets holding more than 1% of supply. Source: Derived from the stored holder table. Limit: Top-100 basis.
Median share: What: Median share among recorded holders. Source: Derived from the stored holder table. Limit: Top-100 basis, skewed by design toward large holders.
Concentration: What: Concentration index (sum of squared shares × 10,000). Source: Derived from the stored holder table. Limit: Computed over the top-100 sample, not all holders.

PnL / Movement

Avg PnL top 30: What: Average net PnL of the top-30 wallets. Source: Birdeye-priced trade history. Limit: Coverage shown as n of 30; unpriced wallets excluded.
Sum realized: What: Sum of realized PnL across priced holder rows. Source: Derived from the stored holder table. Limit: Only wallets with priced history count.
Sum unrealized: What: Sum of unrealized PnL across priced holder rows. Source: Derived from the stored holder table. Limit: Position value depends on the price at scan time.
Wallets in profit: What: Share of priced wallets currently in profit. Source: Derived from the stored holder table. Limit: Coverage shown; unpriced wallets excluded.
Top 15 in profit: What: How many of the top-15 wallets are in profit. Source: Scan pipeline. Limit: Subject to the same pricing coverage.
Top 15 PnL coverage: What: Pricing coverage of the top-15 PnL read. Source: Scan pipeline. Limit: Low coverage weakens every PnL statement.
Top 15 unrealized: What: Unrealized PnL of the top-15 wallets. Source: Scan pipeline. Limit: Paper value, not exit value.

Control

Mint authority: What: Whether new tokens can still be minted. Source: On-chain mint account. Limit: States the standard authority; program-based mints differ.
Freeze authority: What: Whether accounts can be frozen. Source: On-chain mint account. Limit: Standard authority only.
LP status: What: State of the liquidity pool tokens. Source: Lock providers and on-chain checks. Limit: unknown means no provider confirmed a lock.
Lock provider: What: Which service locked the LP, if any. Source: Lock provider APIs. Limit: Only known providers are detected.
Locked supply: What: Share of supply verifiably locked. Source: Lock provider data. Limit: Unlocked does not equal about-to-sell.
Lock check: What: Whether the lock check completed. Source: Scan pipeline. Limit: not_checked means the probe did not run, not that no lock exists.
Lock expiry: What: When a detected lock expires. Source: Lock provider data. Limit: Extension after the scan is possible.

Provenance

Direct funder share: What: Supply held by wallets funded from one common source. Source: Funding-graph analysis. Limit: Indicates coordination capability, not proven intent.
Funder cluster: What: Largest funding cluster among top holders. Source: Funding-graph analysis. Limit: Same-source funding can also be an exchange pattern.
Distinct funders: What: Distinct direct funders of top holders. Source: Funding-graph analysis. Limit: Depth-limited traversal.
CEX funders: What: Funders identified as exchange wallets. Source: Known-wallet labels. Limit: Unlabelled exchange wallets are not counted.
Avg wallet age: What: Average age of holder wallets in days. Source: Derived from the stored holder table. Limit: Lower-bound ages where history is truncated.

Coverage / Meta

Avg holder coverage: What: Average data coverage across holder rows. Source: Derived from the stored holder table. Limit: Coverage varies per wallet.
Scan mode: What: Which scan mode produced this snapshot. Source: Scan metadata. Limit: deep and fast scans record different depth.