How it works
- A trade pays the buy or sell tax. Clanker takes its fee first (see Creator Rewards & Fees).
- The burn share of the remaining tax is taken in the token itself, not in the pair token. On a buy, it comes off the tokens the buyer receives.
- The tokens are added to the token’s Pending Burn, held in the FeeEscrow for the dead address (
0x000000000000000000000000000000000000dEaD). - Any wallet can send the pending burn to the dead address. Once sent, those tokens are out of circulation for good.
Example
A token has a 5% tax and a 20% burn share. Someone buys for 1,000 USDC.
Because this trade is a buy, the burn share comes off the tokens the buyer receives: about 9 USDC worth of tokens goes to the pending burn.
Burn on clanker.world
The token page shows a Burn card with:- Pending Burn: tokens from trades that are waiting to be burned.
- Total Burned: the balance of the dead address. It also counts any other transfers to that address.
With the API
The token fee history (GET /api/tokens/{address}/fees) gives the burn share of each trade and the executed burns, in the token. See Fees.
Related
- clanker.world Deployments or API Deployments to set a burn share on a new token.
- v5 contracts and Deployed Contracts for contract details and addresses.