GetAccountNet - Tron

Example code for the GetAccountNet gRPC method. Complete guide on how to use GetAccountNet gRPC method in GetBlock Web3 documentation.

This method returns an account's Bandwidth (network) state: free and staked Bandwidth limits, usage, and the network Bandwidth pool.

Service

This method is served by the protocol.Wallet service.

Method

rpc GetAccountNet (Account) returns (AccountNetMessage)

Request Message

Account

Field	Type	Description
address	bytes	Account address as raw bytes (41-prefixed)

Request

grpcurl

grpcurl -H 'x-api-key: <ACCESS-TOKEN>' \
  -d '{"address": "41f0cc5a2a84cd0f68ed1667070934542d673acbd8"}' \
  go.getblock.io:443 protocol.Wallet/GetAccountNet

Python

example.py

import grpc
# Stubs generated from java-tron's api.proto with grpcio-tools
from api import api_pb2_grpc
from core import Contract_pb2, Tron_pb2

creds = grpc.ssl_channel_credentials()
channel = grpc.secure_channel('go.getblock.io:443', creds)
metadata = [('x-api-key', '<ACCESS-TOKEN>')]
stub = api_pb2_grpc.WalletStub(channel)

response = stub.GetAccountNet(Tron_pb2.Account(address=bytes.fromhex('41f0cc5a2a84cd0f68ed1667070934542d673acbd8')), metadata=metadata)
print(response)

Go

example.go

conn, _ := grpc.Dial(
    "go.getblock.io:443",
    grpc.WithTransportCredentials(credentials.NewTLS(&tls.Config{})),
)
defer conn.Close()

client := api.NewWalletClient(conn)
ctx := metadata.AppendToOutgoingContext(
    context.Background(), "x-api-key", "<ACCESS-TOKEN>")

resp, _ := client.GetAccountNet(ctx, &core.Account{Address: addrBytes})
fmt.Println(resp)

Response Message

AccountNetMessage

Field	Type	Description
freeNetLimit	int64	Free Bandwidth available to every account
NetLimit	int64	Bandwidth available from staked TRX
NetUsed	int64	Bandwidth consumed in the current window
TotalNetLimit	int64	Total Bandwidth pool across the network

Use Cases

• Bandwidth Checks: Read available Bandwidth before broadcasting

• Free Quota: Track the free daily Bandwidth allowance

• Staking Decisions: Gauge whether to stake for Bandwidth

• Monitoring: Track Bandwidth usage over time

Error Handling

Code	Status	Description
3	INVALID_ARGUMENT	A request field is missing or malformed
5	NOT_FOUND	The requested account, block, or transaction does not exist
16	UNAUTHENTICATED	The access token is missing or invalid
13	INTERNAL	The node failed to process the request