List Node Wallets

Lists a node's custody wallets: id, chain, address, label and status. A node can hold several wallets, including several on the same chain, because each (wallet, network) pair backs its own setup. Wallet ids from this list are what setups, deploys and withdrawals take as wallet_id.

Balances are not included. Read one wallet's balances with Get Wallet Networks and Get Wallet Network Assets.

Required permission: node:summary:view

Request

GET /v2/admin/nodes/{node_id}/wallets

Parameters

Name	Type	In	Description
node_id	string	path	Required. The node's id
chain_id	string	query	Only wallets on this chain. A chain the node has no wallet on returns an empty list

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/admin/nodes/6a4bef2b1e781b11c22e9707/wallets?chain_id=6740e0a10000000000000101' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "data": [
    {
      "id": "6a53f3dfad48accdb46eaf9e",
      "chain": {
        "id": "6740e0a10000000000000101",
        "name": "EVM"
      },
      "address": "0xAF4bf547c4d354266449dB91fe0c4d8861cFfc0E",
      "label": "Safe-Main-Wallet",
      "status": "active"
    }
  ]
}

Response Fields

Field	Type	Description
data	array	The node's wallets. Not paginated
data[].id	string	Wallet id
data[].chain.id	string	Id of the chain the wallet lives on
data[].chain.name	string	Chain name. Empty when the chain could not be read
data[].address	string	On-chain address
data[].label	string	Operator-set name. Empty when not set; change it with Rename Wallet
data[].status	string	active or passive

Errors

Status	Code	Description
400	10016	node_id is not a valid id
400	10001	Node not found (node domain 2)
403	10005	The node is outside your part of the hierarchy (node domain 2)

See Errors for the error format and common codes.