> ## Documentation Index
> Fetch the complete documentation index at: https://docs.theblockchainlibrary.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Total Supply

> Total supply refers to the aggregate number of tokens currently in existence for a specific blockchain project or cryptocurrency. This figure includes all tokens that have been minted, mined, or created, minus any that have been verifiably burned or destroyed. It encompasses toke

# Total Supply

Total supply refers to the aggregate number of tokens currently in existence for a specific blockchain project or cryptocurrency. This figure includes all tokens that have been minted, mined, or created, minus any that have been verifiably burned or destroyed. It encompasses tokens that are currently in circulation as well as those that may be locked in smart contracts, held in reserve by development teams, or vested for early investors and stakeholders. It serves as a static snapshot of the protocol's current maximum potential reach.

## Definition

Total supply refers to the aggregate number of tokens currently in existence for a specific blockchain project or cryptocurrency. This figure includes all tokens that have been minted, mined, or created, minus any that have been verifiably burned or destroyed. It encompasses tokens that are currently in circulation as well as those that may be locked in smart contracts, held in reserve by development teams, or vested for early investors and stakeholders. It serves as a static snapshot of the protocol's current maximum potential reach.

## Simple explanation

Think of total supply like the total number of limited-edition trading cards ever printed. If a company prints 1,000 cards, that is the total supply. Even if some are hidden in a drawer or held by the company, they still exist. Knowing this number helps you understand how rare or common a digital item is, which is important because if there are too many items, each one might be worth less.

## Why it matters

Understanding the total supply is critical for calculating market capitalization and assessing the scarcity of an asset. Investors use this metric to determine the potential dilution of their holdings and to predict how future token releases might impact market price stability.

## How it works

The total supply is defined by the blockchain protocol’s source code, often dictated by smart contracts or consensus rules that govern token issuance. As new tokens are minted through proof-of-work mining or proof-of-stake rewards, the total supply increases over time. Conversely, if a protocol implements a burn mechanism, the tokens are sent to an unspendable address, permanently removing them from the total supply.

## Real-world example

Bitcoin has a hard-coded total supply limit of 21 million BTC, which is enforced by the network's consensus rules, ensuring that no more than this amount can ever exist regardless of demand or mining activity.

## Advantages

* Provides clear visibility into asset scarcity
* Enables accurate market capitalization calculations
* Helps investors gauge potential future dilution

## Limitations

* Does not account for lost or inaccessible wallets
* Can be confused with circulating supply
* May not reflect future inflation schedules

## Common misconceptions

* Many people believe total supply is the same as circulating supply, but total supply includes locked tokens that aren't currently tradeable.
* Some assume the total supply is fixed for every project, whereas many protocols have infinite supply caps with variable inflation rates.

## Related knowledge

* [Circulating Supply](/generated/v2/glossary/circulating-supply) — term
* [Inflation](/generated/v2/glossary/inflation) — term
* [Max Supply](/generated/v2/glossary/max-supply) — term

***

**Canonical knowledge ID:** `glossary:total-supply`