Build and Backtest Tokenomist API
Tokenomist

Total Supply

Total supply is the number of tokens that currently exist — all tokens that have been minted minus any tokens that have been permanently burned. It is the universal denominator for allocation percentages and the base for Tokenomist's Released Progress bar.
TradFi parallel — Like a company's total shares outstanding — all shares that have been issued and still exist, including restricted shares held by insiders and treasury shares, minus any shares that have been retired or cancelled.

Key Takeaways

  • 01
    Formula: Total Supply = Minted Tokens - Burned Tokens — counts every token that currently exists regardless of its lock status
  • 02
    Supply hierarchy: Circulating Supply ≤ Total Supply ≤ Max Supply — total supply sits between the freely tradeable subset and the theoretical lifetime cap
  • 03
    Tokenomist uses total supply as the denominator for allocation percentages and the base for the Released Progress bar on token detail pages
  • 04
    Total supply changes over time: it increases when new tokens are minted (inflation, staking rewards) and decreases when tokens are burned
  • 05
    For tokens with no burn mechanism and a fixed genesis mint, total supply equals max supply from day one (e.g., XRP's 100 billion pre-minted tokens)

How It Works

Total supply answers a simple question: how many tokens exist right now? The formula is Total Supply = Minted Tokens minus Burned Tokens. Every token that a protocol has ever created through genesis allocation, mining rewards, staking rewards, or inflationary minting counts toward total supply. Every token that has been permanently destroyed through a burn mechanism is subtracted. The result is the current number of tokens in existence, regardless of whether they are locked, vesting, circulating, or staked. Total supply sits in the middle of the supply hierarchy. It is always greater than or equal to circulating supply, because circulating supply counts only the subset of tokens freely available for trading — excluding locked, vesting, and insider-held tokens. Total supply is always less than or equal to max supply (when a max supply exists), because max supply represents the theoretical lifetime cap that the protocol will never exceed. For tokens like Bitcoin, where not all coins have been mined yet, total supply is less than max supply. For tokens like BNB, where periodic burns reduce the number of existing tokens, total supply decreases over time. On Tokenomist, total supply serves as the denominator for allocation percentages displayed on token detail pages. When a token page shows that 20% is allocated to the team, 15% to investors, and 10% to the ecosystem fund, those percentages are calculated against total supply. The Released Progress bar also uses total supply as its base, showing what fraction of all existing tokens have been released from their locked state. This makes total supply the foundational reference point from which all other supply metrics on Tokenomist derive their context.

Real World Examples

Bitcoin: Total Supply Below Max Supply
View →
Bitcoin has a max supply of 21 million BTC, but its total supply is approximately 19.8 million — the rest has not yet been mined. New BTC enters total supply with each block reward (currently 3.125 BTC per block after the 2024 halving), and no BTC has ever been burned. Total supply will asymptotically approach but never exceed 21 million.
Ethereum: Fluctuating Total Supply from Burns
View →
Ethereum has no max supply, so its total supply is determined by the balance between new ETH issued as staking rewards and ETH burned through EIP-1559. During high network activity, more ETH is burned than issued, causing total supply to decrease — making Ethereum occasionally deflationary. Tokenomist tracks this dynamic on the Ethereum token detail page.
BNB: Decreasing Total Supply Through Quarterly Burns
View →
BNB launched with 200 million tokens and has been systematically reducing its total supply through quarterly auto-burn events. Binance aims to reduce total supply to 100 million BNB over time. Each burn permanently removes tokens, so BNB's total supply is a moving target that decreases with each burn cycle.
Solana: Total Supply Growing from Staking Rewards
View →
Solana's total supply increases continuously as staking rewards mint new SOL tokens. While a portion of transaction fees are burned, the net effect is inflationary — total supply grows over time. On Tokenomist, this growth rate is visible in the emission schedule, helping investors assess the dilution impact of ongoing issuance.
XRP: Total Supply Equals Genesis Mint Minus Burns
View →
Ripple pre-minted 100 billion XRP at genesis with no further minting mechanism. Each XRP transaction burns a tiny fee, so total supply slowly decreases from 100 billion over time. The vast majority remains in escrow or company wallets, making the gap between total supply and circulating supply exceptionally large.

Frequently Asked Questions

What is the difference between total supply and circulating supply?
Total supply counts every token that exists — locked, vesting, staked, and freely tradeable. Circulating supply counts only the subset that is available for open market trading. A token can have 1 billion total supply but only 300 million circulating if 700 million tokens are locked in vesting contracts, staking, or insider wallets.
What is the difference between total supply and max supply?
Total supply is the number of tokens that exist right now. Max supply is the theoretical maximum that will ever exist. For Bitcoin, total supply is approximately 19.8 million (mined so far) while max supply is 21 million (the hard cap). Some tokens like Ethereum have no max supply at all, so total supply can grow indefinitely.
Can total supply decrease?
Yes, through token burns. When a protocol permanently destroys tokens — whether through fee burns (Ethereum's EIP-1559), scheduled burns (BNB quarterly burns), or buyback-and-burn programs — total supply decreases. Tokenomist tracks burn events and their impact on total supply through the token detail page and Burn Screener.
Why does Tokenomist use total supply as the base for allocation percentages?
Total supply represents all tokens that currently exist, making it the natural denominator for showing how those tokens are distributed across stakeholder groups — team, investors, ecosystem, community, and treasury. Using circulating supply would exclude locked allocations, and using max supply would include tokens that do not yet exist.

Related Terms

Track on Tokenomist

Supply-side analysis for educational purposes. Not financial advice. Verify assumption and precision labels on the relevant token page.
Tokenomist
Tokenomist.ai provides a complete solution for supply-side tokenomics data. Analyze future token emissions, track vesting schedules, and compare standardized tokenomics and allocation across projects to gain actionable insights