> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# wallet/listwitnesses | TRON

> TRON API method that retrieves a complete list of all witnesses (validators) on the TRON network. Available on TRON via Chainstack.

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.

## 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.


## OpenAPI

````yaml openapi/tron_node_api/listwitnesses.json post /95e61622bf6a8af293978377718e3b77/wallet/listwitnesses
openapi: 3.0.0
info:
  title: wallet/listwitnesses TRON API
  version: 1.0.0
  description: Get a list of all witnesses (validators) on the TRON network
servers:
  - url: https://tron-mainnet.core.chainstack.com
security: []
paths:
  /95e61622bf6a8af293978377718e3b77/wallet/listwitnesses:
    post:
      tags:
        - Witness and Governance
      summary: wallet/listwitnesses
      operationId: listWitnesses
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: List of all witnesses on the network
          content:
            application/json:
              schema:
                type: object
                properties:
                  witnesses:
                    type: array
                    description: Array of witness information
                    items:
                      type: object
                      properties:
                        address:
                          type: string
                          description: Witness address in hex format
                        voteCount:
                          type: number
                          description: Total votes received by this witness
                        pubKey:
                          type: string
                          description: Public key of the witness
                        url:
                          type: string
                          description: Witness website URL
                        totalProduced:
                          type: number
                          description: Total blocks produced by this witness
                        totalMissed:
                          type: number
                          description: Total blocks missed by this witness
                        latestBlockNum:
                          type: number
                          description: Latest block number produced
                        latestSlotNum:
                          type: number
                          description: Latest slot number assigned
                        isJobs:
                          type: boolean
                          description: Whether witness is currently active

````