Hanzo
OpenapiWeb3

Reads an address's native balance on a chain.

Reads an address's native balance on a chain.

GET /v1/web3/tokens/{chain}/{address}

Addresshttps://api.hanzo.ai/v1/web3/tokens/{chain}/{address}
MethodGET
Operationget_web3_tokens_by_chain_by_address
AuthAuthorization: Bearer $HANZO_API_KEY

Reads an address's native balance on a chain.

ERC-20 positions are NOT enumerated here: eth_getBalance answers the native one, but "every token this address holds" is an indexer question — there is no RPC call that answers it, and walking a token list would return a number that silently omits whatever the list missed. explorer owns the indexer relationship; this returns the balance the chain itself can prove.

Request

2 fields.

FieldInTypeRequiredDescription
chainpathstringyesChain is the registry id.
addresspathstringyesAddress is the account, 0x-prefixed.

Response

StatusBodyMeaning
200balancesok

200 body — 3 fields.

FieldInTypeAlwaysDescription
addressbodystringAddress is the account they belong to.
chainbodystringChain is the chain the balances were read from.
nativebodystringNative is the chain's own currency, as a 0x-quantity — the RPC's own encoding, not a float, because a wei value does not survive float64.

Failure carries the platform error shape — see Errors.

Examples

hanzo has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.


Web3 API · All Hanzo APIs · Interactive reference

How is this guide?

On this page