List Balances

Returns all coin balances for an address using StateService/ListBalances. Query all assets in one request for efficient portfolio tracking.

Service

sui.rpc.v2.StateService

Parity

Direct

This method has a direct mapping from the JSON-RPC method suix_getAllBalances.

Request

Parameters

{
  "owner": "0x8f8ea04f3b751533db8b8da0a40eba1ca8332a92680f058d83b9459d061aaa54"
}

Example (grpcurl)

grpcurl -H "x-api-key: YOUR_API_KEY" \
  -d '{"owner":"0x8f8ea04f3b751533db8b8da0a40eba1ca8332a92680f058d83b9459d061aaa54"}' \
  grpc.surflux.dev:443 \
  sui.rpc.v2.StateService/ListBalances

▶Run in Playground

Response

The response structure is defined by the sui/rpc/v2/state_service.proto definition.

Response Fields

Field	Type	Description
balances	Balance	See proto definition
next_page_token	bytes	See proto definition

info

For full field definitions, please refer to the Sui Protobuf definitions.