wallet-cli token remove

Remove a user-added token from the address book.

Synopsis

wallet-cli token remove (--contract <address> | --asset-id <id>) [options]

Description

Removes a token you added from the user layer of the address book (same network + account scope as token add). Official-layer tokens cannot be removed — trying returns token_is_official.

Purely local — the token and your balance on-chain are unaffected; only the local symbol mapping goes away.

Options

Option	Description
--contract <string>	Token contract address to remove — TRC20 on TRON, ERC20 on EVM
--asset-id <string>	TRON only. TRC10 numeric asset id to remove; exactly one of --asset-id / --contract

Plus the global options.

Examples

wallet-cli token remove --contract TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf --network tron:3448148188

✅ Removed from token book
  Name    Tether USD
  Symbol  USDT

wallet-cli token remove --contract TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf --network tron:3448148188 -o json

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

Output

Field	Type	Meaning
network	string	Network the entry was scoped to
account	string	Account the entry was scoped to
removed	object	The deleted token entry (kind — trc20/trc10/erc20 — plus id, symbol, decimals, name)

Exit status

0 removed · 1 execution failure (encoding_error / io_error — the local token book could not be decoded or written) · 2 usage error (token_is_official — official-layer tokens can't be removed; token_not_in_book — not in the user layer; invalid_value; invalid_option — --asset-id on an EVM network).

See also

token add · token list

---