Skip to main content

Claiming Fees

Collect your share of trading fees from your deployed tokens.

Looking to read fees without claiming? See Reading Creator Fees for REST, on-chain, and CLI options.

Who Can Claim​

Only the current fee beneficiary can claim fees from a token. By default, this is the deployer wallet. If you've redirected fees to another address, only that address can claim.

Your Share​

You receive 57% of the 1.2% swap fee collected on trades. The remaining fees are automatically distributed to Bankr (36.1%), Bankr Ecosystem (1.9%), and Protocol (5%).

Checking Your Fees​

See how much you've accumulated:

"check my fees for TokenName"
"how much fees have I earned from 0x1234...?"
"show all my tokens with unclaimed fees"

This shows fees for tokens where you're the current beneficiary.

Claiming Fees​

From the Token Page​

Navigate to the token detail page at /launches/<tokenAddress> and click Claim Fees. You can connect either your Bankr wallet or an external wallet (e.g. MetaMask, Coinbase Wallet). The page will check your eligibility and show your claimable amounts before you confirm.

  • Bankr wallet: Signs in with your existing Bankr account and executes the claim server-side. Gas is sponsored by Bankr — you can claim with a $0 ETH balance. The server submits the collectFees transaction via your Privy-managed wallet.
  • External wallet: Connects via WalletConnect/RainbowKit and signs the transaction in your wallet. You pay the gas — make sure the wallet holds a small amount of ETH on Base.

Gas​

Claim pathWho pays gasETH needed in signing wallet
Web UI with Bankr walletBankr (sponsored)None
Web UI with external walletYouSmall amount of ETH on Base
POST /token-launches/:tokenAddress/fees/claim (auth'd API)Bankr (sponsored)None
POST /public/doppler/build-claim + self-signYouSmall amount of ETH on Base
CLI bankr fees claim (uses your Bankr account)Bankr (sponsored)None
CLI bankr fees claim-wallet (your private key)YouSmall amount of ETH on Base

API example — single-call claim (recommended)​

POST /token-launches/:tokenAddress/fees/claim builds, signs, and broadcasts in one call. Auto-detects Doppler vs Clanker.

curl -X POST https://api.bankr.bot/token-launches/0xTokenAddress/fees/claim \
  -H "Authorization: Bearer $BANKR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
# → { "transactionHash": "0x...", "status": "success", "signer": "0x...", "chainId": 8453, "description": "..." }

Auth: Privy JWT (web) or API key (CLI/partners) via Authorization: Bearer <token>. Requires walletApiEnabled on the key. Returns a single submitted-tx receipt.

Legacy endpoints /user/doppler/claim, /user/doppler/execute-claim, /clanker/claim, and /agent/doppler/claim remain functional through their deprecation window but now emit Deprecation and Sunset response headers.

Gas sponsorship covers up to 10 transactions per day per wallet across all sponsored paths. This is usually more than enough for fee claims, but high-volume agents claiming many tokens daily should account for this ceiling.

This matters for agent wallets and partner integrations: if you don't pre-fund agent wallets at creation, route claims through a Bankr-managed wallet or the authenticated claim endpoint to avoid the chicken-and-egg problem of needing ETH to claim ETH.

From Chat​

Collect your earnings via natural language:

"claim my fees for TokenName"
"claim fees for 0x1234..."

What You Receive​

When you claim fees, you receive two assets:

AssetDescription
Your tokenYour share from the 1.2% swap fee
WETHYour share from the 1.2% swap fee

Both accumulate in the Uniswap V4 liquidity pool and are claimed together.

Claim Frequency​

You can claim at any time. There's no minimum threshold, but consider gas costs when claiming small amounts.

Recommended approach:

  • Check fees periodically: "show my unclaimed fees"
  • Claim when accumulated amount justifies gas cost
  • Gas is low on Base, so you can claim frequently

Viewing Your Tokens​

See all tokens where you're a fee beneficiary:

"show all my deployed tokens"
"list my tokens with fees"
"check what tokens I'm a beneficiary for"

Fee Dashboard (CLI)​

The Bankr CLI includes a dedicated fee dashboard that gives you a full picture of your historical earnings and projections:

bankr fees

The dashboard displays:

  • Claimable and claimed WETH at a glance
  • Daily earnings chart with bar graph and sparkline visualization
  • Key statistics: total earned, daily average, best day, active days, and current streak
  • Projected earnings: estimated monthly and yearly income based on your daily average
  • Per-token breakdown: claimable and claimed amounts for each token you've deployed

You can customize the lookback period (1–90 days) and look up fees by token address:

bankr fees --days 7                    # Last 7 days
bankr fees --token 0xTokenAddress      # Fees for a specific token
bankr fees --json                      # Raw JSON for scripting

To claim directly from the CLI:

# Claim a single token (requires Bankr account)
bankr fees claim 0xTokenAddress

# Claim all fees for any wallet using your own private key (no Bankr account needed)
bankr fees claim-wallet

The claim-wallet command automatically reads BANKR_PRIVATE_KEY from a .env file in the current directory, derives your wallet address, scans all launches where you're a beneficiary, and lets you claim in bulk. See the CLI documentation for full details.

For Partners​

If you're a Bankr partner deploying tokens via the Deploy API, your partner wallet accumulates a share of trading fees from every token launched through your integration. Use claim-wallet to claim fees across all your tokens in bulk:

# Set your partner wallet private key in .env
echo "BANKR_PRIVATE_KEY=0xYourPartnerWalletKey" > .env

# Scan all launches and claim fees
bankr fees claim-wallet --all --yes

This is the recommended way for partners to collect their fee share. It scans all launches where your wallet is a beneficiary (creator, partner, or any other role), shows claimable amounts, and submits claim transactions directly.

Troubleshooting​

"No fees to claim"

  • Your token may not have had recent trading activity
  • Fees might have already been claimed
  • Check if fees have accumulated: "check my fees for TokenName"

"Not authorized to claim"

  • You must be the current fee beneficiary for the token
  • If you transferred beneficiary rights, the new beneficiary must claim
  • Check who the current beneficiary is: "who is the beneficiary for 0x1234...?"
  • To move beneficiary rights to a new wallet, see Transferring Fees to a New Wallet