Testnet on Base Sepolia: 1 ZRO here is 0.0001 test ETH.
Docs · Holder rewards

Docs · For traders

Holder rewards

A creator who adds a fee of their own on top of the 1% base can give part of it to the token's holders. Then every trade, on the curve and later on its pool, pays everyone holding it in ZRO, in proportion to what they hold. You claim whenever you like.

How a share is counted

A token whose creator set a holders share is a holder token. The share is of the creator's own fee only, never of the 1% base. Each time a fee comes in, its holders' part is added to a running total per token held. What you can claim is your balance times how much that total grew while you held it.

  • You earn from the moment tokens reach your wallet, never for fees paid before.
  • A buyer doesn't earn from their own buy, and a seller doesn't earn from their own sale: the fee is paid before the tokens move.
  • Rewards you earned stay yours when you sell or send the tokens on. Claim them later from Portfolio.
  • Nothing is taken from a transfer. The ZRO comes from the trading fee, not from holders.

A worked example

A token with a 2% own fee gives 50% of it to holders, so holders get 1% of everything traded on the curve. Traders pay 3% in all, with the 1% base.

Amount
Traded in a day40,000 ZRO
To holders, 1%400 ZRO
Your share of the tokens people hold2%
Yours for the day8 ZRO
Figure 1. Your share is of the tokens held by people, not of the whole supply.

On a pool the same token pays holders 4 ZRO per 400 ZRO traded, the same as on the curve, since the pool has no LP fee. The breakdown is on Fees. A trader's volume rank never changes what holders get: the discount comes off Submarine's cut only. Trades made on the pool around Submarine pay holders too, once anyone runs distribute; Submarine's own trades run it every time.

Early holders split rewards among fewer people. Tokens still on the curve sit in the launchpad, which doesn't earn. Early on, a few holders share every reward between them.

Who earns and who doesn't

Contracts that only pass tokens through earn nothing, so their share goes to people who hold. These never earn:

AddressWhy
The launchpadHolds the unsold part of the curve
The poolsInfinity's vault holds every pool's tokens. The pools contract and its venue only pass them through
The dead addressBurned tokens
The routerHolds tokens only during a trade
Limit ordersTokens escrowed in a sale order don't earn while they wait
The treasuryIt buys only to burn
The copy vaultTokens bought by copy trading in the vault don't earn

So tokens waiting in a sale order or held in your copy vault earn nothing until they come back to your wallet.

Claiming

Claim from the token's page or from Portfolio, which lists every holder token you hold or have traded. A claim is a transaction and costs gas, so small amounts can wait.

Anyone may claim for you with claimFor, paying the gas, and the ZRO still only goes to you.

Good to know

  • Rewards wait until at least one whole token is held by people. Until then they build up and are paid out with the next fee.
  • The token page shows how much its fee has paid holders so far.
  • The holders share can't be added, removed or changed after launch.