Gov

Proposals queries all proposals based on given status.

get
Authorizations
Query parameters
proposal_statusstring · enumOptional

proposal_status defines the status of the proposals.

  • PROPOSAL_STATUS_UNSPECIFIED: PROPOSAL_STATUS_UNSPECIFIED defines the default proposal status.
  • PROPOSAL_STATUS_DEPOSIT_PERIOD: PROPOSAL_STATUS_DEPOSIT_PERIOD defines a proposal status during the deposit period.
  • PROPOSAL_STATUS_VOTING_PERIOD: PROPOSAL_STATUS_VOTING_PERIOD defines a proposal status during the voting period.
  • PROPOSAL_STATUS_PASSED: PROPOSAL_STATUS_PASSED defines a proposal status of a proposal that has passed.
  • PROPOSAL_STATUS_REJECTED: PROPOSAL_STATUS_REJECTED defines a proposal status of a proposal that has been rejected.
  • PROPOSAL_STATUS_FAILED: PROPOSAL_STATUS_FAILED defines a proposal status of a proposal that has failed.
Default: PROPOSAL_STATUS_UNSPECIFIEDPossible values:
voterstringOptional

voter defines the voter address for the proposals.

depositorstringOptional

depositor defines the deposit addresses from the proposals.

pagination.keystring · byteOptional

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring · uint64Optional

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limitstring · uint64Optional

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_totalbooleanOptional

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reversebooleanOptional

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses
200
A successful response.
application/json
get
GET /cosmos/gov/v1beta1/proposals HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "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": "2025-07-22T21:19:25.399Z",
      "deposit_end_time": "2025-07-22T21:19:25.399Z",
      "total_deposit": [
        {
          "denom": "text",
          "amount": "text"
        }
      ],
      "voting_start_time": "2025-07-22T21:19:25.399Z",
      "voting_end_time": "2025-07-22T21:19:25.399Z"
    }
  ],
  "pagination": {
    "next_key": "Ynl0ZXM=",
    "total": "text"
  }
}

Proposal queries proposal details based on ProposalID.

get
Authorizations
Path parameters
proposal_idstring · uint64Required

proposal_id defines the unique id of the proposal.

Responses
200
A successful response.
application/json
get
GET /cosmos/gov/v1beta1/proposals/{proposal_id} HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "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": "2025-07-22T21:19:25.399Z",
    "deposit_end_time": "2025-07-22T21:19:25.399Z",
    "total_deposit": [
      {
        "denom": "text",
        "amount": "text"
      }
    ],
    "voting_start_time": "2025-07-22T21:19:25.399Z",
    "voting_end_time": "2025-07-22T21:19:25.399Z"
  }
}

Deposits queries all deposits of a single proposal.

get
Authorizations
Path parameters
proposal_idstring · uint64Required

proposal_id defines the unique id of the proposal.

Query parameters
pagination.keystring · byteOptional

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring · uint64Optional

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limitstring · uint64Optional

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_totalbooleanOptional

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reversebooleanOptional

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses
200
A successful response.
application/json
get
GET /cosmos/gov/v1beta1/proposals/{proposal_id}/deposits HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "deposits": [
    {
      "proposal_id": "text",
      "depositor": "text",
      "amount": [
        {
          "denom": "text",
          "amount": "text"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "Ynl0ZXM=",
    "total": "text"
  }
}

Deposit queries single deposit information based on proposalID, depositor address.

get
Authorizations
Path parameters
proposal_idstring · uint64Required

proposal_id defines the unique id of the proposal.

depositorstringRequired

depositor defines the deposit addresses from the proposals.

Responses
200
A successful response.
application/json
get
GET /cosmos/gov/v1beta1/proposals/{proposal_id}/deposits/{depositor} HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "deposit": {
    "proposal_id": "text",
    "depositor": "text",
    "amount": [
      {
        "denom": "text",
        "amount": "text"
      }
    ]
  }
}

TallyResult queries the tally of a proposal vote.

get
Authorizations
Path parameters
proposal_idstring · uint64Required

proposal_id defines the unique id of the proposal.

Responses
200
A successful response.
application/json
get
GET /cosmos/gov/v1beta1/proposals/{proposal_id}/tally HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "tally": {
    "yes": "text",
    "abstain": "text",
    "no": "text",
    "no_with_veto": "text"
  }
}

Votes queries votes of a given proposal.

get
Authorizations
Path parameters
proposal_idstring · uint64Required

proposal_id defines the unique id of the proposal.

Query parameters
pagination.keystring · byteOptional

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring · uint64Optional

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limitstring · uint64Optional

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_totalbooleanOptional

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reversebooleanOptional

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses
200
A successful response.
application/json
get
GET /cosmos/gov/v1beta1/proposals/{proposal_id}/votes HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "votes": [
    {
      "proposal_id": "text",
      "voter": "text",
      "option": "VOTE_OPTION_UNSPECIFIED",
      "options": [
        {
          "option": "VOTE_OPTION_UNSPECIFIED",
          "weight": "text"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "Ynl0ZXM=",
    "total": "text"
  }
}

Vote queries voted information based on proposalID, voterAddr.

get
Authorizations
Path parameters
proposal_idstring · uint64Required

proposal_id defines the unique id of the proposal.

voterstringRequired

voter defines the voter address for the proposals.

Responses
200
A successful response.
application/json
get
GET /cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter} HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "vote": {
    "proposal_id": "text",
    "voter": "text",
    "option": "VOTE_OPTION_UNSPECIFIED",
    "options": [
      {
        "option": "VOTE_OPTION_UNSPECIFIED",
        "weight": "text"
      }
    ]
  }
}

Constitution queries the chain's constitution.

get
Authorizations
Responses
200
A successful response.
application/json
get
GET /cosmos/gov/v1/constitution HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "constitution": "text"
}

Params queries all parameters of the gov module.

get
Authorizations
Path parameters
params_typestringRequired

params_type defines which parameters to query for, can be one of "voting", "tallying" or "deposit".

Responses
200
A successful response.
application/json
get
GET /cosmos/gov/v1/params/{params_type} HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "voting_params": {
    "voting_period": "text"
  },
  "deposit_params": {
    "min_deposit": [
      {
        "denom": "text",
        "amount": "text"
      }
    ],
    "max_deposit_period": "text"
  },
  "tally_params": {
    "quorum": "text",
    "threshold": "text",
    "veto_threshold": "text"
  },
  "params": {
    "min_deposit": [
      {
        "denom": "text",
        "amount": "text"
      }
    ],
    "max_deposit_period": "text",
    "voting_period": "text",
    "quorum": "text",
    "threshold": "text",
    "veto_threshold": "text",
    "min_initial_deposit_ratio": "text",
    "proposal_cancel_ratio": "text",
    "proposal_cancel_dest": "text",
    "expedited_voting_period": "text",
    "expedited_threshold": "text",
    "expedited_min_deposit": [
      {
        "denom": "text",
        "amount": "text"
      }
    ],
    "burn_vote_quorum": true,
    "burn_proposal_deposit_prevote": true,
    "burn_vote_veto": true,
    "min_deposit_ratio": "text"
  }
}

Proposals queries all proposals based on given status.

get
Authorizations
Query parameters
proposal_statusstring · enumOptional

proposal_status defines the status of the proposals.

  • PROPOSAL_STATUS_UNSPECIFIED: PROPOSAL_STATUS_UNSPECIFIED defines the default proposal status.
  • PROPOSAL_STATUS_DEPOSIT_PERIOD: PROPOSAL_STATUS_DEPOSIT_PERIOD defines a proposal status during the deposit period.
  • PROPOSAL_STATUS_VOTING_PERIOD: PROPOSAL_STATUS_VOTING_PERIOD defines a proposal status during the voting period.
  • PROPOSAL_STATUS_PASSED: PROPOSAL_STATUS_PASSED defines a proposal status of a proposal that has passed.
  • PROPOSAL_STATUS_REJECTED: PROPOSAL_STATUS_REJECTED defines a proposal status of a proposal that has been rejected.
  • PROPOSAL_STATUS_FAILED: PROPOSAL_STATUS_FAILED defines a proposal status of a proposal that has failed.
Default: PROPOSAL_STATUS_UNSPECIFIEDPossible values:
voterstringOptional

voter defines the voter address for the proposals.

depositorstringOptional

depositor defines the deposit addresses from the proposals.

pagination.keystring · byteOptional

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring · uint64Optional

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limitstring · uint64Optional

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_totalbooleanOptional

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reversebooleanOptional

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses
200
A successful response.
application/json
get
GET /cosmos/gov/v1/proposals HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "proposals": [
    {
      "id": "text",
      "messages": [
        {
          "type_url": "text",
          "value": "Ynl0ZXM="
        }
      ],
      "status": "PROPOSAL_STATUS_UNSPECIFIED",
      "final_tally_result": {
        "yes_count": "text",
        "abstain_count": "text",
        "no_count": "text",
        "no_with_veto_count": "text"
      },
      "submit_time": "2025-07-22T21:19:25.399Z",
      "deposit_end_time": "2025-07-22T21:19:25.399Z",
      "total_deposit": [
        {
          "denom": "text",
          "amount": "text"
        }
      ],
      "voting_start_time": "2025-07-22T21:19:25.399Z",
      "voting_end_time": "2025-07-22T21:19:25.399Z",
      "metadata": "text",
      "title": "text",
      "summary": "text",
      "proposer": "text",
      "expedited": true,
      "failed_reason": "text"
    }
  ],
  "pagination": {
    "next_key": "Ynl0ZXM=",
    "total": "text"
  }
}

Proposal queries proposal details based on ProposalID.

get
Authorizations
Path parameters
proposal_idstring · uint64Required

proposal_id defines the unique id of the proposal.

Responses
200
A successful response.
application/json
get
GET /cosmos/gov/v1/proposals/{proposal_id} HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "proposal": {
    "id": "text",
    "messages": [
      {
        "type_url": "text",
        "value": "Ynl0ZXM="
      }
    ],
    "status": "PROPOSAL_STATUS_UNSPECIFIED",
    "final_tally_result": {
      "yes_count": "text",
      "abstain_count": "text",
      "no_count": "text",
      "no_with_veto_count": "text"
    },
    "submit_time": "2025-07-22T21:19:25.399Z",
    "deposit_end_time": "2025-07-22T21:19:25.399Z",
    "total_deposit": [
      {
        "denom": "text",
        "amount": "text"
      }
    ],
    "voting_start_time": "2025-07-22T21:19:25.399Z",
    "voting_end_time": "2025-07-22T21:19:25.399Z",
    "metadata": "text",
    "title": "text",
    "summary": "text",
    "proposer": "text",
    "expedited": true,
    "failed_reason": "text"
  }
}

Deposits queries all deposits of a single proposal.

get
Authorizations
Path parameters
proposal_idstring · uint64Required

proposal_id defines the unique id of the proposal.

Query parameters
pagination.keystring · byteOptional

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring · uint64Optional

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limitstring · uint64Optional

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_totalbooleanOptional

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reversebooleanOptional

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses
200
A successful response.
application/json
get
GET /cosmos/gov/v1/proposals/{proposal_id}/deposits HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "deposits": [
    {
      "proposal_id": "text",
      "depositor": "text",
      "amount": [
        {
          "denom": "text",
          "amount": "text"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "Ynl0ZXM=",
    "total": "text"
  }
}

Deposit queries single deposit information based on proposalID, depositAddr.

get
Authorizations
Path parameters
proposal_idstring · uint64Required

proposal_id defines the unique id of the proposal.

depositorstringRequired

depositor defines the deposit addresses from the proposals.

Responses
200
A successful response.
application/json
get
GET /cosmos/gov/v1/proposals/{proposal_id}/deposits/{depositor} HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "deposit": {
    "proposal_id": "text",
    "depositor": "text",
    "amount": [
      {
        "denom": "text",
        "amount": "text"
      }
    ]
  }
}

TallyResult queries the tally of a proposal vote.

get
Authorizations
Path parameters
proposal_idstring · uint64Required

proposal_id defines the unique id of the proposal.

Responses
200
A successful response.
application/json
get
GET /cosmos/gov/v1/proposals/{proposal_id}/tally HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "tally": {
    "yes_count": "text",
    "abstain_count": "text",
    "no_count": "text",
    "no_with_veto_count": "text"
  }
}

Votes queries votes of a given proposal.

get
Authorizations
Path parameters
proposal_idstring · uint64Required

proposal_id defines the unique id of the proposal.

Query parameters
pagination.keystring · byteOptional

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring · uint64Optional

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limitstring · uint64Optional

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.count_totalbooleanOptional

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reversebooleanOptional

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses
200
A successful response.
application/json
get
GET /cosmos/gov/v1/proposals/{proposal_id}/votes HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "votes": [
    {
      "proposal_id": "text",
      "voter": "text",
      "options": [
        {
          "option": "VOTE_OPTION_UNSPECIFIED",
          "weight": "text"
        }
      ],
      "metadata": "text"
    }
  ],
  "pagination": {
    "next_key": "Ynl0ZXM=",
    "total": "text"
  }
}

Vote queries voted information based on proposalID, voterAddr.

get
Authorizations
Path parameters
proposal_idstring · uint64Required

proposal_id defines the unique id of the proposal.

voterstringRequired

voter defines the voter address for the proposals.

Responses
200
A successful response.
application/json
get
GET /cosmos/gov/v1/proposals/{proposal_id}/votes/{voter} HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "vote": {
    "proposal_id": "text",
    "voter": "text",
    "options": [
      {
        "option": "VOTE_OPTION_UNSPECIFIED",
        "weight": "text"
      }
    ],
    "metadata": "text"
  }
}
PreviousCosmosNextMint