wallet-cli account history¶

Show transaction history (requires TronGrid).

Synopsis¶

wallet-cli account history [--limit <n>] [--only <native|token>] [options]

Description¶

TRON only. There is no EVM binding for this listing, so on an EVM network the command fails with family_mismatch rather than returning an empty list.

Lists recent activity touching the account, newest first. History is served by TronGrid, not plain node RPC — on networks/endpoints without TronGrid this command fails while balance/info still work.

--only token selects TronGrid's TRC20 transfer endpoint. --only native selects the general transactions endpoint and does not post-filter its records, so it can include non-native contract activity; omitting --only queries that same endpoint. Do not read only: "native" in the JSON as proof that every record is a TRX transfer.

Options¶

Option	Description
`--limit <number>`	Max records, 1–200 (default 20)
`--only token`	Query TRC20 transfer history
`--only native`	Select the general transaction endpoint; not a strict native-transfer filter

Plus the global options.

Examples¶

wallet-cli account history --limit 3 --network nile

"main" recent transactions
| Time        | Type     | Amount | From / To                          | Status |
| ----------- | -------- | ------ | ---------------------------------- | ------ |
| 07-11 22:35 | Transfer | 1 TRX  | TGkbaCYB4kRBc3Q6wjqkACefUvRwf2KzkH | ✅      |
| 07-11 15:58 | Transfer | 1 TRX  | TGkbaCYB4kRBc3Q6wjqkACefUvRwf2KzkH | ✅      |
| 07-11 15:58 | Transfer | 1 TRX  | TGkbaCYB4kRBc3Q6wjqkACefUvRwf2KzkH | ✅      |

wallet-cli account history --limit 2 --network nile -o json

{"schema":"wallet-cli.result.v1","success":true,"command":"account.history","data":{"address":"TMSgJxtPw29AFEHMXsjGo4kWV7UwbCToHJ","only":"all","count":2,"records":[{"txId":"fb7f8e6b44cd9100f6d1133acea341a2f3d53ab140a93c95b8f2bd74d3a2b366","time":1783780503000,"type":"Transfer","amount":"1","symbol":"TRX","from":"TMSgJxtPw29AFEHMXsjGo4kWV7UwbCToHJ","to":"TGkbaCYB4kRBc3Q6wjqkACefUvRwf2KzkH","counterparty":"TGkbaCYB4kRBc3Q6wjqkACefUvRwf2KzkH","status":"ok"},{"txId":"aa9c6d96b582201bda4ca1f7f35eff597371f5ca8e99db0df78d02d78f668a31","time":1783779301000,"type":"Transfer","amount":"2","symbol":"TRX","from":"TGkbaCYB4kRBc3Q6wjqkACefUvRwf2KzkH","to":"TMSgJxtPw29AFEHMXsjGo4kWV7UwbCToHJ","counterparty":"TGkbaCYB4kRBc3Q6wjqkACefUvRwf2KzkH","status":"ok"}]},"meta":{"durationMs":1556,"warnings":[]},"chain":{"family":"tron","network":"tron:3448148188","chainId":"3448148188"}}

Output¶

Field	Type	Meaning
`address` / `only` / `count`	—	Query echo and record count
`records[].txId`	string	Feed to `tx info` for detail
`records[].time`	number	Epoch ms
`records[].type`	string	Transaction type (e.g. `Transfer`, `CreateSmart`)
`records[].amount`	string	Transfer amount; empty when not a value transfer
`records[].symbol`	string	Asset symbol (e.g. `TRX`)
`records[].from` / `to` / `counterparty`	string	Addresses (may be empty per type)
`records[].status`	string	`ok` or failure marker

Exit status¶

0 · 1 execution failure (history_not_supported — a missing or incompatible TronGrid endpoint) · 2 usage error (limit out of 1–200; family_mismatch on an EVM network).