Skip to content

/wallet/getpaginatedproposallist

Paginated query of proposals.

  • Source: framework/src/main/java/org/tron/core/services/http/GetPaginatedProposalListServlet.java
  • Method: GET / POST
  • Response: api.ProposalList

Request parameters

Field Type Required Description
offset int64 No Starting offset; defaults to 0
limit int64 No Page size; defaults to 0, which returns an empty list
visible bool No Address format

Example:

curl --request POST \
     --url https://nile.trongrid.io/wallet/getpaginatedproposallist \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "offset": 0,
  "limit": 1
}
'

Response

Same fields as /wallet/listproposals.

Response example (Nile, limit=1; approvals actually contains 27 SR addresses, omitted here):

{
  "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"
    }
  ]
}

Error responses

Trigger Response
Request body exceeds node.maxMessageSize (POST) {"Error": "class java.lang.Exception : body size is too big, the limit is <N>"}
offset / limit is not numeric (GET) {"Error": "class java.lang.NumberFormatException : <message>"}
Request body is not valid JSON / field type mismatch (POST) {"Error": "class com.alibaba.fastjson.JSONException : <parser info>"} or {"Error": "class org.tron.core.services.http.JsonFormat$ParseException : <decoder info>"}
Other exceptions {"Error": "<exceptionClass> : <message>"}