获取账户投票列表
1. 概述与典型用途
返回指定账户的投票列表,展示该账户投票给各超级代表的票数。
- 典型用途:查看用户投票分布、投票管理面板。
- 何时不要用:查询超级代表的投票汇总信息用「获取超级代表当前投票信息」;查询超级代表列表用「获取超级代表列表」。
address为必填参数;未投票账户返回votes: {}正常响应。
2. 接口与鉴权
GET /api/account/votes
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 账户地址(Base58,T 开头) |
4. 响应
字段
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
votes | object | 必返 | 投票映射:key 为超级代表地址,value 为投票数量 |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
address必填:缺少时返回参数缺失错误。- 未投票 ≠ 错误:账户未投票时返回
200+votes: {},属于正常响应。
最后更新于: