Proposals

Proposals queries all proposals based on given status.

GET/cosmos/gov/v1beta1/proposals

Query parameters

Response

200default

A successful response.

Body

application/json

proposalsarray of object

paginationobject

PageResponse is to be embedded in gRPC response messages where the corresponding request message has used PageRequest.

message SomeResponse { repeated Bar results = 1; PageResponse page = 2; }

Request

JavaScriptCurlPython

const response = await fetch('/cosmos/gov/v1beta1/proposals', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200default

{
  "proposals": [
    {
      "proposal_id": "text",
      "content": {
        "type_url": "text",
        "value": "Ynl0ZXM="
      },
      "status": "PROPOSAL_STATUS_UNSPECIFIED",
      "final_tally_result": {
        "yes": "text",
        "abstain": "text",
        "no": "text",
        "no_with_veto": "text"
      },
      "submit_time": "2024-12-21T12:18:53.443Z",
      "deposit_end_time": "2024-12-21T12:18:53.443Z",
      "total_deposit": [
        {
          "denom": "text",
          "amount": "text"
        }
      ],
      "voting_start_time": "2024-12-21T12:18:53.443Z",
      "voting_end_time": "2024-12-21T12:18:53.443Z"
    }
  ],
  "pagination": {
    "next_key": "Ynl0ZXM=",
    "total": "text"
  }
}

Proposal queries proposal details based on ProposalID.

GET/cosmos/gov/v1beta1/proposals/{proposal_id}

Path parameters

proposal_id*string (uint64)

proposal_id defines the unique id of the proposal.

Response

200default

A successful response.

Body

application/json

proposalobject

Proposal defines the core field members of a governance proposal.

Request

JavaScriptCurlPython

const response = await fetch('/cosmos/gov/v1beta1/proposals/{proposal_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200default

{
  "proposal": {
    "proposal_id": "text",
    "content": {
      "type_url": "text",
      "value": "Ynl0ZXM="
    },
    "status": "PROPOSAL_STATUS_UNSPECIFIED",
    "final_tally_result": {
      "yes": "text",
      "abstain": "text",
      "no": "text",
      "no_with_veto": "text"
    },
    "submit_time": "2024-12-21T12:18:53.443Z",
    "deposit_end_time": "2024-12-21T12:18:53.443Z",
    "total_deposit": [
      {
        "denom": "text",
        "amount": "text"
      }
    ],
    "voting_start_time": "2024-12-21T12:18:53.443Z",
    "voting_end_time": "2024-12-21T12:18:53.443Z"
  }
}