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

# TokenAmount

Format raw token integers into reader-friendly units while keeping the original precision available in component data.

**Interactive playground** For isolated previews, theme switching, and sandbox editing, open [the TokenAmount playground on holydocs.com](https://holydocs.com/components/token-amount).

## When to use

Use this component when blockchain context, addresses, chains, token math, or wallet onboarding must stay precise and scannable.

## Live Examples

Every example below renders the real component directly inside HolyDocs, followed by the exact MDX you can paste into a page.

### Native Token

Humanize an 18-decimal native asset balance.



~~~mdx
<TokenAmount value="1000000000000000000" decimals={18} symbol="ETH" />
~~~

### Stablecoin

6-decimal assets like USDC remain precise without extra formatting work.



~~~mdx
<TokenAmount value="12500000" decimals={6} symbol="USDC" />
~~~

### Large Treasury Balance

Large raw values still render cleanly for dashboards or treasury docs.



~~~mdx
<TokenAmount value="2504500000000000000000" decimals={18} symbol="MNT" />
~~~

## Props

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `value` | `string` | `0` | Raw integer token amount, usually straight from an RPC response. |
| `decimals` | `number` | `18` | Number of decimal places used by the token. |
| `symbol` | `string` | `--` | Optional token symbol appended to the formatted value. |

## Usage

Start from this baseline shape and then tailor the copy, data, or nesting to the page you are writing.

~~~mdx
<TokenAmount value="1000000000000000000" decimals={18} symbol="ETH" />
~~~

## Tips

- Assume readers are one copy action away from using the value in production. Precision matters more than flair on web3 surfaces.
- Always make the target chain explicit when a component can imply a wallet, explorer, or transaction context.
- Use testnet examples unless the page is explicitly about production contracts or addresses you expect people to reuse.

## Related Components

**[Address](/components/address)**

Readable wallet or contract address with truncation, copy-to-clipboard, and optional block-explorer deep link.
**[ChainBadge](/components/chain-badge)**

Compact chain indicator for network-specific instructions, examples, and warnings.
**[ContractCall](/components/contract-call)**

Smart contract call block for ABI-backed read or write interactions, with optional interactive execution in supported contexts.

## More

- Interactive playground: [TokenAmount on holydocs.com](https://holydocs.com/components/token-amount)
- Component library index: [/components](/components)