获取超级代表当前投票信息

1. 概述与典型用途

返回指定超级代表的当前投票详情，包括实时排名、投票数变化、佣金比例、年化收益率及投票趋势图数据。不传 address 参数时返回全局投票概览。

GET /api/vote/witness

参数	类型	必填	默认	说明
`address`	string	否	—	超级代表地址；不传时返回全局投票概览

顶层

字段	类型	是否必返	说明	单位/精度
`status`	string	必返	请求状态码字符串，正常为 `"1"`	—
`code`	integer	必返	HTTP 状态码，正常为 `200`	—
`message`	string	必返	请求结果描述，正常为 `"request ok"`	—
`success`	string	必返	请求是否成功，值为 `"true"`	—
`data`	object \| array	可选	超级代表详情；传 `address` 时为单一对象；不传 `address` 时为数组（投票记录列表），见下	—
`totalWitness`	integer	必返	超级代表总数	—
`total`	integer	可选	超级代表总数（不传 `address` 时）	—
`totalVotes`	integer	可选	全网总投票数（不传 `address` 时）	—
`fastestRise`	object	可选	投票数增长最快的超级代表（不传 `address` 时）	—
`maxVotesRise`	object	可选	票数增幅最大的超级代表（不传 `address` 时）	—
`changedBrokerage`	boolean	必返	是否修改过佣金	—
`lowestBrokerage`	integer	必返	最低投票者分红比例	百分比 %
`brokerageChangeNum`	integer	必返	佣金修改次数	—
`brokerageHistory`	array	可选	佣金修改历史（传 `address` 时），见下	—

brokerageHistory[] 元素

字段	类型	是否必返	说明	单位/精度
`from`	integer	必返	修改前的投票者分红比例	百分比 %
`to`	integer	必返	修改后的投票者分红比例	百分比 %
`time`	integer	必返	修改时间戳	秒时间戳
`hash`	string	必返	修改交易哈希	—

data 对象字段

字段	类型	是否必返	说明	单位/精度
`address`	string	必返	超级代表地址	—
`name`	string	必返	名称	—
`url`	string	必返	官网 URL	—
`hasPage`	boolean	可选	是否有详情页	—
`logoUrl`	string	可选	Logo URL	—
`lastRanking`	integer	必返	上一周期排名	—
`realTimeRanking`	integer	必返	实时排名	—
`lastCycleVotes`	integer	必返	上一周期投票数	—
`realTimeVotes`	integer	必返	实时投票数	—
`changeVotes`	integer	必返	投票变化量	—
`change_cycle`	integer	可选	周期内票数变化	—
`votesPercentage`	number	必返	投票占比	百分比 %
`lastCycleVotesPercentage`	number	必返	上一周期投票占比	百分比 %
`brokerage`	number	必返	超级代表佣金比例	百分比 %
`voterBrokerage`	number	必返	投票者分红比例	百分比 %
`annualizedRate`	string	必返	年化收益率	百分比 %
`producedTotal`	integer	必返	累计出块数	—
`producedEfficiency`	number	必返	出块效率	百分比 %
`blockReward`	integer	必返	出块奖励	—
`version`	integer	可选	节点版本号	—
`totalOutOfTimeTrans`	integer	可选	累计超时交易数	—
`lastWeekOutOfTimeTrans`	integer	可选	上周超时交易数	—
`changedBrokerage`	boolean	可选	是否修改过佣金（`data` 对象内）	—
`lowestBrokerage`	integer	可选	最低佣金比例（`data` 对象内）	—
`witnessType`	integer	必返	节点类型：`1` 超级代表，`2` 合伙人，`3` 候选人	—
`realtimeVoteLine`	array	可选	实时投票趋势数据（含 `time`/`vote`，传 `address` 时）	—

HTTP 状态码见公共错误说明。本接口要点：