Skip to content

Your first wallet

Use any HTTP client to create a wallet and check its opening balance.

Choose a network from the network directory. This example uses Bubblegum. Send GET / to your chosen host and check that meta.network matches your choice. Use that host for both wallet requests.

Send this request once, with an empty body. Each request creates a new wallet.

POST /wallets

The API returns 201 Created. Copy your address from data.public.address. Save data.private in secure storage alongside your address and network. It contains your trade token, transfer token, and recovery phrase. The API returns them only at creation.

Replace {address} with the address you just copied. This request needs no token.

GET /wallets/{address}/balances

The API returns 200 OK with an empty list in data.public. You’ve read your wallet’s balance. The list is empty because the wallet has never held an asset.

To fund your wallet, mine synthetic USD.