Skip to main content
POST
/
v1
/
server
/
wallets
Create Server Wallet
curl --request POST \
  --url https://api.example.com/v1/server/wallets \
  --header 'Content-Type: application/json' \
  --data '
{
  "walletName": "<string>"
}
'
{
  "wallet": {
    "walletId": "<string>",
    "tenantId": "<string>",
    "projectId": "<string>",
    "keyId": "<string>",
    "walletName": "<string>",
    "createAt": "<string>",
    "updateAt": "<string>"
  }
}

​
Create Server Wallet

Create a new HD wallet managed by your backend service. Server wallets are ideal for treasury management, automated trading, and payment processing.

​
Request

​
walletName
string
required
Display name for the wallet

​
Response

​
wallet
object

​
Example

curl -X POST https://api.axonvault.io/v1/server/wallets \
  -H "X-Access-Key: ak_live_abc123" \
  -H "X-Signature: 5d41402abc4b2a76b9719d911017c592" \
  -H "X-Timestamp: 2024-01-15T10:30:00Z" \
  -H "Content-Type: application/json" \
  -d '{
    "walletName": "Treasury Wallet"
  }'

​
Response Example

{
  "wallet": {
    "walletId": "wlt_srv_abc123",
    "tenantId": "ten_abc123",
    "projectId": "proj_abc123",
    "keyId": "key_xyz789",
    "walletName": "Treasury Wallet",
    "createAt": "2024-01-15T10:30:00Z",
    "updateAt": "2024-01-15T10:30:00Z"
  }
}

​
Errors

Error TypeStatusDescription
invalid_request400Missing wallet name
unauthorized401Invalid credentials
already_exists409Wallet name already exists

​
Next Steps

After creating a wallet:
  1. Create an account within the wallet
  2. Derive addresses for different chains
  3. Configure policies for risk management