# Tron Super Representatives & Voting API
> Tron's delegated-proof-of-stake governance — the Super Representative (SR) election — live from the public TronScan API, no key, nothing cached. Tron is run by 27 elected Super Representatives who produce the blocks, chosen by TRX holders who freeze TRX into votes; below them sit roughly 100 SR partners and candidates waiting to rotate in. The base Tron reader covers accounts and transactions, but not the SR election; this opens it. Rank the SRs and candidates by votes, each with its block production, missed blocks, produce rate and latest block. Look up a single SR by address for its votes, rank and production. And read a live election overview — the active 27, the candidate pool, the total frozen-TRX votes cast across all witnesses and the all-time blocks produced. The validator-and-voting layer for Tron wallets, staking dashboards, voters and analytics. Live from apilist.tronscanapi.com.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/tronsr-api/..."
```

## Pricing
- **Free** (Free) — 7,050 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 137,000 calls/Mo, 9 req/s
- **Pro** ($35/Mo) — 818,000 calls/Mo, 22 req/s
- **Business** ($94/Mo) — 4,950,000 calls/Mo, 55 req/s

## Endpoints

### Witnesses

#### `GET /v1/witness` — One SR by address: votes, rank, production, miss rate

**Parameters:**
- `address` (query, optional, string) — Tron SR address (omit for the top SR) Example: `TJvaAeFb8Lykt9RQcVyyTFN2iDvGMuyD4M`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/tronsr-api/v1/witness?address=TJvaAeFb8Lykt9RQcVyyTFN2iDvGMuyD4M"
```

**Response:**
```json
{
    "data": {
        "url": "https://poloniex.com/",
        "name": "Poloniex",
        "note": "A single Tron Super Representative / candidate: its votes (and share of all votes), rank, block production, miss rate and latest block. Omit address for the top SR.",
        "rank": 1,
        "votes": 5109622831,
        "source": "TronScan",
        "address": "TJvaAeFb8Lykt9RQcVyyTFN2iDvGMuyD4M",
        "vote_pct": 11.5076,
        "is_active_sr": true,
        "latest_block": 83584926,
        "missed_total": 369,
        "produced_total": 2458951,
        "produce_rate_pct": 99.985
    },
    "meta": {
        "timestamp": "2026-06-14T08:03:43.798Z",
        "request_id": "d71a58d7-bca0-4ec7-ba79-2698a5115642"
    },
    "status": "ok",
    "message": "Witness retrieved successfully",
    "success": true
}
```

#### `GET /v1/witnesses` — Super Representatives / candidates ranked by votes

**Parameters:**
- `type` (query, optional, string) — active (27 SRs) / candidate / all Example: `active`
- `limit` (query, optional, string) — Max results (1-200) Example: `27`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/tronsr-api/v1/witnesses?type=active&limit=27"
```

**Response:**
```json
{
    "data": {
        "note": "Tron Super Representatives ranked by votes. type=active is the 27 block-producing SRs, candidate is the SR partner/candidate pool, all is everyone. votes are frozen-TRX votes; produce_rate_pct is blocks produced vs scheduled.",
        "type": "active",
        "count": 27,
        "source": "TronScan",
        "witnesses": [
            {
                "url": "https://poloniex.com/",
                "name": "Poloniex",
                "votes": 5109622831,
                "address": "TJvaAeFb8Lykt9RQcVyyTFN2iDvGMuyD4M",
                "vote_pct": 11.7858,
                "is_active_sr": true,
                "latest_block": 83584926,
                "missed_total": 369,
                "produced_total": 2458951,
                "produce_rate_pct": 99.985
            },
            {
                "url": "http://tronalliance.org",
                "name": "TRONALLIANCE",
                "votes": 3222216820,
                "address": "TTW663tQYJTTCtHh6DWKAfexRhPMf2DxQ1",
                "vote_pct": 7.4323,
                "is_active_sr": true,
                "latest_block": 83584927,
                "missed_total": 1482,
                "produced_total": 2844982,
                "produce_rate_pct": 99.948
            },
            {
                "url": "https://valkyrieinvest.com",
                "name": "Abra Capital Management",
                "votes": 2926854852,
                "address": "TAQpCTFeJvwdWf6MQZtXXkzWrTS9aymshb",
   
…(truncated, see openapi.json for full schema)
```

### Stats

#### `GET /v1/stats` — Live election overview: active 27, candidates, total votes, total blocks

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/tronsr-api/v1/stats"
```

**Response:**
```json
{
    "data": {
        "note": "Live Tron SR election overview: the active 27 block-producers, the candidate pool, the total frozen-TRX votes cast across all witnesses and the all-time blocks produced.",
        "source": "TronScan",
        "top_sr": {
            "name": "Poloniex",
            "votes": 5109622831,
            "address": "TJvaAeFb8Lykt9RQcVyyTFN2iDvGMuyD4M",
            "vote_pct": 11.5076
        },
        "total_votes": 44402327796,
        "active_sr_count": 27,
        "candidate_count": 100,
        "total_witnesses": 438,
        "total_blocks_produced": 83584946
    },
    "meta": {
        "timestamp": "2026-06-14T08:03:43.922Z",
        "request_id": "3354d622-91db-4936-8d28-efac23d5a5a7"
    },
    "status": "ok",
    "message": "Stats retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/tronsr-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "sample": {
            "top_sr": "Poloniex",
            "active_srs": 27,
            "total_votes": 44402327796
        },
        "source": "public TronScan API (apilist.tronscanapi.com), keyless",
        "service": "tronsr-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/stats": "Live election overview: active 27, candidates, total votes, total blocks.",
            "GET /v1/witness": "One SR by address: votes, rank, production, miss rate (address; omit for top).",
            "GET /v1/witnesses": "SRs/candidates ranked by votes (type=active/candidate/all, limit)."
        },
        "description": "Read Tron's delegated-proof-of-stake governance live from the public TronScan API: rank the Super Representatives and candidates by votes with their block production, miss rate and reward sharing; look up a single SR by address; and read a live election overview (active 27, candidate pool, total votes, total blocks). The validator-and-voting layer for Tron wallets, staking dashboards and voters. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-14T08:03:44.006Z",
        "request_id": "896ef11b-7f2d-49fb-ab76-f4226a4514b9"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/tronsr-api
OpenAPI spec: https://www.oanor.com/api/tronsr-api/openapi.json