list_tron_witnesses
List TRON Super Representatives and candidates ranked by votes, with APR estimates. Optionally include your vote allocation to plan your next vote.
Instructions
List TRON Super Representatives (SRs) + SR candidates, ranked by total vote count. Active SRs (rank ≤ 27, isActive: true) produce blocks and distribute the 160 TRX/block voter-reward pool pro-rata to their voters; every witness in the top 127 shares the same APR estimate (pro-rata split of the pool); witnesses ranked > 127 get estVoterApr: 0. APR estimates assume current mainnet constants (3-second blocks, 27 active SRs, 365 days/year) and are best-effort — actual rewards depend on missed blocks and competing voters shifting between your vote tx and reward claim. When address is passed, also returns userVotes, totalTronPower, totalVotesCast, and availableVotes so you can diff against a target allocation before calling prepare_tron_vote. Defaults to top-27 only; pass includeCandidates: true for the long tail.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | No | Optional base58 TRON address. When provided, the response also includes the wallet's current vote allocation, total TRON Power (frozenV2 sum in whole TRX), and remaining available votes — diff these against your target allocation before building `prepare_tron_vote`. | |
| includeCandidates | No | Include SR candidates (rank > 27) alongside the active top 27. Candidates don't produce blocks so their voter APR is 0. Defaults to false. |