获取超级代表列表

1. 概述与典型用途

返回超级代表、合伙人及候选人的列表，包括投票数、出块信息、佣金比例等详细数据。

GET /api/pagewitness

参数	类型	必填	默认	说明
`witnesstype`	integer	否	`0`	返回类型：`0` 所有，`1` 超级代表（前 27 名），`2` 合伙人（28–127 名），`3` 候选人
`start`	integer	否	`0`	起始编号
`limit`	integer	否	`500`	每页数量
`sort`	integer	否	`0`	排序方向：`0` 升序，`1` 降序
`sortField`	string	否	—	排序字段：`votes`、`latestBlock`、`producedTotal`、`missedTotal`、`producePercentage`、`annualizedRate`、`brokerage`、`voterBrokerage`

顶层

字段	类型	是否必返	说明	单位/精度
`total`	integer	必返	超级代表总数	—
`data`	array	必返	超级代表记录数组，见下	—
`lastBlock`	object	必返	最新区块信息，见下	—

lastBlock 对象

字段	类型	是否必返	说明	单位/精度
`hash`	string	必返	区块哈希	—
`confirmed`	boolean	必返	是否已确认	—
`number`	integer	必返	区块高度	—
`size`	integer	必返	区块大小	字节
`timestamp`	integer	必返	区块时间戳	毫秒 ms
`parentHash`	string	必返	父区块哈希	—
`witnessAddress`	string	必返	出块超级代表地址	—
`nrOfTrx`	integer	必返	区块包含交易数	—
`txTrieRoot`	string	必返	交易 Trie 根哈希	—
`witnessId`	integer	必返	出块超级代表 ID（非 SR 时为 `0`）	—

data[] 元素

字段	类型	是否必返	说明	单位/精度
`address`	string	必返	超级代表地址	—
`name`	string	必返	名称	—
`url`	string	必返	官网 URL	—
`producer`	boolean	必返	是否为活跃出块节点	—
`votes`	integer	必返	当前周期投票数	—
`lastCycleVotes`	integer	必返	上一周期投票数	—
`realTimeVotes`	integer	必返	实时投票数	—
`changeVotes`	integer	必返	投票变化量	—
`votesPercentage`	number	必返	投票占比	百分比 %
`brokerage`	number	必返	超级代表佣金比例	百分比 %
`voterBrokerage`	number	必返	投票者分红比例	百分比 %
`annualizedRate`	string	必返	年化收益率	百分比 %
`latestBlockNumber`	integer	必返	最近出块高度	—
`latestSlotNumber`	integer	可选	最新时隙号	—
`producedTotal`	integer	必返	累计出块数	—
`producedTrx`	integer	可选	累计产生的 TRX 数量	—
`missedTotal`	integer	必返	累计漏块数	—
`producePercentage`	number	必返	出块效率	百分比 %
`version`	integer	必返	节点版本号	—
`witnessType`	integer	必返	节点类型：`1` 超级代表，`2` 合伙人，`3` 候选人	—
`ranking`	integer	必返	当前排名	—
`logoUrl`	string	可选	Logo URL	—
`index`	integer	必返	当前页内序号（从 1 起）	—
`totalOutOfTimeTrans`	integer	必返	累计超时交易数	—
`lastWeekOutOfTimeTrans`	integer	必返	上周超时交易数	—
`changedBrokerage`	boolean	必返	是否曾修改过佣金	—
`lowestBrokerage`	integer	必返	历史最低投票者分红比例	百分比 %

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