Skip to main content
Once a token you deployed with Clanker has been traded at least once, it has earned rewards. You can check what you can claim on clanker.world, through the API or, for older tokens, on chain.

Clanker v5

How it works

v5 rewards collect in the FeeEscrow, one balance per recipient and currency (ETH or USDC). A recipient’s balance includes the rewards of all v5 tokens that pay that wallet, and one claim pays all of it, so claiming on one token also clears the balance shown on the recipient’s other v5 tokens.

Example

A wallet is the reward recipient of two ETH-paired v5 tokens. Token A has earned 0.3 ETH and token B 0.2 ETH since the last claim.

Check on clanker.world

  1. Open the token’s Admin page: https://www.clanker.world/clanker/TOKEN_CONTRACT_ADDRESS_HERE/admin.
  2. In the Claim Rewards card, select Check Claimable Fees to see the unclaimed balance of the selected reward recipient, in the pair token.
A past recipient keeps its unclaimed balance. Connect that wallet and check the Tax Fees card on your clanker.world profile.

With the API

GET /api/creator-earnings/{tokenAddress} returns the unclaimed FeeEscrow balances of the token’s current reward recipients. See Creators.

Clanker v4

Open the token’s Admin page and select Check Claimable Fees in the Claim Rewards card. It shows the selected reward recipient’s unclaimed rewards in the token and in the pair token.

Clanker v3.1 and earlier

The initial LP of these tokens is a Uniswap v3 position, so you can check that position’s Uncollected fees on chain:
1

Open the token on BaseScan

Go to your token’s page on clanker.world and select BaseScan.unclaimed rewards step 1
2

Open the token contract

Click the contract address of the token.unclaimed rewards step 2
3

Open the creation transaction

Click the contract creation transaction.unclaimed rewards step 3
4

Find the LP token ID

Note the Token ID of the LP position.unclaimed rewards step 4
5

Open the position on Uniswap

Visit https://app.uniswap.org/positions/v3/base/YOUR_TOKEN_ID, with your Token ID in place of YOUR_TOKEN_ID (for example, this position).
6

Work out the creator's part

The creator’s part of the Uncollected fees depends on the version. On v3.1, Clanker takes 20% and the creator and interface share the other 80% (see LpLockerv2). For the older CLANKER token in the screenshot, the creator’s part is 40%. Dollar values are estimates and move with the prices of the two tokens in the pool.unclaimed rewards step 6
For the CLANKER position in the screenshot: