---

name: tron description: Interact with TRON blockchain - check TRX balances, view TRC-20 tokens, transactions, and account resources. Works with TronLink addresses. metadata: {"openclaw":{"requires":{"bins":["python3"]},"install":[{"id":"python","kind":"pip","package":"tronpy","bins":[],"label":"Install tronpy (pip)"}]}}

TRON Wallet CLI

Setup

Install tronpy:

pip install tronpy

Check TRX Balance

python3 -c "
from tronpy import Tron
client = Tron()
balance = client.get_account_balance('ADDRESS')
print(f'{balance} TRX')"

Account Info

python3 -c "
from tronpy import Tron
import json
client = Tron()
acc = client.get_account('ADDRESS')
print(json.dumps(acc, indent=2))"

Account Resources (Energy & Bandwidth)

python3 -c "
from tronpy import Tron
client = Tron()
res = client.get_account_resource('ADDRESS')
print(f\"Bandwidth: {res.get('freeNetLimit', 0)}\")
print(f\"Energy: {res.get('EnergyLimit', 0)}\")"

TRC-20 Token Balance

python3 -c "
from tronpy import Tron
from tronpy.contract import Contract

client = Tron()
# USDT TRC-20 contract
contract = client.get_contract('TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t')
balance = contract.functions.balanceOf('ADDRESS')
decimals = contract.functions.decimals()
print(f'{balance / 10**decimals} USDT')"

Token Info

python3 -c "
from tronpy import Tron
client = Tron()
contract = client.get_contract('CONTRACT_ADDRESS')
print(f\"Name: {contract.functions.name()}\")
print(f\"Symbol: {contract.functions.symbol()}\")
print(f\"Decimals: {contract.functions.decimals()}\")
print(f\"Total Supply: {contract.functions.totalSupply()}\")"

Transaction History (via API)

curl -s "https://api.trongrid.io/v1/accounts/ADDRESS/transactions?limit=10" | \
python3 -c "
import sys, json
data = json.load(sys.stdin)
for tx in data.get('data', []):
    print(f\"{tx['txID'][:16]}... | {tx.get('raw_data', {}).get('contract', [{}])[0].get('type', 'Unknown')}\")"

TRC-20 Transfers

curl -s "https://api.trongrid.io/v1/accounts/ADDRESS/transactions/trc20?limit=10" | \
python3 -c "
import sys, json
data = json.load(sys.stdin)
for tx in data.get('data', []):
    val = int(tx.get('value', 0)) / 10**int(tx.get('token_info', {}).get('decimals', 6))
    sym = tx.get('token_info', {}).get('symbol', '?')
    print(f\"{tx['transaction_id'][:16]}... | {val:.2f} {sym}\")"

Get Transaction

python3 -c "
from tronpy import Tron
import json
client = Tron()
tx = client.get_transaction('TX_HASH')
print(json.dumps(tx, indent=2))"

Current Block

python3 -c "
from tronpy import Tron
client = Tron()
block = client.get_latest_block()
print(f\"Block: {block['block_header']['raw_data']['number']}\")"

Check if Contract

python3 -c "
from tronpy import Tron
client = Tron()
try:
    contract = client.get_contract('ADDRESS')
    print('This is a contract')
    print(f'Name: {contract.name}')
except:
    print('This is a regular account')"

Using TronGrid API

Account info:

curl -s "https://api.trongrid.io/v1/accounts/ADDRESS" | python3 -m json.tool

Account balance:

curl -s "https://api.trongrid.io/v1/accounts/ADDRESS" | \
python3 -c "import sys,json; d=json.load(sys.stdin); print(f\"{d['data'][0].get('balance',0)/1e6:.2f} TRX\")"

Common TRC-20 Contracts

Token	Contract
USDT	TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
USDC	TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8
WTRX	TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR
BTT	TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4
JST	TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9

Address Format

• TRON uses Base58Check encoding
• Addresses start with 'T'
• Length: 34 characters
• Example: TJYeasTPa6gpBZWqTcP4u1Q7bhLMWBL7ox

Notes

• 1 TRX = 1,000,000 SUN
• Free bandwidth: 1500 per day
• Energy needed for smart contract calls
• TronGrid API has rate limits
• Use Shasta testnet for testing