listproposals - Tron

listproposals. Returns the full list of network parameter proposals and their statuses.

listproposals - tron [Value: 20CU]
Returns the full list of network parameter proposals and their statuses.
Use cases

Use cases

  • Also available as GET
  • Display a governance dashboard of active and past proposals
Constraints

Constraints

  • Response can grow large over time; consider getpaginatedproposallist for incremental loading
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/listproposals \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{}'
Copy
Response
200
{
  "proposals": [
    {
      "proposal_id": 1,
      "proposer_address": "41217179d498883cdbda5699402905d1feb258796c",
      "parameters": [
        { "key": 9,  "value": 1 },
        { "key": 10, "value": 1 }
      ],
      "expiration_time": 1572597600000,
      "create_time": 1572596523000,
      "approvals": [
        "41217179d498883cdbda5699402905d1feb258796c"
        /* ... other SRs */
      ],
      "state": "APPROVED"
    }
    /* ... other proposals */
  ]
}
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 network parameter proposals and their statuses.

Response params

object
proposalsarray_of_objects
The list of chain-parameter proposals matching the query.
object
proposal_idinteger
The numeric identifier of this proposal.
proposer_addressstring
The address of the witness who created this proposal, in hex format.
parametersarray_of_objects
The list of chain parameters this proposal seeks to change, each identified by a numeric key and its proposed value.
object
keyinteger
The numeric identifier of the chain parameter being changed.
valueinteger
The proposed new value for this chain parameter.
expiration_timeinteger
Unix timestamp, in ms, after which this proposal is no longer eligible to take effect.
create_timeinteger
Unix timestamp, in ms, at which this proposal was created.
approvalsarray_of_strings
The list of witness addresses that have approved this proposal so far.
statestring
The current status of this proposal in its lifecycle (e.g. PENDING, APPROVED, DISAPPROVED, CANCELED).
Proposal DeleteGet Paginated Proposal List