Hanzo
OpenapiWallet

Returns one of the caller org's wallets: its scope, custody kind, tier, chain…

Returns one of the caller org's wallets: its scope, custody kind, tier, chain and on-chain address.

GET /v1/wallet/{id}

Addresshttps://api.hanzo.ai/v1/wallet/{id}
MethodGET
Operationget_wallet_by_id
AuthAuthorization: Bearer $HANZO_API_KEY

Returns one of the caller org's wallets: its scope, custody kind, tier, chain and on-chain address. The custody handle to the signing material is never part of the answer. A wallet id another org owns reads as not found, so the response cannot confirm that it exists.

Request

1 field.

FieldInTypeRequiredDescription
idpathstringyes

Response

StatusBodyMeaning
200Walletok

200 body — 12 fields.

FieldInTypeAlwaysDescription
accountIdbodystring
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…
agentbodystring
chainbodystringChain is the EVM chain the wallet is bound to, CAIP-2 "eip155:<n>" or a bare decimal chain id.
createdAtbodyintegerCreatedAt is when the wallet was provisioned, Unix seconds.
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…
financeAccountbodystringFinanceAccount is the finance ledger account bound to this wallet — the lookup that turns a ledger account back into an on-chain signer.
idbodystringID is the wallet id, minted by the server as "wal_" + 24 hex.
namebodystringName is the display label given at creation.
orgbodystring
projectbodystring
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 get <id>

Wallet API · All Hanzo APIs · Interactive reference

How is this guide?

On this page