Skip to main content
POST
/
api
/
v0
/
wallets
Create a new wallet
curl --request POST \
  --url https://api.brl.xyz/api/v0/wallets \
  --header 'Content-Type: application/json' \
  --data '
{
  "wallet-name": "My Trading Wallet",
  "chain": "eth-base",
  "source-tax-id": "12345678900",
  "metadata": {
    "label": "treasury"
  },
  "ui-enabled": false
}
'
{
  "wallet": {
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "assets": [
      "eth-base/brlv",
      "eth-base/wbrly"
    ],
    "pix-key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Body

application/json
​
wallet-name
string
required

Name for the new wallet

Example:

"My Trading Wallet"

​
chain
enum<string>

Blockchain that this wallet will be supported on. Required when source-tax-id is not provided.

Available options:
eth-mainnet,
eth-base
Example:

"eth-base"

​
source-tax-id

CPF or CNPJ of the expected PIX sender. When provided, creates a wallet with an attached bank account (PIX EVP key) on the Base chain.

Example:

"12345678900"

​
metadata
object

Custom metadata to associate with the wallet

Example:
{ "label": "treasury" }
​
ui-enabled
boolean

Whether this wallet should be visible in the UI (defaults to false)

Example:

false

Response

Wallet created successfully

​
wallet
object
required