Guide
Circulating, Total and Max Supply: What Each Number Means and Who Sets It
A clear definition of the three supply figures every coin page shows, why they are set by different parties for different reasons, and why circulating supply is the hardest one to pin down exactly.
Nearly every coin profile on every data site shows three supply numbers, and nearly every reader has at some point confused one for another. Circulating, total and max supply measure three genuinely different things, set by different mechanisms, and the gaps between them are where a lot of the useful information actually lives — which is exactly why this site builds its Supply Clock around showing all three together rather than leading with just one.
The three definitions
- Circulating supply: the number of units that are publicly available and able to be traded or transferred right now. This excludes tokens locked in vesting contracts, known team or foundation holdings not yet unlocked, and tokens sent to verifiable burn addresses.
- Total supply: the number of units that currently exist, full stop — circulating supply plus anything locked, vested-but-unclaimed, or otherwise held back from the public float, but minus anything confirmed burned.
- Max supply: the hard ceiling the protocol’s own rules will never issue past, if the design defines one. Many protocols have no max supply at all, in which case this field is simply not applicable, not zero.
The relationship, where all three exist, is always circulating supply less than or equal to total supply, and total supply less than or equal to max supply. When a project reports numbers that violate that ordering, something in the methodology (or the claim) needs a closer look.
Who actually sets each number
Max supply is a protocol design choice, enforced by code (or, for a non-smart-contract chain, by the base-layer consensus rules). It can sometimes be changed after launch through a governance vote on networks that allow that, which is why a currently-enforced max supply figure is more reliable than a whitepaper’s original claim. Total supply is a direct consequence of every mint and burn event that has actually happened, readable from the chain itself — it is not really “set” by anyone in an ongoing sense, it is simply counted. Circulating supply is the one with genuine human judgment involved: a data provider (or this site, or any other tracker) has to decide which known-locked addresses to exclude, and different providers do not always agree, which is why the same asset can show slightly different circulating-supply figures across different sites at the same moment.
Why circulating supply is the hardest number to pin down
Excluding a locked balance from circulating supply requires knowing that the balance is locked, which requires either a public vesting contract with machine-readable terms, or a foundation’s own voluntary disclosure of which addresses it controls and under what restriction. Tokens that are technically unlocked but that the holder has simply chosen not to sell (a founder sitting on a large allocation with no contractual lockup, for instance) are usually counted as circulating by convention, even though their practical liquidity may be just as limited as a contractually locked balance. This is a real limitation of the metric, not a flaw unique to any one tracker: circulating supply measures contractual availability, not actual seller behavior, and the two are not the same thing.
Common distortions worth watching for
- Stale snapshots. A circulating-supply figure that has not been refreshed since a large unlock will understate the real float until the source updates.
- Inconsistent burn accounting. If burned tokens are subtracted from total supply by one source but left in by another, max and total supply comparisons across sources will not line up even for the same asset.
- Mismatched definitions of “max.” Some assets report a theoretical long-run ceiling that is different from a strict protocol-enforced cap; conflating the two makes FDV-style calculations (covered in a separate guide on this site) misleading.
- Treating uncapped supply as “infinite” rather than “undefined ceiling, currently issuing on a known schedule.” No max supply does not mean issuance is unpredictable — the annual rate is often very well defined even without a hard stop.
Reading the three numbers together
Circulating supply tells you what is tradable today. The gap between circulating and total tells you how much is locked and will eventually join the float — the subject of this site’s guides on unlock schedules and vesting cliffs. The gap between total and max tells you how much issuance capacity the protocol has left before its schedule (if it has a ceiling) runs out, which feeds directly into the dilution-maths guide’s calculations. None of the three numbers is more “correct” than the others; they answer different questions, and a complete read of an asset’s supply position uses all three together. Each asset’s Supply Clock readout on each coin page on this site shows the three figures side by side with a source and fetch time for each, specifically so you are not stuck guessing which one a headline number was quoting.
A worked illustration of the three figures together
Take a hypothetical token with a protocol-enforced max supply of 1,000,000,000 units. At a given point in its schedule, 740,000,000 units have ever been issued, of which 15,000,000 have been sent to a confirmed burn address, leaving a net total supply of 740,000,000 – 15,000,000 = 725,000,000. Of that total, 90,000,000 sit in a disclosed, still-locked foundation vesting contract. Circulating supply is total supply minus the locked foundation balance: 725,000,000 – 90,000,000 = 635,000,000. The ordering holds exactly as expected: 635,000,000 (circulating) is less than 725,000,000 (total), which is less than 1,000,000,000 (max). As the foundation’s vesting contract releases tokens on schedule, circulating supply will rise toward total supply even with no new issuance at all, which is a useful reminder that circulating supply can grow for reasons that have nothing to do with the protocol’s mint function — it is also a function of previously issued supply becoming newly available.
Why these conventions evolved the way they did
The three-tier framework exists because a single “supply” number was never adequate once projects started pre-allocating large locked balances at launch rather than issuing everything through a public, gradual mechanism like mining. Early Proof of Work assets, where nearly all supply entered circulation through the same public process that counted toward total supply, had less practical need for the distinction, since circulating and total supply tracked closely together by default. Once pre-mines, foundation allocations, and multi-year vesting for insiders became common design choices, total supply and circulating supply could diverge by a wide margin for years at a time, and reporting only one figure stopped being an adequate description of an asset’s actual tradable float — which is the specific gap the Supply Clock on this site’s coin pages is built to show plainly rather than collapse into one headline number.
A technical gotcha: raw integer balances versus human-readable supply
On most smart-contract platforms, a token’s balances and total supply are stored on-chain as large raw integers, with a separately defined “decimals” value (commonly 6, 8, or 18) specifying how many of the rightmost digits represent a fractional unit. A total-supply query returns the raw integer; converting it to the human-readable figure quoted everywhere else requires dividing by ten raised to the decimals value for that specific token. Using the wrong decimals figure, or reading the raw integer directly without this conversion, produces a supply figure that is wrong by many orders of magnitude — a mistake that is easy to make when querying a contract directly rather than through an explorer that already applies the correct conversion. It is a mechanical detail, but it explains a specific, checkable class of error behind an occasional wildly incorrect supply figure that otherwise looks plausible at a glance.
A quick gut check before citing any of the three figures
Before repeating a circulating, total, or max supply figure, confirm which one you actually have, since headlines and casual references often say simply “supply” without specifying — and confirm the fetch date, since circulating supply in particular can shift between a scheduled unlock and whenever you happen to be reading the figure.
Risk note
Supply figures describe the structure of an asset’s issuance, not its value or likely price path. A large circulating supply does not make a token cheap, and a small one does not make it expensive — price per unit is a function of the total market capitalization, not the raw supply count. Use these definitions to read data correctly, not to infer an investment conclusion.
Not financial advice. This guide explains how supply mechanics work so you can read them yourself; it does not recommend buying, holding, or selling any asset, and none of the worked numbers in this guide are live market data.
Frequently asked questions
What is the difference between total supply and max supply?
Total supply is how many units exist right now, including locked or vested ones not yet tradable. Max supply is the hard ceiling the protocol will never issue past, if one is defined at all; many protocols have no max supply, in which case total supply simply keeps growing on its own schedule.
Why is circulating supply harder to measure than total supply?
Total supply is usually a direct read from a contract or ledger. Circulating supply additionally requires a judgment call about which held tokens are genuinely excluded from the tradable float -- team wallets, known burn addresses, locked treasury balances -- and different data providers do not always draw that line in the same place.
Who decides a token's max supply?
The protocol's code, as set by its developers at launch or changed afterward through a governance process if the design allows that. It is not an externally imposed limit; it is a rule the network's own software enforces, which is why checking the live contract matters more than checking a whitepaper.
Can a token have no max supply at all?
Yes. A number of major protocols issue new units indefinitely with no coded ceiling, relying instead on fee burns or a disinflating percentage rate to manage long-run supply growth rather than a hard stop.
Not financial advice. Ecoin Supply describes how crypto-asset supply works and what public sources report. Crypto-assets are volatile and you can lose all of the money you put in. Nothing on this site is a recommendation to buy, sell or hold any asset, and no figure here is a price prediction.