Skip to main content

Burn Tokens

The xyz token burn command permanently destroys tokens from your balance, reducing the total supply.

Usage

Arguments

Flags

Examples

Basic Burn

Dry Run

Output:

Output

Successful burn:

Verify Burn

Check balance and total supply after burning:

Use Cases

Deflationary Mechanics

Reduce supply over time to increase scarcity

Token Buyback

Buy tokens from market and burn them

Error Correction

Burn accidentally minted tokens

Bridge Burns

Burn when bridging to another chain

Amount Calculation

Amount is in the token’s smallest unit. For 6 decimals:

Burn All Tokens

To burn your entire balance:

Error Handling

Check Balance Before Burn

Under the Hood

xyz token burn executes a MsgExecuteContract:

Burn vs BurnFrom

CW20 has two burn methods: The xyz token burn command uses burn (burning your own tokens).
Burning is irreversible! Burned tokens are permanently destroyed and cannot be recovered.

Troubleshooting

You can only burn tokens you own:
Amount must be greater than 0.