Documentation

Tokenctl runs a deterministic, read-only scan of a Solana token directly against on-chain data — no wallet, no signing, nothing stored. Here's exactly what it checks and how to read the result.

What Tokenctl does

You paste a token mint address and Tokenctl pulls the token's on-chain state and holder data, then summarizes the risk signals that matter before you trade:

  • Metadata & supply — name, symbol, token program, decimals, total supply, and (when available) price and market cap.
  • Authorities — whether the mint authority and freeze authority are still active or have been revoked.
  • Holder concentration — how much of the supply the largest individual holders control, owner-aggregated so one entity's many accounts count as one.
  • Liquidity pools — known pool accounts are detected and reported separately, so they don't distort the individual-holder picture.
  • Activity — recent on-chain activity and mint events, flagging tokens that look stale.

Reading the verdict

Every scan ends in a single verdict, backed by the concrete signals that drove it:

CLEANNo major red flags in the checks we run. Still not a green light — it means nothing obvious is wrong.
WATCHSomething warrants a closer look — e.g. an active authority, elevated concentration, or stale activity.
RISKYOne or more strong risk signals — such as extreme holder concentration or live mint authority.
The verdict is a fast first-pass screen, not a guarantee. It can't see off-chain context, team intent, or future actions. Always do your own research.

Glossary

Mint address

The unique on-chain identifier for a token (its "contract address" on Solana). This is what you paste into Tokenctl.

Mint authority

The account allowed to create new tokens. If active, supply can be inflated; if revoked, supply is fixed.

Freeze authority

The account allowed to freeze token accounts, blocking transfers. If active, holders' tokens could be frozen.

Holder concentration (Top 1% / Top 10%)

The share of circulating supply held by the largest holders. High concentration means a few wallets could move the price sharply.

Liquidity pool

An on-chain account (e.g. on a DEX) that holds tokens for trading. Reported separately so pool balances aren't mistaken for a whale.

Roadmap

Where we're taking Tokenctl next. Rough order, not a commitment:

Live

On-chain risk scan + verdict

Authorities, holder concentration, liquidity-pool detection, activity, and USD-denominated figures — available today via the web app and CLI.

Up next

Watchlists & saved tokens

Track a set of tokens and re-scan them with one click, with changes highlighted between scans.

Up next

Historical tracking

Snapshot concentration and authorities over time to spot trends — e.g. a whale quietly accumulating or an authority newly granted.

Planned

Real-time alerts

Get notified when something material changes — authority enabled, large holder movement, or a liquidity pull.

Planned

Public API

Programmatic access to the same analysis for bots, dashboards, and integrations.

Planned

Deeper liquidity & LP-lock checks

Distinguish locked vs. unlocked liquidity and surface rug-pull-shaped patterns.

Ready to scan a token?

Analyze a Token →