wallet-cli vote status

August 5, 2026 · View on GitHub

Your current votes, voting power, and reward overview.

Synopsis

wallet-cli vote status [options]

One read-only screen for the stake → vote → reward loop: your current vote distribution (with each SR's APR and reward ratio), your voting power (total / used / available TP), and the currently claimable reward.

Voting power (TP) — total = staked TRX; used = votes placed; available = total − used.
APR / Reward ratio — same semantics and sources as vote list. Worth re-checking: an SR can change its ratio at any time (on-chain UpdateBrokerage) — votes placed at 80% silently stop earning if it drops to 0%.
0% warning — if any votes sit on an SR with a 0% reward ratio, text output appends a ! line and json adds a plain-string entry to meta.warnings, one per affected SR.
Claimable — same source as reward balance; claim with reward withdraw.

Options

No command-specific options; the global options only (--network / --account).

Examples

wallet-cli vote status --account main --network tron:nile

Label           main
Voting power    1,500 TP  (used 1,000 / available 500)
Claimable       12.345678 TRX

Current votes (2)
  Name             Votes  APR   Reward ratio  Address
  TRONSCAN           600  4.8%  80%           TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g
  Binance Staking    400  0%    0%            TT5W8MPbYJih9R586kTszb4LoybzUvCYm2
! 400 votes are on an SR with 0% reward ratio — they earn you nothing

wallet-cli vote status --account main --network tron:nile -o json

{"schema":"wallet-cli.result.v1","success":true,"command":"vote.status","data":{"address":"TQk...","votingPower":{"total":1500,"used":1000,"available":500},"claimableRewardSun":"12345678","votes":[{"witness":"TZ4...","name":"TRONSCAN","count":600,"rewardRatioPct":80,"brokeragePct":20,"aprPct":4.8},{"witness":"TT5...","name":"Binance Staking","count":400,"rewardRatioPct":0,"brokeragePct":100,"aprPct":0}]},"meta":{"durationMs":16,"warnings":["400 votes on TT5... (Binance Staking) earn nothing: reward ratio is 0%"]},"chain":{"family":"tron","network":"tron:nile","chainId":"nile"}}

Output

Field	Type	Meaning
`address`	string	Queried account
`votingPower.total` / `.used` / `.available`	number	TP total / spent / spendable
`claimableRewardSun`	string	Currently claimable reward, in SUN
`votes[]`	array	Current distribution: `witness`, `name`, `count`, `rewardRatioPct`, `brokeragePct`, `aprPct`

Zero-reward-ratio warnings appear in meta.warnings as plain strings — see reading meta.warnings.

Exit status

0 success · 1 execution failure (rpc_error) · 2 usage error (invalid_value).