GetAccount gRPC Method

Parameters

addr

string

REQUIRED

The account address

Returns

account_name

string

The account nick name

type

string

The account type (enum: AccountType)

Normal

integer

Normal account

AssetIssue

integer

Asset issuer account

Contract

integer

Contract account

address

string

The account address

balance

integer

The TRX balance

votes

array

The votes cast by this account

vote_address

string

The super representative address

vote_count

integer

The vote count for this super representative

asset

object

The other assets owned by this account

assetV2

object

The other assets owned by this account, key is assetId

frozen

array

The frozen balance for bandwidth

frozen_balance

integer

The frozen TRX balance

expire_time

integer

The expiration time

net_usage

integer

Bandwidth usage, derived from frozen balance

acquiredDelegatedFrozenBalanceForBandwidth

integer

Frozen balance provided by other accounts to this account

delegatedFrozenBalanceForBandwidth

integer

Freeze and provide balances to other accounts

old_tron_power

integer

Old TRON power value

tron_power

object

TRON power details

frozen_balance

integer

The frozen TRX balance

expire_time

integer

The expiration time

asset_optimized

boolean

Whether asset storage is optimized

create_time

integer

Account creation timestamp

latest_opration_time

integer

Last operation time, including transfer, voting, etc.

allowance

integer

Witness block producing allowance

latest_withdraw_time

integer

Last withdraw time

code

string

Contract code (not used so far)

is_witness

boolean

Whether this account is a witness

is_committee

boolean

Whether this account is a committee member

frozen_supply

array

Frozen asset supply (for asset issuer)

frozen_balance

integer

The frozen TRX balance

expire_time

integer

The expiration time

asset_issued_name

string

The name of the issued asset

asset_issued_ID

string

The ID of the issued asset

latestAssetOperationTime

object

Latest operation time for each asset

latestAssetOperationTimeV2

object

Latest operation time for each asset (V2)

free_net_usage

integer

Free bandwidth usage

freeAssetNetUsage

object

Free bandwidth usage for assets

freeAssetNetUsageV2

object

Free bandwidth usage for assets (V2)

latest_consume_time

integer

Latest resource consumption time

latestConsumeFreeTime

integer

Latest free resource consumption time

account_id

string

The identity of this account (case insensitive)

net_window_size

integer

Net window size

net_window_optimized

boolean

Whether net window is optimized

account_resource

object

Account resource information

energy_usage

integer

Energy resource usage, derived from frozen balance

frozenBalanceForEnergy

object

Frozen balance for energy

frozen_balance

integer

The frozen TRX balance

expire_time

integer

The expiration time

latestConsumeTimeForEnergy

integer

Latest energy consumption time

acquiredDelegatedFrozenBalanceForEnergy

integer

Frozen balance provided by other accounts for energy

delegatedFrozenBalanceForEnergy

integer

Frozen balances provided to other accounts for energy

storage_limit

integer

Storage resource limit, from market

storage_usage

integer

Storage resource usage

latestExchangeStorageTime

integer

Latest storage exchange time

energy_window_size

integer

Energy window size

delegatedFrozenV2BalanceForEnergy

integer

V2 frozen balances provided to other accounts for energy

acquiredDelegatedFrozenV2BalanceForEnergy

integer

V2 frozen balance provided by other accounts for energy

energyWindowOptimized

boolean

Whether energy window is optimized

codeHash

string

Hash of the contract code

owner_permission

object

Owner permission

type

string

Permission type (enum: Permission_PermissionType)

Owner

integer

Owner permission

Witness

integer

Witness permission

Active

integer

Active permission

id

integer

Permission ID (Owner=0, Witness=1, Active starts at 2)

permission_name

string

Permission name

threshold

integer

Permission threshold

parent_id

integer

Parent permission ID

operations

string

Operations (1 bit per contract)

keys

array

Permission keys

witness_permission

object

Witness permission

active_permission

array

Active permissions

frozenV2

array

V2 frozen balances

type

string

Resource type (enum: ResourceCode)

BANDWIDTH

integer

Bandwidth resource

ENERGY

integer

Energy resource

TRON_POWER

integer

TRON power resource

amount

integer

Frozen amount

unfrozenV2

array

V2 unfrozen balances

type

string

Resource type (enum: ResourceCode)

unfreeze_amount

integer

Unfrozen amount

unfreeze_expire_time

integer

Unfrozen expiration time

delegatedFrozenV2BalanceForBandwidth

integer

V2 frozen balances provided to other accounts for bandwidth

acquiredDelegatedFrozenV2BalanceForBandwidth

integer

V2 frozen balance provided by other accounts for bandwidth

Request

package main

import (
	"context"
	"crypto/tls"
	"encoding/json"
	"fmt"
	"log"
	"github.com/fbsobreira/gotron-sdk/pkg/client"
	"google.golang.org/grpc"
	"google.golang.org/grpc/credentials"
)

// QuickNode endpoints consist of two crucial components: the endpoint name and the corresponding token
// For eg: QN Endpoint: https://docs-demo.tron-mainnet.quiknode.pro/abcde123456789
// endpoint will be: docs-demo.tron-mainnet.quiknode.pro:50051  {50051 is the port number for Tron gRPC}
// token will be : abcde123456789

var token = "YOUR_TOKEN"
var endpoint = "YOUR_ENDPOINT:50051"

type auth struct {
	token string
}

func (a *auth) GetRequestMetadata(ctx context.Context, uri ...string) (map[string]string, error) {
	return map[string]string{
		"x-token": a.token,
	}, nil
}

func (a *auth) RequireTransportSecurity() bool {
	return false
}

func main() {
	
	opts := []grpc.DialOption{
		grpc.WithTransportCredentials(credentials.NewTLS(&tls.Config{})),
		grpc.WithPerRPCCredentials(&auth{token}),
	}
	conn := client.NewGrpcClient(endpoint)
	if err := conn.Start(opts...); err != nil {
		panic(err)
	}
	defer conn.Conn.Close()

	addr := "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g"
	acc, err := conn.GetAccount(addr)
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println("Account information:")
	fmt.Printf("Address: %s\n", addr)
	fmt.Printf("Balance: %d TRX\n", acc.GetBalance()/1000000) // Convert from SUN to TRX
	fmt.Printf("Account name: %s\n", string(acc.GetAccountName()))
	fmt.Printf("Create time: %d\n", acc.GetCreateTime())

	resultJSON, err := json.MarshalIndent(acc, "", "  ")
	if err != nil {
		log.Fatal("Error marshaling account to JSON:", err)
	}
	fmt.Println("\nComplete account object (JSON):")
	fmt.Println(string(resultJSON))
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free