Hanzo
OpenapiWallet

Returns the caller org's wallets, newest first, optionally NARROWED within the…

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 wallets list

Wallet API · All Hanzo APIs · Interactive reference

How is this guide?

On this page