Skip to content
HeroRPC

GUIDETokenomics, 6 chapters

Tokenomics explained: how to design the supply of your coin

Tokenomics is the plan for how many coins exist, how new ones are made and who gets them. Bitcoin's plan fits in one sentence: 21 million coins, with the reward cut in half every four years. This guide shows how to design yours, with real numbers from Bitcoin, Litecoin and Dogecoin, and a worked example you can copy.

Updated
Read
12 min

Where do you want to start?

In this guideThe short answer

Quick answer

The short answer

Tokenomics is the economic design of a coin: its maximum supply, how new coins are created (block rewards and halvings), who gets coins at launch (a premine, if any), and when locked coins are released (vesting). For a coin with its own blockchain, most of it is set in the chain's supply rules, so it is hard to change once people use the coin.

The five tokenomics decisions
DecisionThe questionBitcoin's answer
Supply capWill there be a maximum number of coins?Yes, slightly less than 21 million
EmissionHow are new coins made?A block reward for miners
HalvingDoes the reward shrink over time?Yes, cut in half every 210,000 blocks
Launch distributionDoes anyone get coins on day one?No premine
VestingAre some coins locked and released later?None, there is no premine to lock

Each of these changes how the coin behaves for years. Here they are with real numbers.

CHAPTER 01

Supply: a hard cap or a supply that keeps growing

Bitcoin has a cap. Dogecoin does not. Both work, and each tells a different story to your community.

First, three terms that sites use for supply. CoinGecko defines them in its supply methodology:

  • Ceiling

    Max supply

    The most coins that can ever exist, coded into the rules. Some coins have none.

  • Created so far

    Total supply

    Coins created, minus any that were permanently removed (burned).

  • Trading now

    Circulating supply

    The part that is actually available. Locked and vesting coins are left out.

Now three real coins with three different answers. The numbers come from each coin's own rules:

Supply rules of three coins
Chain pageBitcoinLitecoinDogecoin
Maximum supplySlightly less than 21 millionAbout 84 million (50 coins x 840,000 blocks x 2)No cap
Block time target10 minutes2.5 minutes1 minute
Halving interval210,000 blocks840,000 blocksHalved up to block 600,000, then a constant reward
Current reward rule3.125 coins since April 2024Halves every 840,000 blocks10,000 coins per block, from block 600,000

Bitcoin from the Bitcoin Wiki and bitcoin.org. Litecoin and Dogecoin from their Core source code on GitHub. The Litecoin cap is our own sum from those rules: 50 x 840,000 is 42 million for the first period, and the periods that follow add up to the same again.

  • A hard cap

    Scarcity is the promise

    People can check that no more coins will ever be made. Good for a store-of-value story.

  • No cap

    Steady rewards are the promise

    Miners are always paid, and new coins keep arriving at a known pace. Good for a coin meant for spending and tips.

Quick check: A coin pays miners a constant reward forever, with no maximum. What is that coin's max supply?

CHAPTER 02

Emission: how new coins are made, and halvings

New coins come from block rewards. A halving cuts the reward on a schedule. Bitcoin's full history, with dates.

On a proof of work chain, the block reward is the number of new coins paid to whoever adds a block. A halving is a scheduled cut of that reward by half. Bitcoin halves every 210,000 blocks, about every four years. Here is every cut so far, from the Bitcoin Wiki:

Bitcoin's block reward historytimeline
  1. 3 January 2009

    50 coins

    Block 0: where it all started.

  2. 28 November 2012

    25 coins

    The first halving, at block 210,000.

  3. 9 July 2016

    12.5 coins

    The second halving, at block 420,000.

  4. 11 May 2020

    6.25 coins

    The third halving, at block 630,000.

  5. 20 April 2024

    3.125 coins

    The fourth halving, at block 840,000.

The next ones are estimated, because the date depends on how fast blocks actually arrive: 1.5625 coins around 2029, 0.78125 around 2033 and 0.390625 around 2037. The Bitcoin Wiki estimates the last coin will be mined around 2140.

Proof of stake coins pay validators in a different way, but the same questions apply: how many new coins per year, and does the rate fall? The supply calculator below works for any of these. Pick a preset, or type your own rules:

Coin supply calculator

Start from

A block every 10 minutes, 50 coins at first, halving every 210,000 blocks (about 4 years). Ends near 21 million.

How often a new block is found. Shorter means faster payments.

New coins paid to the miner or validator of each block at launch.

The reward is cut in half this often. Use 0 for a reward that never changes.

Coins created at launch before anyone mines. Use 0 for a fair launch.

A hard limit on all coins ever created. Leave empty for no limit.

Coins in existence, by years since launch

08M16M24M010203040 yrs99 percent by year 27
Coin supply every 5 years
YearCoins in existence
00
511,820,000
1017,070,000
1519,365,000
2020,345,625
2520,714,063
3020,877,656
3520,949,141
4020,979,609
After 1 year
2,628,000
After 4 years
10,506,000
Final supply
21,000,000
99 percent mined by
Year 27

About 144 blocks a day, 7,200 new coins a day at the starting reward.

Try these rules on a real chain: open the blockchain builderSource

CHAPTER 03

Inflation: work out how fast supply grows

Inflation here means new coins as a share of the coins that exist. It is simple arithmetic from your rules.

For a coin, inflation is simply how much the supply grows in a year, as a share of the supply that exists at the start of that year. The formula needs three numbers: blocks per year, reward per block, and the supply so far.

  1. Blocks per year = 365 days x 24 hours x 60 minutes, divided by the block time in minutes. At 10 minutes that is 52,560.
  2. New coins per year = blocks per year x reward per block.
  3. Inflation = new coins per year divided by the supply at the start of the year.
Bitcoin's yearly inflation at the start of each reward period
Period starts atRewardSupply at that blockNew coins a yearGrowth in a year
Block 210,0002510,500,0001,314,00012.5 percent
Block 420,00012.515,750,000657,0004.2 percent
Block 630,0006.2518,375,000328,5001.8 percent
Block 840,0003.12519,687,500164,2500.8 percent

Worked out from the reward history above, assuming a block exactly every 10 minutes. Real blocks arrive a little faster or slower, so real figures differ slightly. The supply at each block is each earlier reward times 210,000 blocks, added up.

See the pattern: each halving roughly halves the inflation rate, because the same supply is getting half as many new coins. A coin with a constant reward behaves differently, and Dogecoin shows how:

Dogecoin: the same issuance, a falling rate
If the supply isNew coins a yearGrowth in a year
100 billion5,256,000,0005.3 percent
150 billion5,256,000,0003.5 percent
200 billion5,256,000,0002.6 percent

Example supplies, not Dogecoin's current supply. Issuance is 10,000 coins x 1,440 one-minute blocks a day x 365 days, from the Dogecoin Core code.

The number of new coins stays the same, but the rate keeps falling as the supply grows. So a constant reward is not the same as constant inflation. That is useful when you talk to your community: you can say exactly how much supply will grow, and why the rate shrinks.

Quick check: A coin keeps the same block time. Which change halves the number of new coins made each year?

CHAPTER 04

Distribution: who gets coins at launch

Fair mining, a premine, a team share: each is a trust choice. Disclose it, or expect the community to find it.

There are only a few ways coins can reach people at the start, and a coin can mix them:

  • Open

    Mined or earned

    Everyone has the same chance. Bitcoin works this way, with no premine.

  • Planned

    A premine

    Some coins are created at launch for the founders, a treasury or a giveaway. Fine when small and public.

  • Split

    A mix

    A small premine to fund the project, with the rest earned by miners or validators.

The premine is where trust is won or lost. Communities accept a small one that is explained. They walk away from a large hidden one, and on a public chain it is easy to find, because every wallet is visible on the explorer. The honest way is to disclose it first:

  • Say the size as a share of the total, on your website, before launch.
  • Say what it is for: development, hosting, a reserve, a giveaway.
  • Publish the wallet addresses, so anyone can watch them on the explorer.
  • Send it to a wallet you control, never to an exchange deposit address.
  • Say what you will not do, for example that you will not sell the founder share for a set time.

Here is how that looks in a table. This is a made-up coin, shown only as an example:

Example: how a hypothetical coin could split its first two years of supply
Who gets itHowCoinsShare
MinersBlock rewards over the first two years10,512,00091.3 percent
FoundersPremine, in a wallet published on the explorer1,000,0008.7 percent

Example: not a real coin. 10,512,000 comes from a 10 coin reward x 1,051,200 blocks (two years of one-minute blocks). The worked example in chapter 6 explains the whole schedule.

CHAPTER 05

Vesting and lockups, in plain words

A way to promise that founders and early backers cannot dump their coins on day one.

A lockup holds some coins back. Vesting is the schedule that releases them. Both aim at the same worry: that the people who got coins early will sell them all at once and the price will fall. CoinGecko's guide to vesting schedules describes the two pieces most schedules use:

  • The wait

    A cliff

    A period when nothing is released. Someone who leaves before the cliff ends gets nothing.

  • The release

    Linear vesting

    After the cliff, coins are released in even amounts at regular intervals.

CoinGecko gives one example: a project reserved 15 percent of its token supply for the team, and released it evenly over one year, at about 1.25 percent of the total supply each month. Locked and vesting coins also stay out of the circulating supply, which is why a large locked share can make a coin look smaller than it is.

A simple vesting plan for a founder share (example)timeline
  1. Day 1

    Coins are created

    The founder share exists, in a published wallet.

  2. Months 1 to 6

    Cliff

    Nothing moves. The community can see the wallet stay still.

  3. Months 7 to 24

    Linear release

    The founder share is released in equal parts each month.

CHAPTER 06

A worked example: design a coin end to end

One hypothetical coin, with every number worked out, plus the mistakes to avoid and how to enter it in the builder.

Here is a made-up coin, "ExampleCoin". Every number below is computed from its rules, so you can swap in your own.

Example: the rules of ExampleCoin
SettingValueWhy
Block time1 minuteFast enough for payments, which gives 525,600 blocks a year
Block reward10 coinsRound and easy to explain
Halving interval1,051,200 blocksExactly two years of blocks
Premine1,000,000 coinsSmall, public and for development
Cap from miningAbout 21,024,000 coins10 x 1,051,200 for the first period, and the later periods add up to the same again

Example: not a real coin. Supply stays below 22.03 million, and the premine is under 5 percent of that.

Example: ExampleCoin supply, year by year
YearRewardNew coinsSupply at year endGrowth in the year
1105,256,0006,256,000Not meaningful: starts from the premine
2105,256,00011,512,00084.0 percent
352,628,00014,140,00022.8 percent
452,628,00016,768,00018.6 percent
52.51,314,00018,082,0007.8 percent
62.51,314,00019,396,0007.3 percent
71.25657,00020,053,0003.4 percent
81.25657,00020,710,0003.3 percent

Example: computed from the rules above, with exactly one-minute blocks. Growth is new coins divided by the supply at the start of the year.

Read the table like a story you would tell your community: the early years have fast growth because the coin is young. By year 5 it is under 8 percent a year, and the rate keeps falling after that. Everyone can check it, because it is just arithmetic.

  • Hiding the premine

    The community will find it on the explorer anyway.

  • A reward that is too high

    The first years are pure inflation, and early miners hold most of the supply.

  • Halving too early

    Miners leave before the network is secure.

  • Changing the rules later

    Every node must upgrade at once (a hard fork). Decide before launch.

Ready to try your own numbers? Use the calculator in chapter 2, then enter them in the builder. A coin with its own blockchain starts at $149 one-time, and you see the full price in the builder. It deploys in about 30 minutes once payment is confirmed. Our complete guide to creating a cryptocurrency covers the rest of the launch, and how to create a meme coin shows how a lighter, joke-led coin handles the same choices.

QUESTIONS

Questions people ask

What is tokenomics?

Tokenomics is the economic design of a cryptocurrency: how many coins exist, how new ones are created, who receives them and when they are released. For a coin with its own blockchain, the main levers are the maximum supply, the block reward, the halving schedule and any premine.

What is the difference between max supply, total supply and circulating supply?

Max supply is the most coins that can ever exist. Total supply is what has been created, minus anything permanently burned. Circulating supply is the part actually available, which leaves out locked and vesting coins. CoinGecko defines all three in its supply methodology.

Is a capped supply better than an uncapped one?

Neither is better for every coin. A cap like Bitcoin's (slightly less than 21 million) supports a scarcity story. An uncapped coin like Dogecoin, which pays a constant 10,000 coins per block from block 600,000, supports a coin meant for spending. Choose for your purpose.

How does a Bitcoin halving work?

The block reward is cut in half every 210,000 blocks, about every four years. It went from 50 coins in 2009 to 25 in 2012, 12.5 in 2016, 6.25 in 2020 and 3.125 in April 2024.

What is a premine?

A premine is a share of the supply created for the founders at launch. Communities accept a small one that is explained and published, and distrust a large or hidden one. Bitcoin has none.

What is token vesting?

Vesting is a schedule that releases locked coins over time, usually after an initial waiting period called a cliff. It is meant to stop founders and early backers from selling everything at once.

How do I calculate the inflation rate of a coin?

Multiply blocks per year by the reward per block to get new coins per year, then divide by the supply at the start of the year. At 10 minute blocks there are 52,560 blocks a year. Our supply calculator in chapter 2 does this for your own rules.

Can I change my coin's tokenomics after launch?

Only with a hard fork, which every node must adopt. That is hard to do once people use the coin, so decide the supply, reward and halving before launch.

SOURCES

Sources and how we made this guide

  1. Bitcoin Wiki, Controlled supply (block reward history and dates, 210,000 block halving, supply cap, final coin around 2140, future halving estimates)
  2. bitcoin.org FAQ (21 million maximum supply)
  3. Bitcoin Core source code, chain parameters (halving interval and 10 minute block target)
  4. Litecoin Core source, chainparams.cpp (840,000 block halving interval, 2.5 minute blocks, 50 coin starting reward)
  5. Dogecoin Core source, chainparams.cpp (one-minute block time target, halving interval)
  6. Dogecoin Core source, dogecoin.cpp (constant 10,000 coin reward after block 600,000)
  7. CoinGecko, supply methodology (max, total and circulating supply; locked and vested coins excluded from circulating)
  8. CoinGecko Learn, vesting schedules (vesting, cliff, linear vesting and the 15 percent team example)

Written by

HeroRPC team

Written and checked by the people who run HeroRPC's builder and node servers. Every figure links to its source.

Published . Last updated .