tron-wallet

Original：🇺🇸 English
Translated

This skill should be used when the user asks to 'check my TRX balance', 'show my TRON holdings', 'what tokens do I have on TRON', 'check my TRON wallet', 'TronLink balance', 'view my TRC-20 tokens', 'TRON transaction history', 'account info on TRON', or mentions checking wallet balance, viewing transaction history, or managing a TronLink wallet. Do NOT use for swap/trading — use tron-swap instead. Do NOT use for staking — use tron-staking instead.

3installs
Sourcetronlink/tronlink-skills
Added on

NPX Install

npx skill4agent add tronlink/tronlink-skills tron-wallet

Tags

Translated version includes tags in frontmatter
tron-wallet-managementtrc20-holdingstransaction-historyaddress-validationwallet-commands

SKILL.md Content

View Translation Comparison →

TRON Wallet Management

6 commands for wallet balance, TRC-20 holdings, transaction history, account info, address validation, and multi-sig support.

Pre-flight Checks

  1. Confirm Node.js: Run `node -e "console.log('ok')" # Node.js >= 18 required
  2. API Key (optional): For higher rate limits, set:
    bash
    export TRONGRID_API_KEY="your-api-key"

Skill Routing

  • For token metadata / search → use 
    tron-token
  • For market prices / charts → use 
    tron-market
  • For DEX swap → use 
    tron-swap
  • For energy / bandwidth → use 
    tron-resource
  • For staking / voting → use 
    tron-staking

Commands

1. Check TRX Balance

bash
node scripts/tron_api.mjs wallet-balance --address <TRON_ADDRESS>
Returns: TRX balance (human-readable), frozen TRX, account creation time.

2. Check TRC-20 Token Balance

bash
node scripts/tron_api.mjs token-balance --address <TRON_ADDRESS> --contract <TOKEN_CONTRACT>
Common TRC-20 contracts:
TokenContract
USDT
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
USDC
TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8
WTRX
TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR
BTT
TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4
JST
TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9
SUN
TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S
WIN
TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7

3. Get All TRC-20 Holdings

bash
node scripts/tron_api.mjs wallet-tokens --address <TRON_ADDRESS>
Returns: list of all TRC-20 tokens with balances, symbols, and USD values.

4. Transaction History

bash
node scripts/tron_api.mjs tx-history --address <TRON_ADDRESS> --limit 20
Returns: recent transactions with type, amount, timestamp, status.

5. Account Info

bash
node scripts/tron_api.mjs account-info --address <TRON_ADDRESS>
Returns: account creation date, permissions, resource overview, frozen balances, voting info.

6. Validate Address

bash
node scripts/tron_api.mjs validate-address --address <ADDRESS>
Returns: whether the address is valid TRON Base58Check format.

Address Format Notes

  • TRON addresses start with 
    T
    and are 34 characters long (Base58Check)
  • Hex addresses start with 
    41
    and are 42 hex characters
  • Example: 
    TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL
  • The script accepts both formats and auto-converts

Common Token Contracts (Mainnet)

USDT:  TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
USDC:  TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8
WTRX:  TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR
TUSD:  TUpMhErZL2fhh4sVNULAbNKLokS4GjC1F4
BTT:   TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4
JST:   TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9
SUN:   TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S
WIN:   TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7
NFT:   TFczxzPhnThNSqr5by8tvxsdCFRRz6cPNq
APENFT: TFczxzPhnThNSqr5by8tvxsdCFRRz6cPNq

Troubleshooting

"Account not found": The address has never been activated on TRON. A minimum of 1 TRX must be sent to activate it.
"Bandwidth insufficient": The account has used up its daily free bandwidth (600). Either wait for daily reset, freeze TRX for bandwidth, or the transaction will burn TRX as fee.
"Energy insufficient for TRC-20": Smart contract calls require Energy. Freeze TRX for Energy via 
tron-staking
, or TRX will be burned (often 13-27 TRX for a USDT transfer).