Skip to main content
This guide gives one user of your product their own address on Base.
1

Switch on Base

Open Dashboard → Wallets and activate Base. You only do this once. Every address you create after that sits under it.
2

Create a key

On the same page, create a new API key. We only show it once, so copy it straight away:
Keep it on your server, for example in an environment variable.
3

Create an address

Call the create-wallet endpoint with an ID for your user. Any text you’ll recognise later works, and your own user ID is a good choice.
Save address with your user. It’s where they can receive and hold money.
4

Call it again whenever you like

Sending the same request again, with the same walletRef, gives you the same wallet back instead of a second one. So you can call it during signup without first checking whether the user already has an address.

​
Using the address on another network

Once you’ve created an address, it already works on every network your plan includes, with nothing more to call. If you want to check that up front, pass chain:
This gives you back the address you already have, not a new one. Each walletRef only ever has one address, whichever network you ask about. If you ask for a network your plan doesn’t include, you’ll get a 400 instead.
Free plan wallets are Base only. Asking for another network returns a 400 until you upgrade.
You can add metadata (any JSON object) when you create a wallet. It’s a handy place to keep your own details, like an order ID or a plan name, that you’ll want back when you fetch the wallet later.