Tokenomics is the topic of understanding the supply and demand characteristics of cryptocurrencies.
Join us in showcasing the cryptocurrency revolution, one newsletter at a time. Subscribe now to get daily news and market updates right to your inbox, along with our millions of other subscribers (that’s right, millions love us!) — what are you waiting for?
Key takeaways
Supply is three separate numbers. Circulating supply drives market cap, total supply includes locked tokens, and max supply is a ceiling many tokens do not have.
Dividing fully diluted value by market cap shows how much issuance is still ahead. Ethereum sat at 1.00 and Worldcoin at 2.63 on 7 October 2026.
A hard cap does not make a token deflationary. The emission and burn schedule decides that, not the presence of a ceiling.
Allocation and vesting decide who can sell and when, and the gap between circulating and total supply is the size of that question.
Every figure here comes from one request to an endpoint that needs no account and no API key.
What tokenomics means
Tokenomics is the study of how a crypto token's supply and demand are designed: how many units exist, how many more will be created, who holds them, when those holdings unlock, and what the token is for. The word is a contraction of "token" and "economics."
It gets its own term because crypto makes something visible that traditional money mostly hides. In the traditional economy, economists track the issuance of a currency through official money supply data, reported as M1, M2 and, depending on the country, M3 or M4. M1 measures the most liquid forms of money, M2 is less liquid, and so on. These aggregates exist because the quantity of money matters and someone has to publish it.
They matter because governments have always been able to create more currency, and have often had reason to. Running a state is expensive, raising revenue is unpopular, and issuing more money is politically easier than either. Bank bailouts and pandemic responses have both produced large, rapid increases in the money supply. The effect of that issuance on the value of the money already in circulation is what we call inflation, and it shows up as prices rising year after year.
Crypto tokens invert the visibility. Issuance is usually written into code and published in advance, so you can read the schedule rather than infer it. Changing that schedule is normally possible, but it requires broad agreement and is difficult to carry out, which is a different kind of guarantee from a central bank's discretion.
This guide covers what the numbers are, what they do and do not tell you, how the main design patterns work, and how to pull the figures for any token yourself.
What is a token?
A token is a digital unit on a blockchain that represents a specific asset or a particular use. The three broad categories are utility tokens, which give access to a product or network, governance tokens, which confer votes, and security tokens, which represent a legal claim on something and are regulated accordingly.
The distinction matters for tokenomics because each category creates demand differently. A utility token is wanted by people who want to use the thing. A governance token is wanted by people who want a say. A security token is wanted by people who want the underlying claim. A token that fits none of these categories cleanly has to generate demand some other way, and that is usually the hardest question to answer about it.
Supply is three numbers, not one
The single most common mistake in reading tokenomics is treating "supply" as one figure. CoinMarketCap tracks three, and they answer different questions.
Taking Bitcoin as of 7 October 2026:
Field | Value |
|---|---|
Circulating supply | 20,094,665 BTC |
Total supply | 20,094,665 BTC |
Max supply | 21,000,000 BTC |
Market cap | $1,690,567,355,844.53 |
Fully diluted market cap | $1,766,733,333,087.92 |
/v3/cryptocurrency/quotes/latest, 7 October 2026 at 07:10 UTC. Figures move; the method does not.Circulating equals total, so nothing is locked. Circulating is 95.69% of max, so roughly 4.3% of all Bitcoin that will ever exist has not been mined yet. Those three lines are a complete picture of Bitcoin's supply position, and they are all first-party data you can pull yourself.
"No max supply" comes in two flavours
A null max supply does not always mean the same thing, and the API distinguishes between them with a separate field.
max_supply: null and infinite_supply: true. There is no ceiling, by design.max_supply: null and infinite_supply: false. No ceiling is recorded, but the token is not declared uncapped either. In that case the total supply, 10,000,000,000 WLD, is the number doing the work, and the absence of a max is a gap in the stated design rather than a statement about it.max_supply: null as "unlimited" without checking infinite_supply gets the second case wrong.The total Bitcoin supply
In total, there will be 21 million Bitcoin. The last of it is expected around 2140. Until then the number of new coins created through mining halves roughly every four years, in an event called the halving, which was designed to produce scarcity on a published schedule.
Twenty-one million sounds large until you set it against a world population in the billions. That ratio is why Bitcoin is often compared to gold and described as hard money.
As the first cryptocurrency, its issuance model set a pattern others followed. Checked against live data on 7 October 2026:
Asset | Max supply | Circulating | Circulating as % of max | Market cap |
|---|---|---|---|---|
Bitcoin | 21,000,000 | 20,094,665 | 95.69% | $1,690,567,355,844.53 |
Bitcoin Cash | 21,000,000 | 20,099,603.13 | 95.71% | $6,060,459,037.25 |
Zcash | 21,000,000 | 16,905,130.17 | 80.50% | $22,295,142,682.54 |
Litecoin | 84,000,000 | 77,692,373.38 | 92.49% | $5,178,884,397.59 |
/v3/cryptocurrency/quotes/latest, 7 October 2026 at 13:22 UTC. Bitcoin's figures are from the 07:10 UTC call above. Percentages computed from the returned supply fields.Bitcoin Cash and Zcash adopted the same 21 million ceiling. Litecoin used the same framework with a larger number, 84 million, exactly four times Bitcoin's. The design choice is portable; what it produces depends on everything else about the network.
Uncapped supply: Dogecoin and Grin
Other coins were designed with no ceiling at all.
max_supply: null and infinite_supply: true. Its market cap was $14,181,094,034.66. New coins keep being issued, which makes it inflationary in supply terms rather than deflationary like Bitcoin. Supporters have long argued that this is what makes it usable as a currency rather than held as a store of value.Grin was built on a similar premise, with a constant emission intended to keep the price stable enough for everyday use. On 7 October 2026 it was still listed and still active, with a circulating supply of 243,115,500 GRIN, a market cap of $3,093,731.45 and a CoinMarketCap rank of 1,466. Whether the design achieved what it set out to is a judgement rather than a data point; the figures are what the figures are.
max_supply: null with infinite_supply: false, so its total supply is the number carrying the meaning.infinite_supply: true.Market cap and fully diluted value
Market capitalization is circulating supply multiplied by price. Fully diluted value, usually shortened to FDV, is the same calculation run against the maximum or total supply instead.
The gap between them is the clearest single signal in tokenomics, because it tells you how much issuance is still ahead.
Token | FDV / market cap | Circulating | Total | Market cap | FDV |
|---|---|---|---|---|---|
Ethereum | 1.00 | 122,113,300.64 | 122,113,300.64 | $319,509,077,349.86 | $319,509,077,349.86 |
Bitcoin | 1.05 | 20,094,665 | 20,094,665 | $1,690,567,355,844.53 | $1,766,733,333,087.92 |
Pyth Network | 1.27 | 7,874,959,211.10 | 9,999,981,857.42 | $575,811,131.02 | $731,192,525.04 |
Arbitrum | 1.47 | 6,785,574,605 | 10,000,000,000 | $1,279,395,301.04 | $1,885,463,465.54 |
Optimism | 1.87 | 2,299,624,975 | 4,294,967,296 | $279,180,832.23 | $521,420,908.69 |
Jupiter | 2.07 | 3,319,369,204.37 | 6,862,435,229.58 | $1,104,570,648.72 | $2,283,579,820.94 |
Sui | 2.43 | 4,118,270,447.64 | 10,000,000,000 | $4,695,401,401.66 | $11,401,391,582.59 |
Worldcoin | 2.63 | 3,801,080,833.24 | 10,000,000,000 | $2,001,658,311.28 | $5,266,024,057.62 |
/v3/cryptocurrency/quotes/latest for all eight tokens, 7 October 2026 at 07:10 UTC. Ratios computed from the returned market_cap and fully_diluted_market_cap fields.Ethereum sits at exactly 1.00 because its circulating and total supply are the same number: there is no reserved tranche waiting to be released. Bitcoin sits slightly above 1.00 because the remaining 4.3% is still being mined, on a schedule published in 2009.
Worldcoin at 2.63 means that if every token in the total supply were in circulation at the same price, the token's aggregate value would be 2.63 times its current market cap. That is not a prediction about price. It is a statement about how much supply is still to come, and it is the question most worth asking before reading anything else about a token.
Which denominator the FDV uses matters
For most tokens, total supply and max supply are the same number, so FDV is unambiguous. For some they are not, and the difference is large.
Aptos, on the same date, had a circulating supply of 871,331,815.51, a total supply of 1,209,772,014.39 and a max supply of 2,100,000,000. Circulating is 72.02% of total but only 41.49% of max. Those are two defensible answers to "how much of the supply is out?" and they are thirty points apart.
When a token's total and max differ, check which one a given figure was calculated against before comparing it to anything.
Emissions and burns
Supply is a snapshot. Emissions are the schedule that moves it.
Bitcoin's emission rate halves roughly every four years, which is why its issuance curve flattens over time. The schedule is fixed in the protocol and has been followed since launch. At the other end, Ethereum, Dogecoin and TRON have no maximum supply at all, and new units keep being created.
Whether uncapped issuance is a problem depends on what else is happening to the supply, which is where burns come in. A burn permanently removes tokens from circulation, usually by sending them to an address nobody controls. Protocols burn for different reasons: to offset issuance, to return value to holders, or as a byproduct of transaction fees. Where a burn is tied to usage, the supply shrinks faster when the network is busier.
BNB is the clearest live example of a burn programme showing up in the supply fields. On 7 October 2026 it reported a max supply of 133,158,903.55 and a circulating supply of 133,158,901.33, with a market cap of $102,111,071,768.14. The max supply is not a round number because it is not the original ceiling: repeated burns have reduced it, and the published cap moves down as they happen. Circulating is within three tokens of that ceiling.
max_supply field looks the same kind of thing in both cases and means something quite different.The practical consequence is that "inflationary" and "deflationary" are not properties you can read off a max supply field. A token with no cap and an aggressive fee burn can shrink. A token with a hard cap and most of its supply still locked can dilute holders heavily for years. The schedule tells you more than the ceiling does.
Allocation, vesting and distribution
Who holds the supply, and when they can sell, is the part of tokenomics least visible in the price and most likely to move it.
Most tokens launched in the last several years allocate their supply across named buckets: a public float, a team allocation, early investors, an ecosystem or treasury fund, and community incentives. Each bucket usually carries a vesting schedule, meaning the tokens exist but cannot be transferred until a set date or milestone.
The gap between circulating and total supply is the aggregate of everything not yet unlocked. Sui at 41.18% of its total supply in circulation means roughly 59% is somewhere else, on a schedule. Finding that schedule means going to the project's own documentation; the API gives you the size of the question, not the answer.
Vesting schedules
A vesting schedule determines how and when allocated tokens become transferable for investors, team members and advisors. The traditional form is a fixed period, often with a cliff at the start: nothing unlocks for a set time, then a large tranche releases at once.
Many projects now use schedules that respond to conditions rather than only to the calendar. Unlocks can be tied to milestones, to governance decisions, or to the delivery of a product, so that tokens release faster when a project is hitting its targets and slower when it is not. The intent is to tie the availability of insider supply to whether the thing being built actually works.
Community incentives
A growing share of token supply is now directed at users rather than investors, through airdrops, contributor rewards, referral programmes and retroactive grants.
Retroactive distribution is the pattern that has spread furthest: people who used a protocol before it had a token are allocated one afterwards, on the basis of what they actually did. It rewards usage that happened without the promise of a reward, which is a different selection of recipients from a sale or a public launch.
For tokenomics purposes the thing to watch is what share of supply these programmes consume and over what period, because incentive emissions are issuance like any other. A protocol paying for its growth in tokens is diluting holders to do it, and whether that is worth it depends on whether the users it attracts stay once the rewards stop.
Ecosystem and treasury funds
Many projects reserve a significant portion of supply for an ecosystem fund: a treasury earmarked for grants, partnerships, developer support and incentives for applications built on the protocol.
Allocation from these funds is often decided by token holders or by a council elected by them, which makes the treasury both a tokenomics item and a governance one. The size of the fund tells you how much supply sits outside the market; the rules for spending it tell you how fast that can change and who decides.
Token utility models
Supply mechanics describe one half of the equation. The other half is whether anyone needs the token.
Gas and fees
The token is required to use the network. Every transaction on Ethereum consumes ETH, which creates demand that scales with usage rather than with sentiment. This is the most direct link between a network doing well and its token being wanted, because the demand is mechanical rather than discretionary.
Staking and yield
Holders lock tokens to help secure a proof-of-stake network, validate transactions or provide liquidity, and receive rewards for doing so. Yield farming is the active version, moving tokens between protocols in search of a higher return.
Staking does two opposite things to supply at once, which is why it is often misread. It reduces the liquid float for as long as the lock lasts, and the rewards paid out are themselves new issuance. Whether the net effect tightens or loosens supply depends on the reward rate against the share of supply staked, and both numbers move.
Governance
Holding the token confers votes over protocol decisions, treasury spending and upgrades. In decentralized autonomous organizations the token is the mechanism of representation, and voting power usually scales with holdings.
That proportionality is also the main criticism, since it concentrates influence with the largest holders. Some projects use quadratic voting, which makes additional votes progressively more expensive, or delegation, which lets small holders assign their votes to someone who follows the proposals. Governance creates real demand where the decisions being voted on have real economic consequence, and much less where they do not.
Access to products and services
A token can act as a key. Holding it may unlock premium features, entry to a community, allocation in a sale, or access to tools that non-holders cannot use.
This borrows the logic of a membership scheme and changes who controls it: access is granted by holding a transferable asset rather than by a subscription a company can revoke. For tokenomics the question is whether the thing behind the gate is worth holding the token for, because access-based demand lasts exactly as long as that stays true.
Dual-token economies in GameFi
Games and similar high-activity applications often split these roles across two tokens rather than asking one token to do everything.
Separating them keeps a surge of in-game activity from translating directly into control of the project, and keeps governance decisions from being priced by the cost of an in-game item. The difficulty is that two linked economies are harder to balance than one. Projects commonly add token sinks, which permanently remove utility tokens from circulation, and conversion routes between the two tokens under defined conditions. Where the sinks are too weak, the utility token inflates until it stops being worth earning, which is the characteristic failure of the model.
Tokenomics and real-world assets
Tokenizing real-world assets, usually shortened to RWAs, applies token mechanics to things that exist off-chain: real estate, commodities, treasury bills, invoices and collectibles.
Fractional ownership of physical assets
Assets that are normally illiquid and indivisible can be represented as tokens and split into small units. A building, a parcel of farmland or a holding of gold can be divided among many holders, each able to trade their share without the whole asset changing hands. The practical effects are a lower entry threshold and faster settlement than the traditional process allows.
Regulatory compliance as a design constraint
Because an RWA token is a claim on something a legal system already recognises, its design has to accommodate that system. Projects in this area deal with securities law, investor eligibility and custody requirements, and those obligations end up inside the token itself: transfers restricted to approved addresses, identity checks built into the issuance process, and programmatic limits reflecting local rules.
Tokens structured this way are usually securities rather than utility tokens, carrying rights to real-world income or ownership. Compliance is a tokenomics parameter here in a way it is not elsewhere, because it determines who is allowed to hold the token at all, which bounds the demand side directly.
Where on-chain and traditional finance meet
RWAs are the point where the two systems touch. Protocols have begun accepting tokenized treasury bills and similar instruments as collateral, which gives an on-chain position a yield that comes from outside crypto. Traditional institutions, in turn, have been testing blockchain settlement for assets they already issue.
For tokenomics the consequence is that a token's value drivers can include things that have nothing to do with crypto cycles, such as interest rates or the credit quality of an underlying borrower. CoinMarketCap tracks this category directly through its Real-World Assets data.
Tokenomics in DePIN networks
Decentralized physical infrastructure networks, or DePIN, use token incentives to get real-world hardware deployed without a company deploying it.
Participants contribute physical resources: wireless coverage, storage, computing power, or sensor data. In exchange they earn tokens, typically in proportion to verified contribution. The effect is to replace capital expenditure with issuance, so a network can expand as fast as people are willing to supply equipment rather than as fast as a balance sheet allows.
The tokenomics question specific to DePIN is whether the token's value can support the rewards. Early on, the rewards are paid in a token whose price is driven mostly by expectation. For the network to persist, revenue from people actually using the infrastructure has to grow into the gap before the rewards stop being worth the hardware and electricity.
Governance tends to be on-chain for the same reason it is elsewhere: reward rates, hardware standards and network rules all change over time, and the people operating the equipment have a direct stake in how they change.
Tokenomics and what a token could be worth
Supply figures also set the arithmetic limits on comparisons between tokens, which is where a lot of informal reasoning goes wrong.
Take two assets from the tables above. Bitcoin Cash has the same 21,000,000 ceiling as Bitcoin, so the thought "this could one day be priced like Bitcoin" is at least arithmetically coherent: the supply would support it, and whether it happens is a question about adoption.
TRON is a different case. With a circulating supply of 94,985,851,503.92 on 7 October 2026, a price in the thousands of dollars per token would imply an aggregate value larger than any company that has ever existed. That is not a claim about whether TRON is a good network. It is arithmetic: the supply decides what a given price per unit implies about total value, and very large supplies put very high unit prices out of reach regardless of anything else.
This is the most practical everyday use of tokenomics. Before asking whether a token will reach a price, multiply that price by the supply and see what total value it implies. If the answer is implausible, the price is too.
How to check any token's tokenomics yourself
/public-api path prefix.curl "https://pro-api.coinmarketcap.com/public-api/v3/cryptocurrency/quotes/latest?symbol=BTC&convert=USD"
The fields that matter for tokenomics come back in the same response:
{
"data": [
{
"id": 1,
"name": "Bitcoin",
"symbol": "BTC",
"cmc_rank": 1,
"circulating_supply": 20094665,
"total_supply": 20094665,
"max_supply": 21000000,
"infinite_supply": false,
"self_reported_circulating_supply": null,
"quote": [
{
"symbol": "USD",
"price": 84130.15871847219,
"market_cap": 1690567355844.528,
"fully_diluted_market_cap": 1766733333087.92,
"market_cap_dominance": 59.0611
}
]
}
],
"status": { "error_code": "0", "error_message": "" }
}
A short script turns that into the two ratios worth looking at:
import json
import urllib.request
BASE = "https://pro-api.coinmarketcap.com/public-api"
def tokenomics(symbol, convert="USD"):
url = f"{BASE}/v3/cryptocurrency/quotes/latest?symbol={symbol}&convert={convert}"
request = urllib.request.Request(url, headers={"Accept": "application/json"})
with urllib.request.urlopen(request, timeout=15) as response:
payload = json.load(response)
# error_code is "0" as a string on this route and 0 as a number on others.
if str(payload["status"]["error_code"]) != "0":
raise RuntimeError(payload["status"].get("error_message") or "CMC error")
# Several assets can share a ticker. Keep the highest-ranked one.
def rank(asset):
return asset["cmc_rank"] if asset["cmc_rank"] is not None else float("inf")
asset = min(payload["data"], key=rank)
quote = next(q for q in asset["quote"] if q["symbol"] == convert)
circulating = asset["circulating_supply"]
total = asset["total_supply"]
market_cap = quote["market_cap"]
fdv = quote["fully_diluted_market_cap"]
return {
"name": asset["name"],
"circulating_supply": circulating,
"total_supply": total,
"max_supply": asset["max_supply"],
"infinite_supply": asset["infinite_supply"],
"percent_of_total_circulating": (
100 * circulating / total if total else None
),
"fdv_to_market_cap": fdv / market_cap if market_cap else None,
}
if __name__ == "__main__":
for ticker in ("BTC", "ETH", "SUI", "WLD"):
print(tokenomics(ticker))
Two details in that script are there for a reason.
error_code as a string. The field arrives as "0" on this route and as 0 on others. A check against one type passes on some endpoints and fails on others.DOGE on 7 October 2026 returned twenty-four assets, all carrying the symbol DOGE, including several unrelated tokens with near-zero market caps and one reporting a fully diluted value of $2.79 x 1017. Dogecoin itself was among them at rank 11. Sorting on cmc_rank picks the asset almost everyone means; querying by the numeric id instead removes the ambiguity entirely.Read the numbers with some care
Reported supply figures are maintained data, and they occasionally disagree with each other. On the date of these calls, TRON returned a circulating supply of 94,985,851,503.92 and a total supply of 94,985,842,761.83, which puts circulating about 8,742 tokens above total. The two fields are produced by different processes and can drift apart slightly. Where a derived figure looks implausible, check the inputs before building an argument on it.
self_reported_circulating_supply and self_reported_market_cap, which are populated from project submissions rather than independently verified. Where they are present and differ from the standard fields, the gap is itself worth noticing.Putting it together
A tokenomics read on any token comes down to four questions, and the first three are answerable from one API call:
- How much supply exists, and how much more is coming? Circulating, total and max, plus whether
infinite_supplyis set. - How much dilution is still ahead? The ratio of FDV to market cap, checked against which denominator was used.
- Who holds what is not circulating, and when does it unlock? The size of the gap comes from the API. The schedule comes from the project's own documentation.
- Does using the product require the token? This one is not a number. It is the question the numbers exist to inform.
A hard cap is not automatically good and uncapped issuance is not automatically bad. Bitcoin's cap matters because its emission schedule is credible and its holders are dispersed. An uncapped token with a fee burn tied to real usage can be tighter in practice than a capped token with 60% of its supply vesting to insiders over two years.
FAQ
What is tokenomics in simple terms?
It is the design of a token's supply and demand: how many units exist, how many more will be created and on what schedule, who holds them, when locked holdings unlock, and what the token is used for.
What is the difference between circulating, total and max supply?
Circulating supply is what is available in the market now, and it is what market capitalization is calculated from. Total supply is everything that exists, including locked and reserved tokens, minus anything burned. Max supply is the protocol's hard ceiling, which many tokens do not have.
What is FDV, and what does it tell you?
Fully diluted value is price multiplied by the maximum or total supply rather than the circulating supply. Dividing FDV by market cap gives you how much issuance is still ahead. A ratio of 1.00 means everything is already circulating. Sui stood at 2.43 on 7 October 2026, meaning its total supply was roughly 2.4 times its circulating supply.
Does a hard max supply make a token deflationary?
No. A capped token with most of its supply still vesting can dilute holders for years, and an uncapped token with a fee burn tied to usage can shrink. The emission and burn schedule determines the direction, not the presence of a ceiling.
What does it mean when max supply is null?
infinite_supply alongside it. Ethereum, Dogecoin and TRON return a null max supply with infinite_supply: true, meaning there is no ceiling by design. Worldcoin and Grin return a null max supply with infinite_supply: false, meaning no ceiling is recorded but the token is not declared uncapped either.Can a max supply change?
It can. BNB reported a max supply of 133,158,903.55 on 7 October 2026, which is not a round number because repeated burns have reduced it from the original ceiling. A cap that moves down over time is a different mechanism from a cap fixed at launch, even though both appear in the same field.
Where do I find a token's vesting schedule?
The API gives you the size of the locked portion, as the gap between circulating and total supply. The schedule itself comes from the project's own documentation, which is where allocation buckets, cliffs and unlock dates are published.
What is a dual-token model?
Two tokens splitting the work: a high-velocity utility token used for transactions inside a game or application, and a scarcer governance token carrying votes. The split keeps a surge of in-app activity from translating into control of the project, at the cost of having two linked economies to balance.
Can I check a token's tokenomics without an API key?
/v3/cryptocurrency/quotes/latest is available through CoinMarketCap's Keyless Public API, which takes a GET request with no account, no key and no authentication header. Every figure in this article came from that endpoint.Why does one ticker return several different tokens?
DOGE on 7 October 2026 returned twenty-four assets all carrying that symbol, with Dogecoin itself at rank 11. Sort on cmc_rank and keep the highest-ranked, or query by the numeric CoinMarketCap id to remove the ambiguity.[STANDARD EDITORIAL DISCLAIMER]
