wallet-cli token list

July 16, 2026 · View on GitHub

List the token address book (official + user).

Synopsis

wallet-cli token list [options]

Lists every token visible to the active account (or --account) on the selected network: the bundled official layer plus your user additions. The source column tells them apart. These are the symbols tx send --token <symbol> resolves against. Read-only, local + metadata only — no password.

Options

No command-specific options; the global options only (--network / --account set the book's scope).

Examples

wallet-cli token list --network tron:nile

| Symbol | Name       | Source | Contract / ID                      |
| ------ | ---------- | ------ | ---------------------------------- |
| USDT   | Tether USD | user   | TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf |

The official layer is only bundled on mainnet (e.g. USDT, USDC); testnets have no official layer, so everything listed is a user entry you added with token add.

wallet-cli token list --network tron:nile -o json

{"schema":"wallet-cli.result.v1","success":true,"command":"token.list","data":{"network":"tron:nile","account":"wlt_b2.0","tokens":[{"kind":"trc20","id":"TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf","symbol":"USDT","decimals":6,"name":"Tether USD","source":"user"}]},"meta":{"durationMs":13,"warnings":[]},"chain":{"family":"tron","network":"tron:nile","chainId":"nile"}}

Output

data: network, account, and tokens[] — one entry per token:

Field	Type	Meaning
`kind`	string	`trc20` / `trc10`
`id`	string	Contract address or asset id
`symbol`	string	Token symbol (used by `tx send --token`)
`decimals`	number	Token decimals
`name`	string	Token name
`source`	string	`official` (bundled) / `user` (added by you)

Exit status

0 success · 1 execution failure · 2 usage error.