wallet-cli token balance

查询单个 token 的余额。

用法

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

说明

查询当前账户（或 --account 指定的账户）在所选网络上某一个 token 的余额——TRON 上是 TRC20/TRC10，EVM 上是 ERC20。二选一，只能给一个：合约类 token 用 --contract，TRC10 资产用 --asset-id。只读——不需要密码，也不会签名。

选项

选项	说明
--contract <string>	token 合约地址——TRON 上是 TRC20，EVM 上是 ERC20；--contract / --asset-id 二者必选其一
--asset-id <string>	仅限 TRON。 TRC10 数字资产 id；--asset-id / --contract 二者必选其一

--asset-id 是仅限 TRON 的参数：--help 会为它标注 (TRON only)，在 EVM 网络上传入它会在任何节点调用之前就以 invalid_option 失败。

此外还有全局选项。

示例

wallet-cli token balance --contract TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf --network nile

Label    main
Symbol   USDT
Balance  1,204.56

wallet-cli token balance --contract TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf --network nile -o json

{"schema":"wallet-cli.result.v1","success":true,"command":"token.balance","data":{"address":"TMSgJxtPw29AFEHMXsjGo4kWV7UwbCToHJ","token":"TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf","balance":"1204560000","symbol":"USDT","decimals":6},"meta":{"durationMs":15,"warnings":[]},"chain":{"family":"tron","network":"tron:3448148188","chainId":"3448148188"}}

EVM 网络上的 ERC20 余额——字段相同，另加该 token 的 name：

wallet-cli token balance --contract 0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238 --network sepolia -o json

{"schema":"wallet-cli.result.v1","success":true,"command":"token.balance","data":{"address":"0x541B10b92b45C08513e67bb8209f035D810212B6","token":"0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238","balance":"0","symbol":"USDC","decimals":6,"name":"USDC"},"meta":{"durationMs":233,"warnings":[]},"chain":{"family":"evm","network":"eip155:11155111","chainId":"11155111"}}

输出

字段	类型	含义
address	string	被查询的账户，以所选网络的地址格式给出
token	string	合约地址，或 TRC10 资产 id
balance	string	以 token 最小单位计的原始余额（"1204560000" ÷ 10^decimals）
symbol	string	token 符号
decimals	number	token 精度
name	string	token 名称；仅 EVM

退出码

0 成功 · 1 执行失败（rpc_error、timeout） · 2 用法错误（invalid_value——未给出选择器，或两个选择器同时给出；invalid_option——在 EVM 网络上使用了 --asset-id）。

另请参见

token info · account portfolio · tx send

---