跳转至

/wallet/getaccountresource

查询账户的带宽(Net)+ 能量(Energy)+ TronPower 资源使用情况。

  • 源码:framework/src/main/java/org/tron/core/services/http/GetAccountResourceServlet.java
  • Method:GET / POST

请求参数

字段 类型 必填 说明
address string 账户地址
visible bool 地址格式

示例:

curl --request POST \
     --url https://nile.trongrid.io/wallet/getaccountresource \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "address": "41dd791d6b49e190062d650e6a23c575510d35f2f9"
}
'

响应

返回 api.AccountResourceMessageapi.proto):

字段 类型 说明
freeNetUsed / freeNetLimit int64 免费带宽(每 24h 重置)
NetUsed / NetLimit int64 质押带宽
assetNetUsed / assetNetLimit map TRC10 各自带宽
TotalNetLimit / TotalNetWeight int64 全网带宽配额、全网质押
EnergyUsed / EnergyLimit int64 能量
TotalEnergyLimit / TotalEnergyWeight int64 全网能量配额、全网质押
tronPowerUsed / tronPowerLimit int64 投票权
TotalTronPowerWeight int64 全网投票权总量
storageUsed / storageLimit int64 存储(已不使用)

响应示例:

{
  "freeNetUsed": 441,
  "freeNetLimit": 600,
  "assetNetUsed": [
    { "key": "1005416", "value": 0 }
  ],
  "assetNetLimit": [
    { "key": "1005416", "value": 10000 }
  ],
  "TotalNetLimit": 43200000000,
  "TotalNetWeight": 68305209098,
  "TotalEnergyLimit": 180000000000,
  "TotalEnergyWeight": 2411528185
}

address 缺失或对应账户不存在均返回 {}

异常响应

触发条件 响应
请求体超过 node.maxMessageSize(POST) {"Error": "class java.lang.Exception : body size is too big, the limit is <N>"}
address 不是合法 hex(visible=false {"Error": "class org.bouncycastle.util.encoders.DecoderException : exception decoding Hex string: <详情>"}
address 不是合法 base58check(visible=true {"Error": "class java.lang.IllegalArgumentException : <详情>"}
请求体不是合法 JSON / 字段类型不符(POST) {"Error": "class com.alibaba.fastjson.JSONException : <解析器信息>"}
其他异常 {"Error": "<exceptionClass> : <message>"}