Create a wallet

Guides

Create a wallet

Create wallets from your backend when you need a blockchain address for a customer, merchant, seller, recipient, player, internal account, treasury, or operational flow.

Before you begin

You need:

  • A ledger account ID
  • A signed API request
  • A chain currently returned by GET /api/v1/assets
  • The wallets:create API key scope
  • A unique X-Idempotency-Key

Request

bash
curl https://brosettlement-staging-api.brolabel.io/api/v1/wallets \
  -H "X-Api-Key-Id: 11111111-2222-4333-8444-555555555555" \
  -H "X-Api-Timestamp: 1785402000" \
  -H "X-Api-Nonce: 8f7b8f24-4e6a-45d2-a944-4b11c4c7d2f8" \
  -H "X-Api-Signature: base64_ed25519_signature" \
  -H "X-Api-Body-Hash: sha256_of_exact_body" \
  -H "X-Idempotency-Key: 018f4df0-5a7f-7352-bd4a-5fd069c2a0c1" \
  -H "Content-Type: application/json" \
  -d '{
"chain": "tron:nile",
"accountId": "ledger-account-id"
  }'

The signature and body hash must be calculated from the exact request target and exact body bytes sent by your HTTP client.

Response

json
{
  "id": "wallet-id",
  "chain": "tron:nile",
  "accountId": "ledger-account-id",
  "accountName": "Treasury",
  "address": "TQ9y...",
  "status": "ACTIVE",
  "createdAt": "2026-07-30T09:00:03Z",
  "updatedAt": "2026-07-30T09:00:03Z"
}

Store wallet metadata

Store these fields in your system:

  • id
  • accountId
  • chain
  • address
  • Your internal customer or account ID

Next step

Continue with Create a transaction when you are ready to send assets, and subscribe to WebSocket events for lifecycle updates.

Embedded walletsDesign wallet identity for customers, merchants, sellers, recipients, players, or internal accounts.