Token Supply

Overview

Token supply is the quantity of token units defined, created, circulating, locked, burned, vested, treasury-held, bridged, or otherwise recognized at a specific time.

Common measures include maximum supply, total supply, circulating supply, fully diluted supply, minted supply, and accessible supply. Token Supply is a token-lifecycle mechanism implemented through contract code, protocol rules, governance, or issuer operations. For Token Supply, its effect should be measured from authoritative state changes and events rather than from an interface message or announcement.

Different sources can report different numbers because they treat burns, bridges, locked contracts, lost keys, treasury balances, and migrations differently. Token Supply should be tied to an exact asset, network, contract or mint, and implementation version. Similar names can describe different mechanics, such as reducing total supply versus sending tokens to an inaccessible address.

Risks include double-counted bridged units, hidden mint authority, stale indexes, incorrect decimals, misleading circulating estimates, and supply changes after upgrades. For Token Supply, time-dependent mechanics such as vesting and unlocks need timezone, block, cliff, beneficiary, and revocation rules. Off-chain announcements should be reconciled with the actual contract schedule.

Reports should define contract and chain, metric, timestamp, mint and burn events, bridges, vesting, treasury, inaccessible balances, and data methodology. For Token Supply, payment and custody systems should simulate or test unusual token behavior before support, including transfer fees, pauses, allowlists, rebases, callbacks, and upgradeable implementations. Exceptions need explicit reconciliation and refund rules.

Token Supply is closely related to Token Supply Dynamics and Stablecoin Supply, yet those concepts should remain separate in custody and accounting. A relationship to Token Supply through a ticker, wrapper, standard, or protocol does not create identical ownership or settlement rights.