获取投票列表
1. 概述与典型用途
查询某个超级代表（SR）的投票者列表，或查询某个账户对所有 SR 的投票列表。通过 candidate 和 voter 参数选择查询维度。
- 典型用途：投票详情页、SR 投票者分析、账户投票记录查看。
- 何时不要用：查询 SR 列表用「超级代表」相关接口；查询账户详细信息用「获取账户详细信息」。
2. 接口与鉴权
GET /api/vote
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
candidate | string | 否 | — | SR 地址——查询某个 SR 的投票者列表时使用 |
voter | string | 否 | — | 投票者地址——查询某个投票者的投票列表时使用 |
start | integer | 否 | 0 | 起始编号（偏移量） |
limit | integer | 否 | 10 | 每页数量 |
sort | string | 否 | — | 排序方式，默认按票数降序 |
count | string | 否 | — | 传入时返回结果的总数 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
code | integer | 必返 | 状态码 | — |
status | string | 必返 | 状态描述（如 "1"） | — |
message | string | 必返 | 请求结果消息（如 "request ok"） | — |
total | integer | 必返 | 投票记录总数 | — |
totalVotes | integer | 必返 | 总票数 | — |
data | array | 必返 | 投票记录数组，见下 | — |
contractMap | object | 必返 | 涉及地址 → 是否为合约的布尔映射（无合约地址时为空对象） | — |
contractInfo | object | 可选 | 合约地址 → 标签信息；查询 SR 候选人列表时出现；value schema 见下 | — |
contractInfo[<addr>] 对象 schema（8 字段）：
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
tag1 | string | 必返 | 主标签（项目名 / 合约名 / 交易所名） |
tag1Url | string | 必返 | 主标签链接 URL（可为空字符串） |
name | string | 必返 | 合约 / 项目正式名称 |
isToken | boolean | 必返 | 是否代币合约（true / false） |
vip | boolean | 必返 | 是否 VIP 实体（true / false） |
risk | boolean | string | 必返 | 风险标签；多数 endpoint 返回 boolean，部分返回字符串风险类型（blacklist / fraud 等） |
publicTagDesc | string | 必返 | 公开标签描述；多数账户为空字符串 |
publicTag | string | 可选 | 公开标签（如 "USDT Token" / "Binance"）；仅知名实体或部分接口返回 |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
timestamp | string | 必返 | 投票时间（ISO 8601 格式，本地时区 UTC+8，如 2026-05-16T17:12:24.000+0800） | — |
voterAddress | string | 必返 | 投票者地址 | — |
voterAddressTag | string | 可选 | 投票者地址标签 | — |
voterPercentage | number | 必返 | 投票者在 SR 总票中的占比 | 小数，如 31.58 表示 31.58% |
candidateAddress | string | 必返 | SR 候选人地址 | — |
votes | integer | 必返 | 投票数 | — |
percentage | number | 必返 | 占全网总投票的比例 | 小数，如 0.843067 表示 0.843067% |
candidateUrl | string | 必返 | SR 网站 | — |
candidateName | string | 必返 | SR 名称 | — |
candidateTotalVotes | integer | 必返 | SR 获得的总票数 | — |
voterAvailableVotes | integer | 必返 | 投票者可用投票数 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 空结果 ≠ 错误：账户未投票时返回
200+data: []与totalVotes: 0，属于正常响应。
最后更新于: