Skip to main content

Claiming Fees

Collect your share of trading fees from your deployed tokens.

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.
  • External wallet: Connects via WalletConnect/RainbowKit and signs the transaction in your wallet.

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 Partner 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...?"