Skip to main content
POST
/
v1
/
server
/
wallets
/
{walletId}
/
accounts
Create Server Account
curl --request POST \
  --url https://api.example.com/v1/server/wallets/{walletId}/accounts \
  --header 'Content-Type: application/json' \
  --header 'X-Access-Key: <x-access-key>' \
  --header 'X-Signature: <x-signature>' \
  --header 'X-Timestamp: <x-timestamp>' \
  --data '
{
  "accountIndex": 123,
  "accountName": "<string>"
}
'
{
  "account": {}
}

Create Server Account

Create a new account within a server wallet for organizing addresses.

Authentication

X-Access-Key
string
required
API access key
X-Signature
string
required
HMAC-SHA256 signature
X-Timestamp
string
required
ISO 8601 timestamp

Path Parameters

walletId
string
required
The server wallet identifier

Request Body

accountIndex
integer
required
The BIP-44 account index
accountName
string
Display name for the account

Response

account
object
Created account object

Example

curl -X POST https://api.axonvault.io/v1/server/wallets/wal_abc123/accounts \
  -H "X-Access-Key: ak_live_abc123" \
  -H "X-Signature: sha256=..." \
  -H "X-Timestamp: 2024-01-15T10:30:00Z" \
  -H "Content-Type: application/json" \
  -d '{
    "accountIndex": 0,
    "accountName": "Treasury"
  }'
Response:
{
  "account": {
    "accountId": "acc_xyz789",
    "walletId": "wal_abc123",
    "accountIndex": 0,
    "accountName": "Treasury",
    "createdAt": "2024-01-15T10:30:00Z"
  }
}