Claim fees
POST/token-launches/:tokenAddress/fees/claim
Collect your share of trading fees for a Bankr-launched token.
Handles both Doppler (pool fee-share beneficiary) and Clanker (WETH reward-recipient) launches — the server auto-detects which protocol the token was launched on and constructs the appropriate transaction. Signs and broadcasts the transaction server-side and returns the final receipt in one call.
Replaces the prior two-call flow (POST /agent/doppler/claim → POST /wallet/submit) and the per-protocol legacy endpoints (/user/doppler/claim, /user/doppler/execute-claim, /clanker/claim, /agent/doppler/claim). Those routes still work through their deprecation window but emit Deprecation and Sunset response headers.
Authentication: requires a Bankr user API key with walletApiEnabled. Pass as X-API-Key: bk_usr_{keyId}_{secret} (preferred) or Authorization: Bearer <same>. The key must not be readOnly, and the provisioning org (if any) must have the walletApi capability enabled.
External wallets (Safe multisig, hardware wallets, third-party signers): use POST /public/doppler/build-claim instead — that endpoint returns unsigned calldata for external signing and supports batching.
Request
Responses
- 200
- 400
- 401
- 403
- 404
Claim transaction submitted and confirmed.
Invalid request — malformed token address or the upstream submission failed.
Missing or invalid authentication.
Caller is not permitted to claim fees for this token.
Token was not launched via Bankr (no matching Doppler or Clanker launch record).