wallet-cli stake delegated¶

Delegation details and max delegatable size.

Synopsis¶

wallet-cli stake delegated [--direction out|in] [--resource energy|bandwidth]
                           [--to <address>] [options]

Description¶

Read-only listing of resource delegations, in either direction: out (default — what you delegated to others, plus Max delegatable, how much you can still delegate) or in (what others delegated to you; no max — that concept only exists outbound). --to narrows to one counterparty (out only).

The lock column flips meaning with the viewpoint. Both directions read the same on-chain expiry field, but:

out → Locked until: a lock you set — you cannot reclaim before it expires (not locked when reclaimable anytime);
in → Guaranteed until: the delegator cannot reclaim before then — your guaranteed floor (none — reclaimable anytime warns the resource can vanish whenever the delegator wants it back).

json keeps the raw lockedUntil timestamp in both directions — no viewpoint translation at the machine layer.

Options¶

Option	Description
`--direction <out\\|in>`	`out` = delegated to others (default); `in` = delegated to me
`--resource <energy\\|bandwidth>`	Filter to a single resource type (default both)
`--to <string>`	Only the delegation to this receiver (out only)

Plus the global options.

Examples¶

Outbound (default) — includes Max delegatable:

wallet-cli stake delegated --direction out --account main --network tron:3448148188

Label      demo
Direction  out (delegated to others)

Max delegatable
  Energy     900 TRX
  Bandwidth  300 TRX

Delegations (2)
  Receiver                            Resource   Amount   Locked until
  TBy6mQ7Y3nJ8sD2fWpXk4LhVc9Ra1Zt5Ub  energy     500 TRX  2026-07-08 08:00 (in ~3 day(s))
  TXe4Kd8nP2rF9gH5jL3mV6cW1bN7yS0aQz  bandwidth  100 TRX  not locked

Max delegatable is the staked TRX still free to delegate, not a resource-unit figure — canDelegateMaxSun in JSON, rendered as TRX.

wallet-cli stake delegated --direction out --account main --network tron:3448148188 -o json

{"schema":"wallet-cli.result.v1","success":true,"command":"stake.delegated","data":{"address":"TQk...","direction":"out","canDelegateMaxSun":{"energy":"900000000","bandwidth":"300000000"},"delegations":[{"receiver":"TBy6...","resource":"energy","amountSun":"500000000","lockedUntil":1783468800000},{"receiver":"TXe4...","resource":"bandwidth","amountSun":"100000000","lockedUntil":null}]},"meta":{"durationMs":28,"warnings":[]},"chain":{"family":"tron","network":"tron:3448148188","chainId":"3448148188"}}

Inbound (--direction in) — the lock column becomes Guaranteed until, no Max delegatable:

wallet-cli stake delegated --direction in --account main --network tron:3448148188

Label      demo
Direction  in (delegated to me)

Delegations (1)
  From                                Resource  Amount   Guaranteed until
  TBy6mQ7Y3nJ8sD2fWpXk4LhVc9Ra1Zt5Ub  energy    500 TRX  2026-07-08 08:00 (in ~3 day(s))

Output¶

Field	Type	Meaning
`address`	string	Queried account
`direction`	string	`out` / `in`
`canDelegateMaxSun`	object	`{energy, bandwidth}` SUN strings — the staked TRX still free to delegate, per direction (out only)
`delegations[]`	array	Each: `receiver` (out) or `from` (in), `resource`, `amountSun` (string), `lockedUntil` (epoch ms or `null`)

Exit status¶

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