Skip to main content
The Wallet API lets you give every user of your own product a dedicated on-chain address. You call one endpoint with a reference for your user, and get back a real address on the chain you choose. Use it to add deposit addresses to your app, issue a wallet per customer or per order, or build on-chain functionality without becoming a wallet provider yourself.

​
No keys to manage

Creating an address through this API doesn’t hand you or your end users a private key or seed phrase to store. There’s nothing to generate, back up, or lose on your side of the integration.

​
Master wallets and addresses

Every address you generate belongs to a master wallet: one container you activate per chain. Activate Base (or another chain) from your dashboard, and every subsequent address on that chain is issued under it.
1

Activate a chain

From Dashboard → Wallets, activate the chain you want to issue addresses on. Base is available on every plan.
2

Generate an API key

Create a key from the same page. Keys use the wsk_live_ prefix.
3

Create an address

POST /api/v1/wallets with a reference for your user. Calling it again with the same reference returns the same address; it never mints a second one.

​
Detecting deposits

Every address you create is watched. When one receives funds, Minisend records the deposit and delivers a wallet.deposit.received webhook to the same webhook URL configured in Settings. You can also read deposits directly, and check a wallet’s live balance, without waiting on a webhook:

Get balance

A wallet’s current USDC balance, read live from the chain.

Get wallet deposits

Deposit history for one wallet.

List all deposits

Every deposit across your account, for reconciliation.
There’s no transfer or sweep capability yet: funds are detected and reported, not moved. See Wallet API webhooks for the event and its known chain caveat.

​
Pricing

The address allowance resets every calendar month and counts addresses created that month, not your running total. On Growth, going over 2,000 in a month never blocks you: extra addresses are billed at $0.50 each rather than rejected. Free has no billing behind it, so it blocks once the 100 included addresses are used. “Any 3 of 6” is a count, not a fixed set: pick which three of the six supported chains (Base, Ethereum, Polygon, Arbitrum, Optimism, Avalanche) are active, and swap one out for another later. Creating an address on a chain you haven’t activated, or activating a fourth chain on Growth, returns a 400 naming the limit. Contact Minisend to choose a plan or move to Enterprise.

​
No test mode

There is no sandbox for the Wallet API today. Keys are live-only, and every address you create is a real address on mainnet. Build against small real amounts, and use a throwaway walletRef prefix if you want your experiments easy to identify later. If a sandbox would block your integration, tell us — it helps us prioritise.

Create your first wallet

Activate a chain, generate a key, and issue an address end to end.