Skip to main content

Deploy

POST 
/token-launches/deploy

Launch a new token on Base via Doppler. Returns the deployed token address, Uniswap v4 pool ID, and the on-chain fee-beneficiary breakdown. Gas is sponsored by Bankr within your rate-limit tier.

Authentication — two modes (same endpoint):

  • User API key (X-API-Key: bk_usr_{keyId}_{secret}, or Authorization: Bearer <same>) — deploys from the wallet that owns the API key. feeRecipient is optional; defaults to your wallet. Rate-limited per-wallet: 50 deploys / 24h (100 for Bankr Club).
  • Partner key (X-Partner-Key: bk_ptr_{keyId}_{secret}) — deploys from your partner wallet on behalf of an end user. feeRecipient is required (tells the API where the creator fee should go). Rate-limited per fee recipient: 1/minute, 20/24h, 1 concurrent. Partner fee share is included in the response's feeDistribution.

The server distinguishes user vs partner auth by header, not by token content: X-API-Key / Authorization: Bearer → user key flow; X-Partner-Key → partner flow. Partner keys are never accepted via Bearer.

Fee recipient types (feeRecipient.type):

  • wallet — raw EVM address
  • x — Twitter/X username (resolves to Bankr wallet)
  • farcaster — Farcaster username (resolves to verified EVM address)
  • ens — ENS name (resolves to underlying address)

Simulation mode: pass simulateOnly: true to get the predicted token address and fee distribution without broadcasting a transaction. Response status becomes 200 OK and txHash is omitted.

Request​

Responses​

Simulation succeeded (simulateOnly: true). No transaction was broadcast.