listwitnesses — Tron Wallet API

Returns the native Tron witness list.

POSThttps://triport.io/rpc/tron/wallet/listwitnesses

Network: Tron mainnet
Scope: tron:rpc
Auth: x-token: $TRIPORT_API_KEY
Rate limit: free+; tron_read_rpc: 15 / 20 / 100 / 250 RPS sustained · short burst 30 / 40 / 200 / 500 (free / basic / pro / business; default, unmeasured); Burst capacity

Request

cURLJavaScriptPython

curl https://triport.io/rpc/tron/wallet/listwitnesses \
  -H "x-token: $TRIPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

const res = await fetch("https://triport.io/rpc/tron/wallet/listwitnesses", {
  method: "POST",
  headers: {
    "x-token": process.env.TRIPORT_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
const data = await res.json();
console.log(data);

import os


import requests


resp = requests.post(
    "https://triport.io/rpc/tron/wallet/listwitnesses",
    headers={
        "x-token": os.environ["TRIPORT_API_KEY"],
        "Content-Type": "application/json",
    },
    json={},
)
data = resp.json()
print(data)

Response

JSON

Example

{}

listwitnesses returns the witness inventory represented by the native wallet API. It is a chain-state listing rather than a node peer list.

Address fields use native hex-41 representation by default. Pass visible: true to request Base58-visible representation. The request-body contract contains no filters, pagination fields, or historical selector.

Parameters

The JSON body may contain only the optional visibility switch.

visiblebooleanoptional

Defaults to false; use true for Base58-visible addresses.

Response

The concrete response example is unknown: no example or witness-field schema is published in tron.yaml. {} is only a schema-valid placeholder, not a captured witness list.

responseobject

Native witness-list object; nested fields are not enumerated by the contract.

Errors

Wallet failures use HTTP status plus JSON. See Tron errors.

HTTP	Meaning	When it happens
`400`	Bad request	`visible` is not boolean or another field is supplied.
`401`	Unauthorized	The API key is missing or invalid.
`403`	Forbidden	The scope or tier does not permit the request.
`429`	Rate limited	The `tron_read_rpc` budget is exceeded.

Examples

JavaScript

const response = await fetch("https://triport.io/rpc/tron/wallet/listwitnesses", {
  method: "POST",
  headers: { "x-token": process.env.TRIPORT_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ visible: true }),
});
const witnesses = await response.json();

Notes

visible controls address representation, not which witnesses are returned.
This endpoint is not a peer graph and does not expose a public mempool.
Related: getnodeinfo.