跳转至

/wallet/getBrokerage

查询 SR 当前周期的分红比例(佣金)。

  • 源码:framework/src/main/java/org/tron/core/services/http/GetBrokerageServlet.java
  • Method:GET / POST
  • 支持固化接口:/walletsolidity/getBrokerage

请求参数

字段 类型 必填 说明
address string SR 地址
visible bool 无效果(servlet 通过 41 前缀自动识别地址格式,响应无 bytes 字段)

示例:

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

响应

字段 类型 说明
brokerage int 百分比(0–100),默认 20

响应示例(Nile,sr-15):

{ "brokerage": 100 }

注意:address 字段缺失或为空时不报错,直接返回 {"brokerage": 0}——与"该 SR 当前佣金为 0"响应完全一致,调用方需自行区分。

异常响应

触发条件 响应
address41 开头但不是合法 hex {"Error": "INVALID address, <hex 解析器信息>"}
address 不是合法 base58check {"Error": "INVALID address, <base58 校验信息>"}
POST 体不是合法 JSON {"Error": "class com.alibaba.fastjson.JSONException : <解析器信息>"}
其他异常 {"Error": "<exceptionClass> : <message>"}