How Do I Provision Wallets for My Users?
In this article
In this article group
- How Do I Create a Project Page?
- How Do I Trigger My Agent from External Apps (Webhooks)?
- Using Bankr from Claude Code
- How Do I Create a Paid API Endpoint with x402 Cloud?
- How Do I Execute Direct Transactions via the Wallet API?
- Why Isn't My x402 Endpoint Listed in the Marketplace?
- How Do I Use Private (Confidential) AI Models?
If you're a Bankr partner, you can programmatically create and manage wallets for your users. Each wallet gets an EVM address, plus an optional Solana address if your org has Solana enabled. That lets you build Bankr's DeFi capabilities directly into your own app while earning a share of the trading fees those wallets generate.
What You Need
A partner organization. Apply at bankr.bot/partner; the Bankr team provisions your org and enables the right capabilities.
A Partner Key. Every provisioning request authenticates with an org-level
X-Partner-Keyheader, which also links each new wallet to your fee-sharing configuration.
How It Works
One API call creates a wallet and immediately returns a new address for your user. Three options make the flow smoother:
Idempotency: pass your internal user ID as the
idempotencyKey. Retries are safe — if a wallet already exists for that key, Bankr returns the existing wallet instead of creating a duplicate.API key at creation: include an
apiKeyobject to generate a wallet-level API key in the same call, so the user (or your app on their behalf) can start making requests immediately. Keys are read-only unless you setreadOnly: falsein its permissions.Funding: the
fundoption sends ETH or tokens from your org wallet to the new wallet at creation, so the user's first transactions don't fail on gas.
Once provisioned, the wallet works like any Bankr wallet — depending on your org's capabilities it can check balances, submit transactions, run natural-language prompts through the Agent API, and deploy tokens with automatic fee sharing.
Good to Know
Partner launches get partner rate limits and your org's launch configuration, but the per-wallet daily launch limit still applies. Degen mode, vesting, and stock pairing aren't available on partner launches. See Partner Token Launching for current limits.
Fee distribution for your organization is returned in every deploy response.
For endpoints and full request/response shapes, see Wallet Provisioning on docs.bankr.bot.