Skip to main content
GET
/
v1
/
server
/
wallets
/
{walletId}
/
addresses
List Addresses by Wallet
curl --request GET \
  --url https://api.example.com/v1/server/wallets/{walletId}/addresses \
  --header 'X-Access-Key: <x-access-key>' \
  --header 'X-Signature: <x-signature>' \
  --header 'X-Timestamp: <x-timestamp>'
{
  "addresses": [
    {}
  ],
  "nextCursor": "<string>"
}

​
List Addresses by Wallet

Retrieve all blockchain addresses derived for a server wallet across all accounts.

​
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

​
Query Parameters

​
chainId
string
Filter by chain identifier
​
accountId
string
Filter by account identifier
​
limit
integer
default:"20"
Maximum number of addresses to return
​
cursor
string
Pagination cursor

​
Response

​
addresses
array
Array of address objects
​
nextCursor
string
Cursor for next page

​
Example

curl -X GET "https://api.axonvault.io/v1/server/wallets/wal_abc123/addresses?chainId=eip155:1" \
  -H "X-Access-Key: ak_live_abc123" \
  -H "X-Signature: sha256=..." \
  -H "X-Timestamp: 2024-01-15T10:30:00Z"
Response: 
{
  "addresses": [
    {
      "addressId": "addr_abc123",
      "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00",
      "chainId": "eip155:1",
      "derivationPath": "m/44'/60'/0'/0/0",
      "accountId": "acc_xyz789",
      "walletId": "wal_abc123",
      "createdAt": "2024-01-15T10:35:00Z"
    },
    {
      "addressId": "addr_def456",
      "address": "0x1234567890123456789012345678901234567890",
      "chainId": "eip155:1",
      "derivationPath": "m/44'/60'/1'/0/0",
      "accountId": "acc_abc456",
      "walletId": "wal_abc123",
      "createdAt": "2024-01-16T08:00:00Z"
    }
  ],
  "nextCursor": null
}