Skip to main content
POST
/
95e61622bf6a8af293978377718e3b77
/
wallet
/
listwitnesses
wallet/listwitnesses
curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/listwitnesses \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "witnesses": [
    {
      "address": "<string>",
      "voteCount": 123,
      "pubKey": "<string>",
      "url": "<string>",
      "totalProduced": 123,
      "totalMissed": 123,
      "latestBlockNum": 123,
      "latestSlotNum": 123,
      "isJobs": true
    }
  ]
}
TRON API method that retrieves a complete list of all witnesses (validators) on the TRON network. Witnesses are responsible for block production and network governance in TRON’s Delegated Proof of Stake (DPoS) consensus mechanism.
Get you own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

This method accepts no parameters.

​
Response

  • witnesses — array containing information about all witnesses:
    • address — witness address in hexadecimal format
    • voteCount — total number of votes received from TRX holders
    • pubKey — public key used for block signing and validation
    • url — witness website or information URL
    • totalProduced — total number of blocks successfully produced
    • totalMissed — total number of blocks missed during assigned slots
    • latestBlockNum — block number of the most recent block produced
    • latestSlotNum — most recent time slot assigned for block production
    • isJobs — boolean indicating whether the witness is currently active in block production

​
Use case

The wallet/listwitnesses method is used for:
  • Displaying all available witnesses for voting and governance participation.
  • Building voting interfaces and governance dashboards.
  • Analyzing witness performance metrics including blocks produced and missed.
  • Monitoring network health by tracking active witnesses and their statistics.
  • Creating witness ranking and comparison tools based on votes and performance.
  • Implementing governance features that require witness selection and information.

Body

application/json

The body is of type object.

Response

200 - application/json

List of all witnesses on the network

​
witnesses
object[]

Array of witness information