
What do token supply and decimals mean when you create a token?
Supply is how many tokens exist. Decimals is how many digits a balance can have after the point, so it sets how finely one token can be split. The blockchain stores every balance as a whole number of base units, and a wallet divides it by 10 to the power of the decimals to show it. For most new tokens, you make three choices:
- Keep the chain default: 18 decimals on ERC-20 and BEP-20, 9 on Solana.
- Pick a round supply, such as 1 billion.
- Decide before launch whether supply stays fixed or can grow.
What token decimals mean
OpenZeppelin's ERC-20 documentation says decimals are only used for display purposes: the contract keeps whole numbers of base units, and wallets and explorers convert them for you.
I created a plain BEP-20 test token on BNB Chain with a supply of 1,000,000,000 and 18 decimals. The contract stores that supply as a 1 followed by 27 zeros, and BscScan divides by 10 to the power of 18 to display 1,000,000,000.
How many decimals should a token have?
Most tokens copy the decimals of their chain's own coin. ETH has 18 decimals, as ethereum.org's guide to ether shows, and SOL has 9.
| Decimals | Who uses it | What it means |
|---|---|---|
| 0 | NFTs, tickets, items | Cannot be split. On Solana an NFT is a token with 0 decimals and a supply of 1. |
| 6 | Payment tokens such as USDC | Splits down to one millionth of a token. |
| 8 | Bitcoin | 1 BTC is 100,000,000 satoshis. |
| 9 | SOL and SPL tokens that match it | 1 SOL is 1,000,000,000 lamports. |
| 18 | ETH and most ERC-20 and BEP-20 tokens | The smallest piece of ETH is called a wei. |
The Solana figures for 0, 6 and 9 come from Metaplex's guide to SPL tokens. Each token stores its own decimals. The ERC-20 standard does not require a value, but most tokens use 18.
On Solana, decimals limit your maximum supply
Each Solana token's supply has a fixed top value (about 18.4 quintillion base units), so more decimals leave room for fewer whole tokens:
- 6 decimals: about 18.4 trillion tokens
- 9 decimals: about 18.4 billion tokens
- 18 decimals: about 18 tokens
A 1 billion supply on Solana fits with 9 decimals, the usual choice. On EVM chains the limit is far above any supply you would set.
Total, circulating and max supply
Price sites show three supply numbers for a token:
- Total supply: tokens that exist now.
- Circulating supply: tokens in public hands. Locked tokens, such as team tokens that unlock on a schedule (called vesting), are left out.
- Max supply: the most tokens that will ever exist. Some tokens have no max; Bitcoin's is a fixed supply of 21 million.
Circulating supply is at most the total supply, and total supply is at most the max supply. Market cap is the price times the circulating supply.
Fixed or mintable supply, and burning
Supply can grow only while someone still holds the right to mint. On Solana, the SPL Token program docs say that setting the mint authority to none is irreversible, so no more tokens can be minted. On EVM chains, supply can grow only if the contract has a mint function. Whoever holds an open mint can create more tokens, so buyers check for one before they buy.
Once minting is off, you cannot mint later for an airdrop or rewards, so plan those amounts before launch. Burning destroys tokens and lowers the supply.
Common mistakes with token supply and decimals
Thinking a bigger supply makes a token cheaper
Price per token is market cap divided by supply. For example, at the same $1,000,000 market cap:
| Supply | Price per token |
|---|---|
| 1,000,000,000 | $0.001 |
| 1,000,000 | $1 |
| 10,000 | $100 |
The project is worth the same in all three rows. Supply alone does not change what a token is worth, so you can pick any round supply, such as 1 billion.
Adding the zeros twice, or forgetting them
If you write your own contract, the mint amount is in base units. Minting 1,000,000 without multiplying by 10 to the power of the decimals leaves a balance that is a tiny fraction of one token. If you multiply twice, the supply ends up far too large. On a no-code form, you type whole tokens instead.
Trusting a balance shown with incorrect decimals
A token added to a wallet with the wrong decimals shows a balance that can be millions of times off. Trust Wallet's help page on custom-decimal scams explains how scammers use this to show fake balances. Add tokens by their contract address, and do not change the decimals field because someone tells you to.
What to do next
With a Tokenry token creator for an EVM chain, such as the BNB Chain token creator, or the Solana token creator, you type the supply in whole tokens and the tool adds the decimals (any value from 0 to 18). On EVM, a plain token is created with no owner and the full supply goes to your wallet, so the supply is fixed. If you need to mint later, turn on Mintable at creation, with an optional cap. On Solana, you can revoke mint authority at creation for free, or later with Revoke mint authority.
Related reading: what revoking mint authority means, what an SPL token is and ERC-20 vs BEP-20.
Do it with Tokenry


