Hanzo AI
OpenapiWallet

List wallet

Returns the caller org's wallets, newest first, optionally NARROWED within the org by project, agent or account.

GET /v1/wallet

Addresshttps://api.hanzo.ai/v1/wallet
MethodGET
Operationget_wallet
AuthAuthorization: Bearer $HANZO_API_KEY

Returns the caller org's wallets, newest first, optionally NARROWED within the org by project, agent or account. The org is always the bound isolation boundary — the filters only ever narrow inside it, so a caller can never widen past its own org.

Request

3 fields.

FieldInTypeRequiredDescription
projectquerystringProject narrows to wallets scoped to one project.
agentquerystringAgent narrows to wallets scoped to one agent.
accountquerystringAccount narrows to wallets under one account id.

Response

StatusBodyMeaning
200walletListok

200 body — 13 fields.

FieldInTypeAlwaysDescription
walletsbodyWallet[]Wallets are the matching wallets, newest first.
wallets[].accountIdbodystring
wallets[].addressbodystringAddress is the on-chain address. For kms/mpc/treasury it is the EOA a signature from this wallet recovers to; for safe it is the CREATE2 address of the Safe…
wallets[].agentbodystring
wallets[].chainbodystringChain is the EVM chain the wallet is bound to, CAIP-2 "eip155:<n>" or a bare decimal chain id.
wallets[].createdAtbodyintegerCreatedAt is when the wallet was provisioned, Unix seconds.
wallets[].custodybodystringCustody is the backend holding the signing material, fixed at creation: "kms" (a secp256k1 key sealed under KMS and opened in-process), "mpc" or "treasury" (an…
wallets[].financeAccountbodystringFinanceAccount is the finance ledger account bound to this wallet — the lookup that turns a ledger account back into an on-chain signer.
wallets[].idbodystringID is the wallet id, minted by the server as "wal_" + 24 hex.
wallets[].namebodystringName is the display label given at creation.
wallets[].orgbodystring
wallets[].projectbodystring
wallets[].tierbodystringTier is the wallet tier the ring keys its TierPolicy on: hot, warm, cold, gas, bridge, contract_admin, validator, quarantine or disaster_recovery.

Failure carries the platform error shape — see Errors.

Examples

hanzo wallet list

Wallet API · All Hanzo APIs · Interactive reference

How is this guide?

On this page