获取超级代表主页统计信息
1. 概述与典型用途
返回超级代表模块的全局统计数据,包括超级代表总数、30 天新增、全网投票总数,以及最高/最低出块效率和最多/最少出块数的超级代表信息。
- 典型用途:超级代表主页面板展示、全网出块效率概览。
- 何时不要用:查询具体超级代表详情用「获取超级代表当前投票信息」或「获取超级代表列表」。
2. 接口与鉴权
GET /api/witness/general-info
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
无需任何参数。
4. 响应
字段
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 超级代表总数 | — |
increaseOf30Day | integer | 必返 | 近 30 天新增数量 | — |
totalRealtimeVotes | integer | 必返 | 全网实时投票总数 | — |
highestEfficiency | object | 必返 | 出块效率最高的超级代表,见下 | — |
lowestEfficiency | object | 必返 | 出块效率最低的超级代表,见下 | — |
maxBlocksCount | object | 必返 | 累计出块数最多的超级代表,见下 | — |
minBlocksCount | object | 必返 | 累计出块数最少的超级代表,见下 | — |
节点信息对象字段(highestEfficiency / lowestEfficiency / maxBlocksCount / minBlocksCount)
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
address | string | 必返 | 超级代表地址 | — |
name | string | 必返 | 名称 | — |
url | string | 必返 | 官网 URL | — |
missedTotal | number | 必返 | 累计漏块数 | — |
producedTotal | number | 必返 | 累计出块数 | — |
producePercentage | number | 必返 | 历史出块效率 | 百分比 % |
currentProducePercentage | number | 必返 | 当前出块效率 | 百分比 % |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
- 无参数,始终返回数据:接口无需任何参数,始终返回全局统计信息。
最后更新于: