Crypto token decimals determine how many decimal places a cryptocurrency or token can display and how its smallest units are converted into the amount users see in their wallets.
For example, if an ERC-20 token has 18 decimals, then:
1 token = 1,000,000,000,000,000,000 smallest units
If a token has 6 decimals:
1 token = 1,000,000 smallest units
Token decimals are mainly a way of representing token amounts in a human-readable format. On Ethereum, the ERC-20 standard includes a decimals() function that tells applications how many decimal places a token uses. The standard describes, for example, 8 decimals as dividing the raw token amount by 100,000,000 to display the user-facing amount.
What Does Token Decimals Mean?
A token’s decimal number tells you how many digits appear to the right of the decimal point when its smallest on-chain units are displayed as whole tokens.
For example:
| Token decimals | Smallest units in 1 token |
|---|---|
| 0 | 1 |
| 2 | 100 |
| 6 | 1,000,000 |
| 8 | 100,000,000 |
| 9 | 1,000,000,000 |
| 18 | 1,000,000,000,000,000,000 |
The basic formula is:
Human-readable amount = raw token amount ÷ 10^decimals
So if a token has 6 decimals and the blockchain records:
1,500,000
the wallet displays:
1.5 tokens
This conversion is used by wallets, explorers, exchanges, and other applications to display token balances correctly.
Why Do Crypto Tokens Have Decimals?
Blockchains generally store token amounts as integers rather than floating-point numbers.
Instead of storing:
1.25 tokens
a token contract can store:
1250000000000000000
when the token uses 18 decimals.
The decimal setting tells applications how to interpret that integer.
Ethereum’s documentation explains that Solidity does not use floating-point variables for token balances, so token systems use integer base units and a decimals value to make those units readable to users.
This approach helps blockchain systems perform precise arithmetic without relying on traditional decimal or floating-point storage.
How Do Token Decimals Work?
Imagine a token called ABC with:
6 decimals
That means:
1 ABC = 1,000,000 base units
Therefore:
- 0.000001 ABC = 1 base unit
- 0.00001 ABC = 10 base units
- 0.001 ABC = 1,000 base units
- 0.1 ABC = 100,000 base units
- 1 ABC = 1,000,000 base units
- 10 ABC = 10,000,000 base units
The blockchain can store the amount as an integer, while the wallet converts it into the familiar decimal representation.
What Are 18 Decimals in Crypto?
18 decimals means that one whole token is represented internally as:
10^18 smallest units
or:
1,000,000,000,000,000,000 units
For example:
1 token = 1 × 10^18 base units
0.5 token = 5 × 10^17 base units
0.01 token = 1 × 10^16 base units
Many Ethereum tokens use 18 decimals, partly because ETH itself uses 18 decimal places between ether and wei. However, not every ERC-20 token has 18 decimals. Token developers can choose a different value.
What Are 6 Decimals in Crypto?
A token with 6 decimals has:
1,000,000 smallest units = 1 token
For example:
1.25 tokens = 1,250,000 base units
0.50 tokens = 500,000 base units
0.000001 tokens = 1 base unit
Six decimals are common for tokens that want a smaller number of decimal places in their user-facing representation.
For example, Solana’s official documentation shows USDC balances using 6 decimals.
What Are 8 Decimals in Crypto?
A token with 8 decimals has:
100,000,000 smallest units = 1 token
For example:
1 BTC = 100,000,000 satoshis
Bitcoin’s smallest unit, the satoshi, therefore corresponds to eight decimal places when BTC is displayed in decimal form.
However, it is important to distinguish Bitcoin’s smallest unit from token decimals on smart-contract platforms. Bitcoin does not use an ERC-20 decimals() function.
For ERC-20 tokens, the decimals() function specifies how a token’s raw integer amounts should be displayed.
Are Token Decimals the Same as the Smallest Unit?
They are closely related but are not exactly the same concept.
Token decimals tell you how many decimal places are used to represent the token.
The smallest unit is the indivisible base unit represented by the blockchain’s integer amount.
For example, with 6 decimals:
1 token = 1,000,000 smallest units
The smallest possible amount is therefore:
0.000001 token
assuming the token’s implementation permits that unit.
Token Decimals Example
Suppose you create a token called XYZ with:
Decimals = 8
You want to give someone:
2.5 XYZ
The blockchain-level amount would be:
2.5 × 10^8
which equals:
250,000,000
So the transaction may internally use:
250,000,000
while the wallet displays:
2.5 XYZ
This is why a blockchain explorer can sometimes show a large integer even though your wallet shows a much smaller decimal balance.
Why Does My Wallet Show a Different Token Amount?
A wallet may display a token balance such as:
12.3456 XYZ
while the underlying smart contract stores:
12345600
If XYZ has 6 decimals:
12,345,600 ÷ 1,000,000 = 12.3456
The wallet uses the token’s decimal information to convert the raw blockchain amount into a human-readable balance.
Ethereum’s ERC-20 documentation specifically defines decimals() as information that applications can use to display token balances properly.
What Is the ERC-20 Decimals Function?
For ERC-20 tokens, the standard includes:
decimals()
This function returns the number of decimal places used by the token.
For example, a token contract might return:
6
or:
8
or:
18
The function returns a uint8 value in the ERC-20 interface.
Applications can then use that information to convert raw token amounts into user-friendly amounts.
For example:
Raw balance = 2500000
Decimals = 6
Therefore:
Displayed balance = 2.5 tokens
Do All ERC-20 Tokens Have 18 Decimals?
No.
18 decimals are common, but ERC-20 tokens can use different decimal values.
A token can use:
- 0 decimals
- 2 decimals
- 6 decimals
- 8 decimals
- 9 decimals
- 18 decimals
- Or another supported value
The ERC-20 specification defines decimals() as an optional method for improving usability rather than making every token use a single universal decimal value.
This is why applications should read the token’s actual decimal information rather than automatically assuming every token has 18 decimals.
Can a Token Have 0 Decimals?
Yes.
A token can use 0 decimals, meaning it is represented only in whole units.
For example:
1 token = 1 smallest unit
Therefore, users cannot represent:
0.5 token
through the token’s decimal system.
This can be useful for assets that are intended to behave like whole-number units.
Ethereum’s documentation notes that a token can use a decimals value of zero when dividing the token does not make sense.
Do Token Decimals Affect Token Supply?
No, not by themselves.
Decimals determine how raw token units are represented to users. They do not automatically determine how many tokens exist.
For example, suppose a token contract has:
Total raw supply = 1,000,000,000
With 6 decimals, the displayed supply is:
1,000 tokens
With 2 decimals, the same raw integer would represent:
10,000,000 tokens
Therefore, the same raw integer can correspond to different human-readable supplies depending on the decimal setting.
This is why token supply calculations must always take decimals into account.
Do Token Decimals Affect Token Price?
Not directly.
Changing the decimal representation does not inherently create economic value or make a token more valuable.
Decimals are primarily a unit/display convention.
For example, imagine a project defines:
1 token = 1,000,000 base units
The project could instead define a different unit system, but that does not automatically change the underlying economic value.
What matters for price calculations is the actual token supply, market price, and amount represented—not simply the number of decimal places.
Do Token Decimals Affect Gas Fees?
No.
A token’s decimals are separate from the blockchain’s gas mechanism.
For example, an ERC-20 token may have:
6 decimals
while Ethereum gas is paid using ETH.
Changing the token’s decimals does not automatically change Ethereum’s gas price.
However, transferring a token still requires the blockchain’s native asset for gas, where applicable.
Can Token Decimals Be Changed?
This depends on how the token contract was designed.
For many ERC-20 implementations, the decimals value is effectively fixed after deployment. The exact behavior depends on the token contract’s code.
Therefore, users should not assume that a token’s decimal count can be changed just because the token contract has a decimals() function.
For an existing token, the safest approach is to check the actual token contract and its documentation.
What Happens If a Wallet Uses the Wrong Token Decimals?
Using the wrong decimals can cause a token amount to be displayed incorrectly or cause software to construct an incorrect raw amount.
For example, suppose a token actually uses:
6 decimals
but an application incorrectly assumes:
18 decimals
A raw balance of:
1,000,000
could be interpreted incorrectly as:
0.000000000001 tokens
instead of:
1 token
This is why wallets, exchanges, and blockchain applications must use the correct token metadata.
Can Wrong Token Decimals Cause You to Lose Crypto?
They can contribute to serious transaction errors if software interprets or constructs token amounts incorrectly.
The decimal value determines the conversion between the human-readable amount and the raw integer passed to the token contract.
For example, if you intend to transfer:
1 token
and the token has 6 decimals, the raw transfer amount should generally be:
1,000,000
If software incorrectly assumes 18 decimals, it could construct a drastically different raw amount.
Always verify the token contract address and decimal information before manually entering raw token amounts or interacting with contracts directly.
Token Decimals on Solana
Token decimals are not limited to Ethereum.
Solana’s token system also stores a decimals value for a token mint. Solana’s documentation describes the field as the number of base-10 digits to the right of the decimal point.
For example, Solana’s official balance documentation can represent a token balance using:
- A raw
amount - A human-readable
uiAmount - A
decimalsvalue
For a token with 6 decimals, the raw amount is divided by 1,000,000 to produce the user-facing amount.
So the general concept is similar across different blockchain ecosystems:
Raw integer amount → decimal conversion → human-readable balance
Token Decimals vs Crypto Smallest Units
These terms are often confused.
| Concept | Meaning |
|---|---|
| Token decimals | Number of decimal places used to represent the token |
| Raw amount | Integer amount stored or passed on-chain |
| Smallest unit | The smallest indivisible unit represented by that raw amount |
| Human-readable amount | Amount displayed to users |
| Token supply | Total amount of tokens represented by the contract |
For example, with 6 decimals:
Raw amount: 5,000,000
Decimals: 6
Human-readable amount: 5 tokens
How to Calculate Token Amount From Decimals
Use this formula:
Human-readable token amount = raw amount ÷ 10^decimals
Example
Raw amount:
7500000
Decimals:
6
Calculation:
7,500,000 ÷ 10^6 = 7.5
Therefore:
7,500,000 raw units = 7.5 tokens
How to Calculate Raw Token Amount
You can reverse the formula:
Raw token amount = human-readable amount × 10^decimals
Example
You want to transfer:
2.75 tokens
The token has:
6 decimals
Calculation:
2.75 × 1,000,000 = 2,750,000
So the contract would generally receive:
2,750,000 raw units
Common Crypto Token Decimal Values
Some common decimal values include:
| Decimals | Smallest unit | Example of 1 token |
|---|---|---|
| 0 | 1 | 1 |
| 2 | 1/100 | 0.01 |
| 6 | 1/1,000,000 | 0.000001 |
| 8 | 1/100,000,000 | 0.00000001 |
| 9 | 1/1,000,000,000 | 0.000000001 |
| 18 | 1/10^18 | 0.000000000000000001 |
The decimal value is a property of the token’s implementation or mint configuration; it is not a universal setting shared by every cryptocurrency.
Are Crypto Token Decimals the Same as Ethereum’s Wei?
No, but the concepts are similar.
Wei is the smallest denomination of ETH:
1 ETH = 10^18 wei
For an ERC-20 token, the token’s own decimal setting determines the relationship between its raw units and its user-facing token amount.
For example:
18-decimal token:
1 token = 10^18 base units
6-decimal token:
1 token = 10^6 base units
Ethereum’s documentation uses the relationship between wei and ETH as an analogy for understanding token decimals.
Why Do Exchanges and Wallets Need Token Decimals?
Wallets and exchanges need token decimal information to display balances and process token amounts correctly.
Suppose the blockchain reports:
123456789
An application needs to know whether that represents:
- 123,456,789 tokens
- 1,234.56789 tokens
- 0.123456789 tokens
The answer depends on the token’s decimal configuration.
With 8 decimals:
123,456,789 ÷ 100,000,000 = 1.23456789 tokens
Without the correct decimal information, an application could display the wrong balance.
Why Does a Blockchain Explorer Show a Huge Token Number?
You may see a transaction or contract call containing a very large integer.
This is often the raw token amount.
For example, an ERC-20 transfer might internally use:
1000000000000000000
If the token has 18 decimals, this represents:
1 token
The large number does not necessarily mean the user transferred one billion or one quintillion tokens.
It may simply be the token’s smallest-unit representation.
Do Token Decimals Make a Cryptocurrency More Valuable?
No.
A higher decimal count does not automatically make a cryptocurrency more valuable.
For example, a token with 18 decimals is not inherently more valuable than a token with 6 decimals.
Decimals determine how the token is divided into smaller units and displayed.
Price and value depend on factors such as supply, demand, liquidity, utility, and market conditions—not simply the number of decimal places.
Crypto Token Decimals Explained Simply
Crypto token decimals tell a blockchain application how to convert a token’s raw integer units into the amount users see.
For example:
6 decimals
means:
1 token = 1,000,000 smallest units
So:
2.5 tokens = 2,500,000 raw units
Similarly:
18 decimals
means:
1 token = 1,000,000,000,000,000,000 smallest units
The decimals setting is therefore mainly a unit conversion and display mechanism.
It does not automatically change the token’s value, supply, or gas fee.
Key Takeaways
- Crypto token decimals determine how many decimal places a token uses in its human-readable representation.
- The basic formula is raw amount ÷ 10^decimals = displayed amount.
- An ERC-20 token can use different decimal values; 18 is common but not universal.
- A token with 6 decimals has 1,000,000 base units per token.
- A token with 18 decimals has 10^18 base units per token.
- Token decimals are primarily used to convert raw integer amounts into human-readable balances.
- Token decimals do not directly determine a token’s price or market value.
- Token decimals are different from transaction fees and gas limits.
- Solana tokens also use a decimals value to define their decimal precision.
- Using the wrong decimals can cause token amounts to be displayed or constructed incorrectly.
- Always verify the correct token contract or mint before manually working with raw token amounts.
Frequently Asked Questions
What are crypto token decimals?
Crypto token decimals specify how many decimal places are used to represent a token’s smallest units in a human-readable format.
What does 18 decimals mean in crypto?
18 decimals means that one whole token corresponds to 10^18 smallest units.
What does 6 decimals mean for a token?
6 decimals means that one token corresponds to 1,000,000 smallest units.
Are all crypto tokens 18 decimals?
No. Different tokens can use different decimal values, including 0, 6, 8, 9, and 18.
What is the purpose of token decimals?
Token decimals allow blockchain applications to convert large integer amounts stored or transferred on-chain into easy-to-read token balances.
Do token decimals affect token price?
No. Decimal precision is primarily a unit and display convention. It does not automatically increase or decrease a token’s market value.
Do token decimals affect total supply?
Decimals affect how a raw integer supply is displayed, but the decimal setting itself does not determine the economic supply.
Can token decimals be changed?
It depends on the token’s smart contract or token-mint implementation. For many deployed tokens, the decimal configuration is effectively fixed.
What happens if a token has 0 decimals?
A token with 0 decimals is represented in whole units, meaning its smallest unit is one whole token.
How do I calculate token decimals?
To convert a raw token amount into a displayed amount, divide the raw amount by 10^decimals.
Why does my wallet show fewer tokens than the blockchain explorer?
The explorer may be showing the raw integer amount while your wallet is applying the token’s decimal conversion. Check the token’s actual decimals value.
What is the difference between token decimals and wei?
Wei is the smallest denomination of ETH, while token decimals define how a specific token’s raw units are converted into its user-facing amount.
Can wrong token decimals cause a transaction problem?
Yes. If software uses an incorrect decimal value when constructing a token amount, it can potentially create an unintended raw amount. Always verify token metadata before manually interacting with token contracts.
Where can I find a token’s decimals?
For ERC-20 tokens, the token contract can expose the decimals() function. Wallets and blockchain explorers may also display the token’s decimal information. For Solana tokens, the decimals value is stored as part of the token mint information.
