Total supply is the number of units of a cryptocurrency that exist right now: everything that has been mined, minted or pre-issued, minus any units that have been verifiably destroyed. Unlike circulating supply, it includes tokens that cannot yet be sold, such as team and investor allocations still under vesting, treasury holdings and tokens sitting in locked contracts.
Total supply is one of three supply measures used by data aggregators and in project tokenomics documents. It is larger than or equal to the circulating supply and smaller than or equal to the maximum supply, the cap written into a protocol or contract. For many tokens created in one go by a smart contract, total supply is fixed on the first day, while for mined coins it grows with every block.
Total supply in plain terms
Picture a company that has printed 10,000 gift vouchers. Some are in customers' wallets, some are in the manager's safe, and some are reserved for staff bonuses next year. The total supply is all 10,000 vouchers that have been printed and not shredded, wherever they happen to be.
If the manager shreds 500 damaged vouchers, the total drops to 9,500. If the printer runs another batch, it rises. Total supply answers the question "how many exist today?" It says nothing about how many people can actually use them this week, and nothing about how many could ever be printed.
How total supply is calculated
For most tokens the figure can be read from the chain. On an ERC-20 or BEP-20 token, the contract exposes a totalSupply() function that returns the number of units it has minted and not burned. Data sites start from that number and then subtract units sent to known burn addresses that the contract still counts:
- is the total supply.
- is every unit ever created, through pre-mint, minting, mining or staking rewards.
- is every unit verifiably destroyed, for example by sending it to an address with no usable private key.
Worked example: a project minted 500 million tokens at launch and has since issued 40 million more as staking rewards. It has burned 15 million through fee burns. Total supply is million tokens. If 200 million of those are still locked and 75 million sit in a treasury, the circulating supply is million.
Total supply versus maximum supply
Maximum supply is a ceiling, not a count. Bitcoin (BTC) has a total supply that grows by the current block reward roughly every ten minutes, and a maximum just under 21 million bitcoins that it approaches as each halving slows issuance. Some tokens have no maximum at all. Ethereum (ETH) issues new ether to validators and burns the base fee of each transaction; according to ethereum.org, total supply at the Merge in September 2022 was about 120.5 million ETH, and it has moved up or down since depending on network use.
The table sets the three measures side by side:
| Measure | What it counts | Changes when |
|---|---|---|
| Circulating supply | Units in public hands that can trade | Unlocks, issuance, burns, reserve sales |
| Total supply | All units created minus units burned | Issuance and burns |
| Maximum supply | The most units that can ever exist | Only by changing the protocol or contract |
Why investors watch it
The gap between total and circulating supply shows how many tokens are waiting to enter the market. Large locked balances usually follow a vesting schedule, such as cliff vesting or linear vesting, and each token unlock moves part of the total into circulation. Traders often price this in ahead of the date.
Total supply also feeds valuation. The fully diluted valuation multiplies price by maximum supply, or by total supply where no maximum exists, while market capitalization uses circulating supply. A rising total supply with flat demand dilutes every holder, the crypto equivalent of inflation; a falling total, the aim of deflationary tokenomics, does the opposite.
Limitations
A contract's reported total is only as reliable as the contract. If the owner keeps a mint function, total supply can be raised at will, which is one of the checks in a rug check. Burns are also counted differently: some contracts reduce the total when tokens are destroyed, while others leave the units at a dead address, and data sites must subtract them by hand. Wrapped and bridged versions of the same asset on several chains can double-count supply if they are added together. For these reasons analysts compare the contract figure, the project's whitepaper and an independent block explorer before trusting a single number.