API Reference
Support

QuickStart

Using a Shared gRPC Endpoint for Tron Node.

General gRPC Capability and Functional Background

Tron gRPC API provides high-performance access to network data via gRPC interfaces. It serves as a powerful tool for developers who need to:

  • Lower latency and higher throughput – gRPC leverages HTTP/2 and binary Protobuf encoding for faster, more efficient communication than JSON-RPC.
  • Strongly typed APIs – Protocol buffer definitions enable compile-time safety and reduce integration errors.
    Native streaming support – Clients can subscribe to real-time data (e.g., checkpoints or events) without polling.
  • Reduced resource consumption – Efficient serialization and connection reuse lower bandwidth and CPU usage.
  • Multi-language client generation – Auto-generated SDKs in Go, Rust, Python, TypeScript, and more simplify integration.

Support areas

  • supported networks：tron-mainnet

  • supported methods：

    Column 1Column 2Column 3
    protocol.Wallet/GetAccountprotocol.Wallet/GetAccountByIdprotocol.Wallet/GetAccountBalance
    protocol.Wallet/GetBlockBalanceTraceprotocol.Wallet/CreateTransactionprotocol.Wallet/CreateTransaction2
    protocol.Wallet/BroadcastTransactionprotocol.Wallet/UpdateAccountprotocol.Wallet/SetAccountId
    protocol.Wallet/UpdateAccount2protocol.Wallet/VoteWitnessAccountprotocol.Wallet/VoteWitnessAccount2
    protocol.Wallet/CreateAssetIssueprotocol.Wallet/CreateAssetIssue2protocol.Wallet/UpdateWitness
    protocol.Wallet/UpdateWitness2protocol.Wallet/CreateAccountprotocol.Wallet/CreateAccount2
    protocol.Wallet/CreateWitnessprotocol.Wallet/CreateWitness2protocol.Wallet/TransferAsset
    protocol.Wallet/TransferAsset2protocol.Wallet/ParticipateAssetIssueprotocol.Wallet/ParticipateAssetIssue2
    protocol.Wallet/FreezeBalanceprotocol.Wallet/FreezeBalance2protocol.Wallet/FreezeBalanceV2
    protocol.Wallet/UnfreezeBalanceprotocol.Wallet/UnfreezeBalance2protocol.Wallet/UnfreezeBalanceV2
    protocol.Wallet/UnfreezeAssetprotocol.Wallet/UnfreezeAsset2protocol.Wallet/WithdrawBalance
    protocol.Wallet/WithdrawBalance2protocol.Wallet/WithdrawExpireUnfreezeprotocol.Wallet/DelegateResource
    protocol.Wallet/UnDelegateResourceprotocol.Wallet/CancelAllUnfreezeV2protocol.Wallet/UpdateAsset
    protocol.Wallet/UpdateAsset2protocol.Wallet/ProposalCreateprotocol.Wallet/ProposalApprove
    protocol.Wallet/ProposalDeleteprotocol.Wallet/BuyStorageprotocol.Wallet/BuyStorageBytes
    protocol.Wallet/SellStorageprotocol.Wallet/ExchangeCreateprotocol.Wallet/ExchangeInject
    protocol.Wallet/ExchangeWithdrawprotocol.Wallet/ExchangeTransactionprotocol.Wallet/MarketSellAsset
    protocol.Wallet/MarketCancelOrderprotocol.Wallet/GetMarketOrderByIdprotocol.Wallet/GetMarketOrderByAccount
    protocol.Wallet/GetMarketPriceByPairprotocol.Wallet/GetMarketOrderListByPairprotocol.Wallet/GetMarketPairList
    protocol.Wallet/ListNodesprotocol.Wallet/GetAssetIssueByAccountprotocol.Wallet/GetAccountNet
    protocol.Wallet/GetAccountResourceprotocol.Wallet/GetAssetIssueByNameprotocol.Wallet/GetAssetIssueListByName
    protocol.Wallet/GetAssetIssueByIdprotocol.Wallet/GetNowBlockprotocol.Wallet/GetNowBlock2
    protocol.Wallet/GetBlockByNumprotocol.Wallet/GetBlockByNum2protocol.Wallet/GetTransactionCountByBlockNum
    protocol.Wallet/GetBlockByIdprotocol.Wallet/GetBlockByLimitNextprotocol.Wallet/GetBlockByLimitNext2
    protocol.Wallet/GetBlockByLatestNumprotocol.Wallet/GetBlockByLatestNum2protocol.Wallet/GetTransactionById
    protocol.Wallet/DeployContractprotocol.Wallet/GetContractprotocol.Wallet/GetContractInfo
    protocol.Wallet/TriggerContractprotocol.Wallet/TriggerConstantContractprotocol.Wallet/EstimateEnergy
    protocol.Wallet/ClearContractABIprotocol.Wallet/ListWitnessesprotocol.Wallet/GetDelegatedResource
    protocol.Wallet/GetDelegatedResourceV2protocol.Wallet/GetDelegatedResourceAccountIndexprotocol.Wallet/GetDelegatedResourceAccountIndexV2
    protocol.Wallet/GetCanDelegatedMaxSizeprotocol.Wallet/GetAvailableUnfreezeCountprotocol.Wallet/GetCanWithdrawUnfreezeAmount
    protocol.Wallet/ListProposalsprotocol.Wallet/GetPaginatedProposalListprotocol.Wallet/GetProposalById
    protocol.Wallet/ListExchangesprotocol.Wallet/GetPaginatedExchangeListprotocol.Wallet/GetExchangeById
    protocol.Wallet/GetChainParametersprotocol.Wallet/GetAssetIssueListprotocol.Wallet/GetPaginatedAssetIssueList
    protocol.Wallet/TotalTransactionprotocol.Wallet/GetNextMaintenanceTimeprotocol.Wallet/GetTransactionInfoById
    protocol.Wallet/AccountPermissionUpdateprotocol.Wallet/GetTransactionSignWeightprotocol.Wallet/GetTransactionApprovedList
    protocol.Wallet/GetNodeInfoprotocol.Wallet/GetRewardInfoprotocol.Wallet/GetBrokerageInfo
    protocol.Wallet/UpdateBrokerageprotocol.Wallet/CreateShieldedTransactionprotocol.Wallet/GetMerkleTreeVoucherInfo
    protocol.Wallet/ScanNoteByIvkprotocol.Wallet/ScanAndMarkNoteByIvkprotocol.Wallet/ScanNoteByOvk
    protocol.Wallet/GetSpendingKeyprotocol.Wallet/GetExpandedSpendingKeyprotocol.Wallet/GetAkFromAsk
    protocol.Wallet/GetNkFromNskprotocol.Wallet/GetIncomingViewingKeyprotocol.Wallet/GetDiversifier
    protocol.Wallet/GetZenPaymentAddressprotocol.Wallet/GetRcmprotocol.Wallet/IsSpend
    protocol.Wallet/CreateShieldedTransactionWithoutSpendAuthSigprotocol.Wallet/GetShieldTransactionHashprotocol.Wallet/CreateSpendAuthSig
    protocol.Wallet/CreateShieldNullifierprotocol.Wallet/CreateShieldedContractParametersprotocol.Wallet/CreateShieldedContractParametersWithoutAsk
    protocol.Wallet/ScanShieldedTRC20NotesByIvkprotocol.Wallet/ScanShieldedTRC20NotesByOvkprotocol.Wallet/IsShieldedTRC20ContractNoteSpent
    protocol.Wallet/GetTriggerInputForShieldedTRC20Contractprotocol.Wallet/CreateCommonTransactionprotocol.Wallet/GetTransactionInfoByBlockNum
    protocol.Wallet/GetBurnTrxprotocol.Wallet/GetTransactionFromPendingprotocol.Wallet/GetTransactionListFromPending
    protocol.Wallet/GetPendingSizeprotocol.Wallet/GetBlockprotocol.Wallet/GetBandwidthPrices
    protocol.Wallet/GetEnergyPricesprotocol.Wallet/GetMemoFeeprotocol.Database/getBlockReference
    protocol.Database/GetDynamicPropertiesprotocol.Database/GetNowBlockprotocol.Database/GetBlockByNum

Integration Method

  1. grpc endpoint：https://grpc.zan.top
  2. Metadata:
    1. x-token: api key（Required）
    2. x-network: ecosystem network（Required：tron-mainnet）

Integration Example Guide

  • Steps 
    # Example for Linux AMD64
> wget https://github.com/fullstorydev/grpcurl/releases/download/v1.9.3/grpcurl_1.9.3_linux_x86_64.tar.gz
tar -xvf grpcurl_1.9.3_linux_x86_64.tar.gz

> mv grpcurl /usr/local/bin/

> grpcurl --version
grpcurl v1.9.3

# Clone the repository with minimal depth
> git clone https://github.com/tronprotocol/protocol.git --depth=1

> git clone https://github.com/googleapis/googleapis.git --depth=1

> cp -r googleapis/google protocol/

> cd protocol/

  • EstimateEnergy 
    grpcurl -proto api/api.proto \
  -d '{"token_id":xxx}' \
  -H "x-token: xxx" \
  -H "x-network: tron-mainnet" \
  grpc.zan.top:443 \
  protocol.Wallet/EstimateEnergy

  • GetAssetIssueList 
    grpcurl -proto api/api.proto \
  -d '{}' \
  -H "x-token: xxx" \
  -H "x-network: tron-mainnet" \
  grpc.zan.top:443 \
  protocol.Wallet/GetAssetIssueList

proto

https://github.com/tronprotocol/protocol


Updated 5 months ago

Updated 5 months ago