listwitnesses - Tron

listwitnesses. Returns the full list of Super Representatives and candidates with their vote counts.

listwitnesses - tron [Value: 20CU]
Returns the full list of Super Representatives and candidates with their vote counts.
Use cases

Use cases

  • Also available as GET
  • Build a Super Representative leaderboard ranked by vote count
  • Check whether a witness is currently in the active (top 27) set via isJobs
Constraints

Constraints

  • Vote counts reflect the last completed maintenance (vote-counting) cycle, not real-time
  • Also available under /walletsolidity/ for confirmed (solidified) data instead of the latest state
Get started
Unlock Access to 100+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
curl --request POST \
     --url https://lb.drpc.live/tron/{API-KEY}/wallet/listwitnesses \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{}'
Copy
Response
200
{
  "witnesses": [
    {
      "address": "419c7c7049d26108be0dcb5f78479c6ff27ba101d1",
      "voteCount": 2320142029,
      "url": "http://sr-15.com",
      "totalProduced": 1897834,
      "totalMissed": 252,
      "latestBlockNum": 66987961,
      "latestSlotNum": 592482103,
      "isJobs": true
    }
    /* ... other candidates */
  ]
}
Copy

Request params

idinteger
jsonrpcstring
methodstring
Parametersobject
object
visibleboolean
Set to true to format addresses in Base58; set to false for hex format. (Default: false)

Response

200
Returns the full list of Super Representatives and candidates with their vote counts.

Response params

object
witnessesarray_of_objects
The list of witness (Super Representative and SR candidate) records on the network.
object
addressstring
The address of this witness, in hex format.
voteCountinteger
The total number of TRON Power votes currently cast for this witness.
urlstring
The witness's public URL, in plain UTF-8 text.
totalProducedinteger
The cumulative number of blocks this witness has successfully produced.
totalMissedinteger
The cumulative number of block-production slots this witness has missed.
latestBlockNuminteger
The height of the most recent block produced by this witness.
latestSlotNuminteger
The most recent DPoS time slot in which this witness was scheduled to produce a block.
isJobsboolean
Whether this witness currently holds an active Super Representative seat (as opposed to being a candidate only).
Vote Witness AccountGet Paginated Now Witness List