跳转至

wallet-cli asset info

完整显示一个 TRC10。

用法

wallet-cli asset info (<asset> | --issuer <address>) [options]

说明

报告一个 token 的发行记录:发行方、总供应量、精度、ICO 比率与窗口、冻结批次、描述、URL,以及两项免费带宽限额。只读,不需要账户。

可以通过三种方式查询:按 id(全数字参数)、按名称,或按 --issuer 地址。<asset>--issuer 必须且只能提供其一;两者均未提供或同时提供时会返回 invalid_value。由于每个账户只能发行一个 TRC10,按发行方查询最多返回一个结果。

链上不保证名称唯一。如果名称匹配到多个 token,命令不会直接返回列表,而是以退出码 1 和错误码 ambiguous_asset_name 失败,同时打印候选项,便于改用 id 重新查询。参见下面的示例

空的小节会被整体省略:没有冻结批次的 token 完全不会显示 Frozen 块。

这里的时间戳精确到秒(2026-08-01 00:00:00 UTC),而不是 CLI 中其他地方那样精确到分。

它是 token info 在 TRC10 上的专用对应命令;后者报告与 TRC20 共有的通用元数据(名称、符号、精度),且只能用 --asset-id 选择 TRC10。

输出不包含“已售数量”“剩余供应量”或持有人数,因为节点无法可靠计算这些数据:仅凭链上结果无法区分发行方的普通转账和 ICO 销售。要查看发行方当前持有量,请使用 account balance 查询其余额。

选项

选项 说明
<asset> token id 或名称;全数字的值按 id 解析。<asset> / --issuer 二选一
--issuer <address> 由该地址发行的 token。<asset> / --issuer 二选一

此外还有全局选项

示例

按 id 查询:

wallet-cli asset info 1000123 --network tron:3448148188
Asset MyToken (id 1000123)
  Issuer            TQkXm4vN...5Zt7Uw
  Total supply      1,000,000,000
  Precision         6
  Price             1 TRX = 100 MyToken
  ICO start time    2026-08-01 00:00:00 UTC
  ICO end time      2026-08-31 00:00:00 UTC
  Url               https://mytoken.io
  Description       Demo TRC10
  Free net/account  0
  Public free net   0
  Frozen (2)
    100,000,000  until 2026-08-31 00:00:00 UTC
    50,000,000   until 2026-10-30 00:00:00 UTC

名称不唯一的情况

wallet-cli asset info MyToken --network tron:3448148188

命令以退出码 1 失败;消息和候选表输出到 stderr

error [ambiguous_asset_name]: 2 TRC10 tokens are named MyToken; re-run with the id
| ID      | Issuer                             | Total supply  | Precision |
| ------- | ---------------------------------- | ------------- | --------- |
| 1000123 | TQkXm4vN2f8LrQ5tYc7bWmXe3sVd9Zt7Uw | 1,000,000,000 | 6         |
| 1000488 | TZx9kP2mR4nJ6vLc8dHqYe1tWbXs5f7bWq | 50,000,000    | 2         |

在 json 中,同样的信息位于 error.details——参见输出

按发行方查询——这里是别人的 token,且没有冻结批次:

wallet-cli asset info --issuer TZx9kP2m...7bWq --network tron:3448148188
Asset MyToken (id 1000488)
  Issuer            TZx9kP2m...7bWq
  Total supply      50,000,000
  Precision         2
  Price             1 TRX = 5 MyToken
  ICO start time    2026-07-15 00:00:00 UTC
  ICO end time      2026-09-15 00:00:00 UTC
  Url               https://beta.example
  Description       Another TRC10
  Free net/account  0
  Public free net   0
wallet-cli asset info 1000123 --network tron:3448148188 -o json
{"schema":"wallet-cli.result.v1","success":true,"command":"asset.info","data":{"kind":"asset-info","assetId":"1000123","name":"MyToken","abbr":"MTK","issuerAddress":"TQkXm4vN...","totalSupply":"1000000000000000","precision":6,"price":"1:100","trxNum":1,"num":100,"startTime":1785542400000,"endTime":1788134400000,"url":"https://mytoken.io","description":"Demo TRC10","freeAssetNetLimit":0,"publicFreeAssetNetLimit":0,"frozenSupply":[{"amount":"100000000000000","days":30,"expireTime":1788134400000},{"amount":"50000000000000","days":90,"expireTime":1793318400000}]},"meta":{"durationMs":26,"warnings":[]},"chain":{"family":"tron","network":"tron:3448148188","chainId":"3448148188"}}

名称歧义失败在 json 中的形式:

wallet-cli asset info MyToken --network tron:3448148188 -o json
{"schema":"wallet-cli.result.v1","success":false,"command":"asset.info","error":{"code":"ambiguous_asset_name","message":"2 TRC10 tokens are named MyToken; re-run with the id","details":{"name":"MyToken","assetIds":["1000123","1000488"],"matches":[{"assetId":"1000123","issuerAddress":"TQkXm4vN...","totalSupply":"1000000000000000","precision":6},{"assetId":"1000488","issuerAddress":"TZx9kP2m...","totalSupply":"5000000000","precision":2}]}},"meta":{"durationMs":29,"warnings":[]},"chain":{"family":"tron","network":"tron:3448148188","chainId":"3448148188"}}

输出

data.kind is asset-info.

字段 类型 含义
assetId string Token id
name / abbr string 发行时的名称和缩写。abbr 仅在 json 中——text 没有对应行
issuerAddress string 发行方,base58
totalSupply string 总供应量,原始值(完整 token × 10^precision)。是字符串:供应量会达到 int64,作为 JSON number 会损失精度
precision number 小数位数,0–6
price string 发行比率,形如 trx:tokens,以完整单位计——text 渲染为 1 TRX = 100 MyToken
trxNum / num number 与链上存储完全一致的比率,以 sun 和最小单位表示,并在发行时约分为最简形式。当 precision 为 6 时,1:100 存储为 trxNum=1 / num=100
startTime / endTime number ICO 窗口,epoch 以来的毫秒数
url / description string 项目页面和描述
freeAssetNetLimit / publicFreeAssetNetLimit number 每位持有人的免费带宽,以及共享池
frozenSupply[] array amount(原始值,字符串)、daysexpireTime(epoch 以来的毫秒数)。没有时为空数组

不存在 remainingSupply 字段。

匹配到多个 token 的名称会失败,而不是返回数据。此时 error.details 携带 nameassetIds[](可用于重跑的 id)以及 matches[]——每个候选一行扁平记录,含 assetIdissuerAddresstotalSupply(原始值,字符串)和 precision。text 模式把 matches[] 渲染成上面所示的表格,并按各自的 precision 缩放 totalSupply

退出码

0 成功 · 1 执行失败(asset_not_found——没有这个 token;ambiguous_asset_name——名称匹配到多个 token;rpc_error) · 2 用法错误(invalid_value——<asset>--issuer 都没给或都给了;或 --issuer 不是有效的 base58 TRON 地址)。

另请参见

asset list · token info · asset participate