Get Super Representative Homepage Statistics
1. Overview & Typical Use
Returns global statistics for the Super Representative module, including total SR count, new additions in the last 30 days, total network votes, and the SR with the highest/lowest block production efficiency and most/fewest cumulative blocks.
- Typical use: super representative homepage dashboard display, network-wide block production efficiency overview.
- When not to use: for details on a specific SR use “Get Super Representative Current Vote Info” or “Get Super Representative List”.
2. Endpoint & Authentication
GET /api/witness/general-info
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
No parameters required.
4. Response
Fields
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
total | integer | Required | Total number of Super Representatives | — |
increaseOf30Day | integer | Required | New additions in the last 30 days | — |
totalRealtimeVotes | integer | Required | Total real-time votes across the network | — |
highestEfficiency | object | Required | SR with the highest block production efficiency; see below | — |
lowestEfficiency | object | Required | SR with the lowest block production efficiency; see below | — |
maxBlocksCount | object | Required | SR with the most cumulative blocks produced; see below | — |
minBlocksCount | object | Required | SR with the fewest cumulative blocks produced; see below | — |
Node info object fields (highestEfficiency / lowestEfficiency / maxBlocksCount / minBlocksCount)
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
address | string | Required | Super Representative address | — |
name | string | Required | Name | — |
url | string | Required | Official website URL | — |
missedTotal | number | Required | Cumulative missed blocks | — |
producedTotal | number | Required | Cumulative blocks produced | — |
producePercentage | number | Required | Historical block production efficiency | Percentage % |
currentProducePercentage | number | Required | Current block production efficiency | Percentage % |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- No parameters, always returns data: this endpoint requires no parameters and always returns global statistics.
Last updated on: