Open any token page on a block explorer or a market data site and you will usually see three different supply numbers sitting close together: circulating supply, total supply, and max supply. They sound interchangeable. They are not, and using the wrong one is one of the easiest ways to misjudge a token before you ever swap into it.
Circulating supply
Circulating supply is an estimate of how many tokens are actually free to move and trade right now. It is meant to exclude tokens that exist on chain but are not realistically available to the open market: tokens still locked in a vesting contract, tokens sitting in a team or treasury wallet that has not moved, or tokens held by the project itself as reserves.
This is the number most price and market cap calculations try to use, because it reflects the supply that can actually hit the order book or a liquidity pool today. The catch is that "circulating" is an estimate, not a protocol level fact. A data provider decides which wallets to exclude based on labels and public information, and a project's own team wallets are not always labeled correctly. Two different data sites can report different circulating supply figures for the exact same token.
Total supply
Total supply is a harder number: it is every token that currently exists on chain, full stop. That includes coins sitting in team wallets, treasury contracts, unclaimed airdrop contracts, and anything else that has been minted and not burned, whether or not it is realistically tradable.
Total supply will always be greater than or equal to circulating supply. The gap between the two tells you how much additional supply could theoretically enter the market from already minted tokens, for example if a team wallet decides to sell or a treasury votes to distribute funds.
Max supply
Max supply is the hard ceiling, the most tokens that will ever exist according to the contract's rules, including tokens not yet minted. Some tokens have no max supply at all. A token with ongoing staking rewards, ongoing emissions to liquidity providers, or an uncapped minting function has no max supply, which means total supply can keep climbing indefinitely. Others cap it directly in the contract logic, where minting simply stops once the cap is hit.
This is worth checking yourself rather than trusting a listing site's summary field, because "no max supply" and "max supply not yet reached" look identical on a lot of dashboards. If a project markets itself as deflationary or fixed supply, the mint function (or the absence of one) in the verified contract source is the actual source of truth, not the marketing page. What does a verified contract on Basescan mean walks through how to confirm a contract is verified before you read its code.
Why the three numbers can tell different stories
Picture a token with a max supply of one billion. Only 300 million have been minted so far (total supply), and of those, 180 million sit in a four year team vesting contract, which leaves 120 million actually circulating.
A market cap built on circulating supply (120 million multiplied by price) will look much smaller than a fully diluted valuation built on max supply (one billion multiplied by price). Neither number is wrong. They answer different questions. Circulating market cap is a rough gauge of what the market is pricing today. Fully diluted valuation is a rough gauge of what the market is implicitly pricing if every token that could ever exist were already unlocked and trading. APY vs APR explained and Market cap vs fully diluted valuation explained both cover the mechanics of turning a raw number into a valuation; this article is about where the raw supply figures themselves come from.
What this changes about how you read a token
A few practical habits follow from understanding the difference:
- Treat a large gap between circulating and total supply as a signal to look deeper, not as a reason to panic on its own. Check what is actually in the locked wallets and when it unlocks. Token vesting and unlock schedules explained covers how to find a project's unlock calendar.
- Check whether max supply is fixed, uncapped, or still being minted. A token advertised as scarce but with an open ended minting function is not behaving the way the marketing suggests.
- Compare supply figures across more than one data source when a decision matters to you, since circulating supply in particular is an estimate that providers can disagree on.
- Remember that none of these numbers say anything about a token's price direction. They describe supply, not demand, and supply alone does not make a token a good or bad swap.
The bottom line
Circulating supply is what is realistically tradable today, total supply is everything that currently exists on chain, and max supply is the hard ceiling the contract allows. They are three separate facts about a token, not three ways of saying the same thing, and reading them together gives a far more honest picture than looking at any single one alone. If you want a fuller checklist for sizing up a token before swapping, How to research a token before you swap it puts supply figures in context alongside liquidity, holder distribution, and contract ownership.