The claim class: a stated circulating-supply figure for a token, distinct from its total supply, implicitly built on a specific list of treasury, team, or locked wallets that were excluded from the count.
Claim class: a pattern of statements, not one attributed, dated quote.
Receipt to pull The receipt has two parts: the contract's own totalSupply figure, read directly on-chain, and an explicit, checkable list of the specific addresses excluded to arrive at the circulating figure, each with its own on-chain balance confirming the amount actually excluded. No single receipt is linked: this piece explains how to check this kind of claim and does not grade one specific claim.
Even a well-documented circulating-supply figure is a snapshot; it will drift as vesting unlocks, treasury spending, or new minting occurs, and a figure published once can go stale quickly for actively emitting tokens. It also does not by itself indicate whether excluded wallets are permanently locked or merely temporarily unspent, which changes how durable the exclusion really is.
Not financial advice. The Crypto Online is a verification desk, not an accredited fact-checker.
Circulating supply sounds like a simple subtraction: total supply minus whatever is locked up. In practice it depends entirely on which wallets someone decided to subtract, and that decision is rarely shown next to the final number.
The Claim
The claim class: a stated circulating-supply figure for a token, distinct from its total supply, implicitly built on a specific list of treasury, team, or locked wallets that were excluded from the count.
The Receipt
The receipt has two parts: the contract’s own totalSupply figure, read directly on-chain, and an explicit, checkable list of the specific addresses excluded to arrive at the circulating figure, each with its own on-chain balance confirming the amount actually excluded.
Without that second part, a circulating-supply number is just an assertion wearing total supply’s precision. Reasonable methodologies differ (some exclude only unvested team tokens, others also exclude treasury or staking-contract balances), so the specific list matters more than the resulting percentage.
What It Doesn’t Prove
Even a well-documented circulating-supply figure is a snapshot; it will drift as vesting unlocks, treasury spending, or new minting occurs, and a figure published once can go stale quickly for actively emitting tokens. It also does not by itself indicate whether excluded wallets are permanently locked or merely temporarily unspent, which changes how durable the exclusion really is.
How to Check It Yourself
- Read totalSupply directly from the token’s contract on a block explorer rather than from an aggregator’s cached figure.
- Find the specific list of addresses being excluded to produce the circulating figure, from the project’s own disclosure.
- Check the on-chain balance of each excluded address individually and sum them, confirming the total excluded matches the gap between total and circulating supply as claimed.
- Check whether excluded wallets are time-locked by a vesting contract, merely unspent by convention, or something else, since this affects how reliable the exclusion is going forward.
- If a vesting or lockup schedule is involved, cross-check it against our piece on token unlock schedules to see when excluded tokens re-enter circulation.
- Note the date of your check, since circulating supply for an actively vesting or minting token changes on a predictable schedule, not just unpredictably.
A Worked Example
A project reports a circulating supply well below its total supply, attributing the gap to unvested team tokens held in three named wallets. A reader checks each wallet’s on-chain balance and finds the combined total matches the stated gap closely, supporting the claimed figure. On checking those same three wallets again, the reader also notices none of them sit behind any lockup contract, meaning the exclusion, while numerically accurate today, rests on convention rather than any enforced restriction.
What Supported, Contradicted, and No Receipt Look Like
Supported: totalSupply read on-chain, minus the sum of a specific, disclosed, and independently verifiable list of excluded addresses, matches the claimed circulating-supply figure within a reasonable margin for timing.
Contradicted: The sum of disclosed excluded addresses does not account for the full gap between total and claimed circulating supply, meaning either unlisted wallets are also being excluded or the claimed figure does not follow from the stated methodology.
No receipt: No specific list of excluded addresses is published anywhere, only a final circulating figure with no stated methodology; the subtraction cannot be checked at all.
Red Flags
- A circulating-supply figure is quoted with no accompanying list of what was excluded to produce it.
- The excluded wallets, once checked on-chain, hold less than the gap between total and circulating supply would require.
- Excluded wallets are described as team or treasury holdings but have no lockup mechanism preventing them from moving at any time.
- The methodology changes between two published figures without explanation, making a trend comparison meaningless.
- A different circulating-supply figure appears on the project’s own site than on a price-tracking page, with no indication which methodology either one used.
A Practical Complication to Expect
Methodology differences between data sources are a frequent, non-malicious source of circulating-supply disagreements: one source might exclude only tokens in a formally coded vesting contract, while another also excludes a treasury wallet that holds tokens without any lockup mechanism simply because the project has described it as reserved for future use. Neither approach is inherently wrong, but comparing figures computed under different methodologies, especially across different data providers, risks treating a methodology difference as though it were a factual discrepancy. Readers doing their own subtraction should state their own methodology explicitly, including exactly which wallets were excluded and why, so the resulting figure can be checked and reproduced by someone else later.
Why It Matters
Circulating supply is frequently the denominator behind other headline figures, including market capitalization, so an unexamined exclusion list can make a project look smaller or larger than its own contract’s plain totalSupply figure would suggest. Checking the subtraction itself, rather than accepting the final number, is the only way to know which figure is doing real work. This is also why a single circulating-supply number is a weaker claim on its own than the full subtraction behind it: the number invites comparison across projects that may not share a methodology at all, while the underlying wallet list invites a reader to check the same arithmetic for themselves and reach their own, independently reproducible figure rather than borrowing someone else’s.
See our pieces on stablecoin supply on-chain, treasury wallet balance, and token unlock schedule for the related checks.
FAQ
Why would a project’s circulating supply be lower than total supply at all?
Common reasons include unvested team or investor allocations, a treasury reserved for future use, or tokens staked or locked in a contract that restricts their movement for a defined period.
Is a lower circulating supply always a positive sign?
Not inherently; it depends entirely on whether the excluded tokens are genuinely locked and for how long. A large allocation sitting in an address with no lock at all is excluded from circulating supply only by convention, not by any real restriction.
Where should I look for the exclusion methodology if the project does not publish one?
Treat the absence as a no-receipt finding rather than guessing; some aggregators publish their own methodology for a given token, which can serve as a secondary, clearly-labeled source if the project itself does not disclose one.
How does this differ from the stablecoin supply check?
Stablecoin supply checks typically compare total supply to a reserve attestation; this check is about whether total supply itself was correctly subtracted down to a specific circulating figure, a different question entirely.
How should a reader handle a token with several different, simultaneously published circulating-supply figures from different sources?
Rather than picking whichever figure seems most favorable or most commonly repeated, it is worth reconstructing the figure independently from the token contract and a disclosed exclusion list, then noting which published source, if any, matches that independent calculation; a source that consistently matches an independently reproducible methodology is more useful going forward than one that happens to agree on a single occasion without a clear, repeatable method behind it.
Not financial advice. The Crypto Online is a verification desk, not an accredited fact-checker; we describe how a claim like this can be checked, never whether to buy, sell, or hold anything on the back of it.
Sources
This piece links no outside source: it explains a class of claim and the public records you would check, rather than grading one specific statement. When a specific claim is checked, every source link is listed here with its status.
Not financial advice. Human-edited; AI-assisted drafting is disclosed in our editorial guidelines. Spotted an error? See how corrections work.



