Sign in

v1

latestSwagger 2.02026-07-17127100479.5 KB
proposal

List proposal info

Returns a paginated list of governance proposals. Supports filtering by proposer address, status, and type.

get/proposal

Query parameters

limitinteger

Count of requested entities

offsetinteger

Offset

sort'asc' | 'desc'

Sort order. Default: desc

proposerstring

Proposer celestia address

statusstring

Comma-separated proposal status list

typestring

Comma-separated proposal type list

Response

OK

abstaininteger
abstain_addrsinteger
abstain_valsinteger
abstain_voting_powerstring string
activation_timestring date-time
created_atstring date-time
depositstring string
deposit_timestring date-time
descriptionstring string
end_timestring date-time
errorstring string
heightinteger
idinteger
metadatastring string
min_depositstring string
nointeger
no_addrsinteger
no_valsinteger
no_voting_powerstring string
no_with_vetointeger
no_with_veto_addrsinteger
no_with_veto_valsinteger
no_with_veto_voting_powerstring string
quorumstring string
statusstring string
thresholdstring string
titlestring string
total_voting_powerstring string
typestring string
veto_quorumstring string
votes_countinteger
voting_powerstring string
yesinteger
yes_addrsinteger
yes_valsinteger
yes_voting_powerstring string

Example response

[
  {
    "abstain": 1234,
    "abstain_addrs": 1234,
    "abstain_vals": 1234,
    "abstain_voting_power": "1000000000",
    "activation_time": "2023-07-04T03:10:57+00:00",
    "created_at": "2023-07-04T03:10:57+00:00",
    "deposit": "1000000000",
    "deposit_time": "2023-07-04T03:10:57+00:00",
    "description": "Some proposal description",
    "end_time": "2023-07-04T03:10:57+00:00",
    "error": "Some error text",
    "height": 100,
    "id": 321,
    "metadata": "metadata",
    "min_deposit": "0.33",
    "no": 1234,
    "no_addrs": 1234,
    "no_vals": 1234,
    "no_voting_power": "1000000000",
    "no_with_veto": 1234,
    "no_with_veto_addrs": 1234,
    "no_with_veto_vals": 1234,
    "no_with_veto_voting_power": "1000000000",
    "proposer": {
      "celestials": {
        "image_url": "https://ipfs.io/ipfs/QmUi269vE25fagqhyMCCTNSoiW6x4LHCwwQb3keSrEXAmC",
        "name": "name",
        "primary": true,
        "status": "VERIFIED"
      },
      "hash": "celestia1jc92qdnty48pafummfr8ava2tjtuhfdw774w60"
    },
    "quorum": "0.33",
    "status": "active",
    "threshold": "0.33",
    "title": "Proposal title",
    "total_voting_power": "1000000000",
    "type": "param_changed",
    "veto_quorum": "0.33",
    "votes_count": 12354,
    "voting_power": "1000000000",
    "yes": 1234,
    "yes_addrs": 1234,
    "yes_vals": 1234,
    "yes_voting_power": "1000000000"
  }
]