wallet-cli reward balance¶

Show claimable reward and withdraw status.

Synopsis¶

wallet-cli reward balance [options]

Description¶

Shows the currently claimable voting/block reward and whether it can be withdrawn now. Read-only — the "check before you claim" companion to reward withdraw, so you never have to probe the 24-hour limit by triggering its withdraw_too_frequent error.

Withdraw status derives from the account's on-chain latest_withdraw_time + 24 h: past it (or never withdrawn) → available now; otherwise available from <absolute time> (in ~<relative>).

Options¶

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

Examples¶

Claimable right now:

wallet-cli reward balance --account main --network tron:3448148188

Label            main
Claimable        123.456789 TRX
Withdraw status  available now

Within 24 h of the last withdrawal:

wallet-cli reward balance --account main --network tron:3448148188

Label            main
Claimable        5.678901 TRX
Withdraw status  available from 2026-07-06 09:30 (in ~18h)

wallet-cli reward balance --account main --network tron:3448148188 -o json

{"schema":"wallet-cli.result.v1","success":true,"command":"reward.balance","data":{"address":"TQk...","rewardSun":"123456789","withdrawableNow":true,"withdrawableAt":null},"meta":{"durationMs":14,"warnings":[]},"chain":{"family":"tron","network":"tron:3448148188","chainId":"3448148188"}}

Output¶

Field	Type	Meaning
`address`	string	Queried account
`rewardSun`	string	Claimable reward, in SUN
`withdrawableNow`	boolean	Whether it can be withdrawn now
`withdrawableAt`	number \| null	When it becomes withdrawable (epoch ms); `null` when already withdrawable

Exit status¶

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