List Wallets
GET /v1/wallets/{account_id}
Retrieves a paginated list of wallets for a specific account, including their assigned networks.
Headers
| Header | Required | Value |
|---|---|---|
Authorization | Yes | Bearer <token> |
X-Target-Server | Yes | wallets |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
account_id | string (UUID) | Yes | Account ID |
Query Parameters
| Parameter | Type | Required | Default | Validation | Description |
|---|---|---|---|---|---|
page | integer | No | 1 | min: 1 | Page number |
limit | integer | No | 10 | min: 1, max: 100 | Items per page |
exclude_ids | string (UUID[]) | No | -- | Each must be a valid UUID | Wallet IDs to exclude from results |
include_balance | boolean | No | false | -- | Whether to include balance information |
Response
200 OK
{
"data": [
{
"id": "990e8400-e29b-41d4-a716-446655440000",
"name": "My Hot Wallet",
"account_id": "660e8400-e29b-41d4-a716-446655440000",
"chain_id": "550e8400-e29b-41d4-a716-446655440000",
"address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
"custody_wallet_id": "aae8400-e29b-41d4-a716-446655440000",
"type": "hot",
"status": 1,
"created_at": "2025-01-01T00:00:00Z",
"updated_at": "2025-01-01T00:00:00Z",
"deleted_at": null,
"networks": [
{
"id": "770e8400-e29b-41d4-a716-446655440000",
"name": "Ethereum Mainnet",
"network_id": 1,
"chain_id": "550e8400-e29b-41d4-a716-446655440000",
"native_currency": {
"id": "00000000-0000-0000-0000-000000000000",
"name": "ETH",
"symbol": "ETH",
"decimals": 18,
"address": null,
"logo_url": null,
"balance": "1.500000000000000000"
}
}
]
}
],
"page": 1,
"per_page": 10,
"total": 1
}
note
The networks array and balance data are only populated when include_balance=true. Without it, the networks field may be empty.
401 Unauthorized
404 Not Found
Account not found.