tron-staking

TRON Staking (Stake 2.0)

3 commands for SR list, staking info, and APY estimation (read-only queries).

TRON Stake 2.0 — Essential Knowledge

Stake 2.0 replaced the legacy Stake 1.0 system. Key differences:

• Freezing and voting are separate operations (Stake 1.0 combined them)
• Resources can be delegated to other addresses
• Unfreezing has a 14-day waiting period before TRX can be withdrawn
• Voting for Super Representatives (SRs) earns TRX rewards (~3-5% APY)

Staking Lifecycle

Freeze TRX → Get Energy or Bandwidth → Vote for SR → Earn Rewards → Unfreeze → Wait 14 days → Withdraw

Resolve the CLI path

Every command below runs node "$TRON_API". Set $TRON_API once per session so it works no matter how the skill was installed (Claude Code plugin, install.sh → ~/.tronlink-skills, or inside the cloned repo):

TRON_API="${CLAUDE_PLUGIN_ROOT:-$HOME/.tronlink-skills}/scripts/tron_api.mjs"
[ -f "$TRON_API" ] || TRON_API="scripts/tron_api.mjs"   # fallback when run inside the repo

Read-only / informational: this skill explains staking and reads on-chain staking state, APY, and SR data. It does not freeze/unfreeze, vote, or claim — those require signing in the TronLink wallet itself.

Commands

1. Super Representative List

node "$TRON_API" sr-list --limit 30

Returns: SR name, address, total votes, vote percentage, block production rate, APY estimate, commission rate.

2. My Staking Info

node "$TRON_API" staking-info --address <TRON_ADDRESS>

Returns:

• TRX frozen for Energy (amount, unlock date)
• TRX frozen for Bandwidth (amount, unlock date)
• TRON Power (total votes available)
• Current votes (which SRs, how many)
• Unclaimed rewards
• Pending unfreezes (amount, unlock date)
• Delegated resources — the addresses this account delegated to / received from (per-pair amounts require a deeper getdelegatedresourcev2 lookup)

3. APY Estimation

node "$TRON_API" staking-apy --amount <TRX_TO_STAKE>

Returns: estimated annual yield based on current network parameters, SR rewards, and commission rates.

Top Super Representatives (Reference)

SR	Focus	Commission
Poloniex	Exchange	20%
Binance Staking	Exchange	20%
SUN Community	DeFi	0% (community)
JustinSunTron	Foundation	20%
CryptoGuyInZA	Community	0%
sesameseed	Community	Compound

⚠️ SR list changes frequently. Always check current data with sr-list.

Staking Strategy Guide for Agents

For Frequent Users (Daily TRC-20 Transfers)

• Freeze enough TRX to cover daily Energy needs (~65,000 Energy per USDT transfer)
• Rule of thumb: 1 TRX frozen ≈ 4.5 Energy per day
• For 1 USDT transfer/day: freeze ~14,500 TRX
• Vote for highest-APY SR to earn rewards

For Occasional Users

• Keep TRX liquid, accept burning for occasional transactions
• Or rent Energy from marketplace (cheaper for < 5 tx/month)

For Passive Income

• Freeze all available TRX
• Vote for SRs with lowest commission and highest APY
• Claim rewards every few days (claiming itself costs minimal bandwidth)
• Compound by re-freezing claimed rewards

Common Pitfalls

"Cannot unfreeze": TRX has not been frozen for the minimum 14 days, or you have pending votes that need to be removed first.

"Insufficient TRON Power": You're trying to vote with more TP than you have frozen. Check staking-info for available TP.

"Withdraw failed": The 14-day unfreeze waiting period has not completed. Check pending unfreezes in staking-info.

"Reward is 0": You haven't voted, or the maintenance cycle (6 hours) hasn't completed yet. Vote first, then wait at least 6 hours.