Client
CLI
A user can query and interact with the gov module using the CLI.
Query
The query commands allow users to query gov state.
simd query gov --helpdeposit
The deposit command allows users to query a deposit for a given proposal from a given depositor.
simd query gov deposit [proposal-id] [depositer-addr] [flags]Example:
simd query gov deposit 1 cosmos1..Example Output:
amount:
- amount: "100"
denom: stake
depositor: cosmos1..
proposal_id: "1"deposits
The deposits command allows users to query all deposits for a given proposal.
simd query gov deposits [proposal-id] [flags]Example:
simd query gov deposits 1Example Output:
deposits:
- amount:
- amount: "100"
denom: stake
depositor: cosmos1..
proposal_id: "1"
pagination:
next_key: null
total: "0"param
The param command allows users to query a given parameter for the gov module.
simd query gov param [param-type] [flags]Example:
simd query gov param votingExample Output:
voting_period: "172800000000000"params
The params command allows users to query all parameters for the gov module.
simd query gov params [flags]Example:
simd query gov paramsExample output:
deposit_params:
max_deposit_period: "172800000000000"
min_deposit:
- amount: "10000000"
denom: stake
tally_params:
quorum: "0.334000000000000000"
threshold: "0.500000000000000000"
veto_threshold: "0.334000000000000000"
voting_params:
voting_period: "172800000000000"proposal
The proposal command allows users to query a given proposal.
simd query gov proposal [proposal-id] [flags]Example:
simd query gov proposal 1Example Output:
deposit_end_time: "2022-03-30T11:50:20.819676256Z"
final_tally_result:
abstain_count: "0"
no_count: "0"
no_with_veto_count: "0"
yes_count: "0"
id: "1"
messages:
- '@type': /cosmos.bank.v1beta1.MsgSend
amount:
- amount: "10"
denom: stake
from_address: cosmos1..
to_address: cosmos1..
metadata: AQ==
status: PROPOSAL_STATUS_DEPOSIT_PERIOD
submit_time: "2022-03-28T11:50:20.819676256Z"
total_deposit:
- amount: "10"
denom: stake
voting_end_time: null
voting_start_time: nullproposals
The proposals command allows users to query all proposals with optional filters.
simd query gov proposals [flags]Example:
simd query gov proposalsExample Output:
pagination:
next_key: null
total: "0"
proposals:
- deposit_end_time: "2022-03-30T11:50:20.819676256Z"
final_tally_result:
abstain_count: "0"
no_count: "0"
no_with_veto_count: "0"
yes_count: "0"
id: "1"
messages:
- '@type': /cosmos.bank.v1beta1.MsgSend
amount:
- amount: "10"
denom: stake
from_address: cosmos1..
to_address: cosmos1..
metadata: AQ==
status: PROPOSAL_STATUS_DEPOSIT_PERIOD
submit_time: "2022-03-28T11:50:20.819676256Z"
total_deposit:
- amount: "10"
denom: stake
voting_end_time: null
voting_start_time: null
- deposit_end_time: "2022-03-30T14:02:41.165025015Z"
final_tally_result:
abstain_count: "0"
no_count: "0"
no_with_veto_count: "0"
yes_count: "0"
id: "2"
messages:
- '@type': /cosmos.bank.v1beta1.MsgSend
amount:
- amount: "10"
denom: stake
from_address: cosmos1..
to_address: cosmos1..
metadata: AQ==
status: PROPOSAL_STATUS_DEPOSIT_PERIOD
submit_time: "2022-03-28T14:02:41.165025015Z"
total_deposit:
- amount: "10"
denom: stake
voting_end_time: null
voting_start_time: nullproposer
The proposer command allows users to query the proposer for a given proposal.
simd query gov proposer [proposal-id] [flags]Example:
simd query gov proposer 1Example Output:
proposal_id: "1"
proposer: cosmos1..tally
The tally command allows users to query the tally of a given proposal vote.
simd query gov tally [proposal-id] [flags]Example:
simd query gov tally 1Example Output:
abstain: "0"
"no": "0"
no_with_veto: "0"
"yes": "1"vote
The vote command allows users to query a vote for a given proposal.
simd query gov vote [proposal-id] [voter-addr] [flags]Example:
simd query gov vote 1 cosmos1..Example Output:
option: VOTE_OPTION_YES
options:
- option: VOTE_OPTION_YES
weight: "1.000000000000000000"
proposal_id: "1"
voter: cosmos1..votes
The votes command allows users to query all votes for a given proposal.
simd query gov votes [proposal-id] [flags]Example:
simd query gov votes 1Example Output:
pagination:
next_key: null
total: "0"
votes:
- option: VOTE_OPTION_YES
options:
- option: VOTE_OPTION_YES
weight: "1.000000000000000000"
proposal_id: "1"
voter: cosmos1..Transactions
The tx commands allow users to interact with the gov module.
simd tx gov --helpdeposit
The deposit command allows users to deposit tokens for a given proposal.
simd tx gov deposit [proposal-id] [deposit] [flags]Example:
simd tx gov deposit 1 10000000stake --from cosmos1..submit-proposal
The submit-proposal command allows users to submit a governance proposal along with some messages and metadata. Messages, metadata and deposit are defined in a JSON file.
simd tx gov submit-proposal [path-to-proposal-json] [flags]Example:
simd tx gov submit-proposal /path/to/proposal.json --from cosmos1..where proposal.json contains:
{
"messages": [
{
"@type": "/cosmos.bank.v1beta1.MsgSend",
"from_address": "cosmos1...", // The gov module module address
"to_address": "cosmos1...",
"amount":[{"denom": "stake","amount": "10"}]
}
],
"metadata": "AQ==",
"deposit": "10stake"
}submit-legacy-proposal
The submit-legacy-proposal command allows users to submit a governance legacy proposal along with an initial deposit.
simd tx gov submit-legacy-proposal [command] [flags]Example:
simd tx gov submit-legacy-proposal --title="Test Proposal" --description="testing" --type="Text" --deposit="100000000stake" --from cosmos1..Example (cancel-software-upgrade
simd tx gov submit-legacy-proposal cancel-software-upgrade --title="Test Proposal" --description="testing" --deposit="100000000stake" --from cosmos1..Example (community-pool-spend):
simd tx gov submit-legacy-proposal community-pool-spend proposal.json --from cosmos1..{
"title": "Test Proposal",
"description": "testing, 1, 2, 3",
"recipient": "cosmos1..",
"amount": "10000000stake",
"deposit": "10000000stake"
}Example (param-change):
simd tx gov submit-legacy-proposal param-change proposal.json --from cosmos1..{
"title": "Test Proposal",
"description": "testing, testing, 1, 2, 3",
"changes": [
{
"subspace": "staking",
"key": "MaxValidators",
"value": 100
}
],
"deposit": "10000000stake"
}Example (software-upgrade):
simd tx gov submit-legacy-proposal software-upgrade v2 --title="Test Proposal" --description="testing, testing, 1, 2, 3" --upgrade-height 1000000 --from cosmos1..vote
The vote command allows users to submit a vote for a given governance proposal.
simd tx gov vote [command] [flags]Example:
simd tx gov vote 1 yes --from cosmos1..weighted-vote
The weighted-vote command allows users to submit a weighted vote for a given governance proposal.
simd tx gov weighted-vote [proposal-id] [weighted-options] [flags]Example:
simd tx gov weighted-vote 1 yes=0.5,no=0.5 --from cosmos1..gRPC
A user can query the gov module using gRPC endpoints.
Proposal
The Proposal endpoint allows users to query a given proposal.
Using legacy v1beta1:
cosmos.gov.v1beta1.Query/ProposalExample:
// Some codeExample Output:
{
"proposal": {
"proposalId": "1",
"content": {"@type":"/cosmos.gov.v1beta1.TextProposal","description":"testing, testing, 1, 2, 3","title":"Test Proposal"},
"status": "PROPOSAL_STATUS_VOTING_PERIOD",
"finalTallyResult": {
"yes": "0",
"abstain": "0",
"no": "0",
"noWithVeto": "0"
},
"submitTime": "2021-09-16T19:40:08.712440474Z",
"depositEndTime": "2021-09-18T19:40:08.712440474Z",
"totalDeposit": [
{
"denom": "stake",
"amount": "10000000"
}
],
"votingStartTime": "2021-09-16T19:40:08.712440474Z",
"votingEndTime": "2021-09-18T19:40:08.712440474Z"
}
}Using v1:
cosmos.gov.v1.Query/ProposalExample:
grpcurl -plaintext \
-d '{"proposal_id":"1"}' \
localhost:9090 \
cosmos.gov.v1.Query/ProposalExample Output:
{
"proposal": {
"id": "1",
"messages": [
{"@type":"/cosmos.bank.v1beta1.MsgSend","amount":[{"denom":"stake","amount":"10"}],"fromAddress":"cosmos1..","toAddress":"cosmos1.."}
],
"status": "PROPOSAL_STATUS_VOTING_PERIOD",
"finalTallyResult": {
"yesCount": "0",
"abstainCount": "0",
"noCount": "0",
"noWithVetoCount": "0"
},
"submitTime": "2022-03-28T11:50:20.819676256Z",
"depositEndTime": "2022-03-30T11:50:20.819676256Z",
"totalDeposit": [
{
"denom": "stake",
"amount": "10000000"
}
],
"votingStartTime": "2022-03-28T14:25:26.644857113Z",
"votingEndTime": "2022-03-30T14:25:26.644857113Z",
"metadata": "AQ=="
}
}Proposals
The Proposals endpoint allows users to query all proposals with optional filters.
Using legacy v1beta1:
cosmos.gov.v1beta1.Query/ProposalsExample:
grpcurl -plaintext \
localhost:9090 \
cosmos.gov.v1beta1.Query/ProposalsExample Output:
{
"proposals": [
{
"proposalId": "1",
"status": "PROPOSAL_STATUS_VOTING_PERIOD",
"finalTallyResult": {
"yes": "0",
"abstain": "0",
"no": "0",
"noWithVeto": "0"
},
"submitTime": "2022-03-28T11:50:20.819676256Z",
"depositEndTime": "2022-03-30T11:50:20.819676256Z",
"totalDeposit": [
{
"denom": "stake",
"amount": "10000000010"
}
],
"votingStartTime": "2022-03-28T14:25:26.644857113Z",
"votingEndTime": "2022-03-30T14:25:26.644857113Z"
},
{
"proposalId": "2",
"status": "PROPOSAL_STATUS_DEPOSIT_PERIOD",
"finalTallyResult": {
"yes": "0",
"abstain": "0",
"no": "0",
"noWithVeto": "0"
},
"submitTime": "2022-03-28T14:02:41.165025015Z",
"depositEndTime": "2022-03-30T14:02:41.165025015Z",
"totalDeposit": [
{
"denom": "stake",
"amount": "10"
}
],
"votingStartTime": "0001-01-01T00:00:00Z",
"votingEndTime": "0001-01-01T00:00:00Z"
}
],
"pagination": {
"total": "2"
}
}Using v1:
cosmos.gov.v1.Query/ProposalsExample:
grpcurl -plaintext \
localhost:9090 \
cosmos.gov.v1.Query/ProposalsExample Output:
{
"proposals": [
{
"id": "1",
"messages": [
{"@type":"/cosmos.bank.v1beta1.MsgSend","amount":[{"denom":"stake","amount":"10"}],"fromAddress":"cosmos1..","toAddress":"cosmos1.."}
],
"status": "PROPOSAL_STATUS_VOTING_PERIOD",
"finalTallyResult": {
"yesCount": "0",
"abstainCount": "0",
"noCount": "0",
"noWithVetoCount": "0"
},
"submitTime": "2022-03-28T11:50:20.819676256Z",
"depositEndTime": "2022-03-30T11:50:20.819676256Z",
"totalDeposit": [
{
"denom": "stake",
"amount": "10000000010"
}
],
"votingStartTime": "2022-03-28T14:25:26.644857113Z",
"votingEndTime": "2022-03-30T14:25:26.644857113Z",
"metadata": "AQ=="
},
{
"id": "2",
"messages": [
{"@type":"/cosmos.bank.v1beta1.MsgSend","amount":[{"denom":"stake","amount":"10"}],"fromAddress":"cosmos1..","toAddress":"cosmos1.."}
],
"status": "PROPOSAL_STATUS_DEPOSIT_PERIOD",
"finalTallyResult": {
"yesCount": "0",
"abstainCount": "0",
"noCount": "0",
"noWithVetoCount": "0"
},
"submitTime": "2022-03-28T14:02:41.165025015Z",
"depositEndTime": "2022-03-30T14:02:41.165025015Z",
"totalDeposit": [
{
"denom": "stake",
"amount": "10"
}
],
"metadata": "AQ=="
}
],
"pagination": {
"total": "2"
}
}Vote
The Vote endpoint allows users to query a vote for a given proposal.
Using legacy v1beta1:
cosmos.gov.v1beta1.Query/VoteExample:
grpcurl -plaintext \
-d '{"proposal_id":"1","voter":"cosmos1.."}' \
localhost:9090 \
cosmos.gov.v1beta1.Query/VoteExample Output:
{
"vote": {
"proposalId": "1",
"voter": "cosmos1..",
"option": "VOTE_OPTION_YES",
"options": [
{
"option": "VOTE_OPTION_YES",
"weight": "1000000000000000000"
}
]
}
}Using v1:
cosmos.gov.v1.Query/VoteExample:
grpcurl -plaintext \
-d '{"proposal_id":"1","voter":"cosmos1.."}' \
localhost:9090 \
cosmos.gov.v1.Query/VoteExample Output:
{
"vote": {
"proposalId": "1",
"voter": "cosmos1..",
"option": "VOTE_OPTION_YES",
"options": [
{
"option": "VOTE_OPTION_YES",
"weight": "1.000000000000000000"
}
]
}
}Votes
The Votes endpoint allows users to query all votes for a given proposal.
Using legacy v1beta1:
cosmos.gov.v1beta1.Query/VotesExample:
grpcurl -plaintext \
-d '{"proposal_id":"1"}' \
localhost:9090 \
cosmos.gov.v1beta1.Query/VotesExample Output:
{
"votes": [
{
"proposalId": "1",
"voter": "cosmos1..",
"options": [
{
"option": "VOTE_OPTION_YES",
"weight": "1000000000000000000"
}
]
}
],
"pagination": {
"total": "1"
}
}Using v1:
// Some codeExample:
grpcurl -plaintext \
-d '{"proposal_id":"1"}' \
localhost:9090 \
cosmos.gov.v1.Query/VotesExample Output:
{
"votes": [
{
"proposalId": "1",
"voter": "cosmos1..",
"options": [
{
"option": "VOTE_OPTION_YES",
"weight": "1.000000000000000000"
}
]
}
],
"pagination": {
"total": "1"
}
}Params
The Params endpoint allows users to query all parameters for the gov module.
Using legacy v1beta1:
cosmos.gov.v1beta1.Query/ParamsExample:
grpcurl -plaintext \
-d '{"params_type":"voting"}' \
localhost:9090 \
cosmos.gov.v1.Query/ParamsExample Output:
{
"votingParams": {
"votingPeriod": "172800s"
}
}Deposit
The Deposit endpoint allows users to query a deposit for a given proposal from a given depositor.
Using legacy v1beta1:
cosmos.gov.v1beta1.Query/DepositExample:
grpcurl -plaintext \
'{"proposal_id":"1","depositor":"cosmos1.."}' \
localhost:9090 \
cosmos.gov.v1beta1.Query/DepositExample Output:
{
"deposit": {
"proposalId": "1",
"depositor": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10000000"
}
]
}
}Using v1:
cosmos.gov.v1.Query/DepositExample:
grpcurl -plaintext \
'{"proposal_id":"1","depositor":"cosmos1.."}' \
localhost:9090 \
cosmos.gov.v1.Query/DepositExample Output:
{
"deposit": {
"proposalId": "1",
"depositor": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10000000"
}
]
}
}deposits
The Deposits endpoint allows users to query all deposits for a given proposal.
Using legacy v1beta1:
cosmos.gov.v1beta1.Query/DepositsExample:
grpcurl -plaintext \
-d '{"proposal_id":"1"}' \
localhost:9090 \
cosmos.gov.v1beta1.Query/DepositsExample Output:
{
"deposits": [
{
"proposalId": "1",
"depositor": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10000000"
}
]
}
],
"pagination": {
"total": "1"
}
}Using v1:
cosmos.gov.v1.Query/DepositsExample:
grpcurl -plaintext \
-d '{"proposal_id":"1"}' \
localhost:9090 \
cosmos.gov.v1.Query/DepositsExample Output:
{
"deposits": [
{
"proposalId": "1",
"depositor": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10000000"
}
]
}
],
"pagination": {
"total": "1"
}
}TallyResult
The TallyResult endpoint allows users to query the tally of a given proposal.
Using legacy v1beta1:
cosmos.gov.v1beta1.Query/TallyResultExample:
grpcurl -plaintext \
-d '{"proposal_id":"1"}' \
localhost:9090 \
cosmos.gov.v1beta1.Query/TallyResultExample Output:
{
"tally": {
"yes": "1000000",
"abstain": "0",
"no": "0",
"noWithVeto": "0"
}
}Using v1:
cosmos.gov.v1.Query/TallyResultExample:
grpcurl -plaintext \
-d '{"proposal_id":"1"}' \
localhost:9090 \
cosmos.gov.v1.Query/TallyResultExample Output:
{
"tally": {
"yes": "1000000",
"abstain": "0",
"no": "0",
"noWithVeto": "0"
}
}REST
A user can query the gov module using REST endpoints.
proposal
The proposals endpoint allows users to query a given proposal.
Using legacy v1beta1:
/cosmos/gov/v1beta1/proposals/{proposal_id}Example:
curl localhost:1317/cosmos/gov/v1beta1/proposals/1Example Output:
{
"proposal": {
"proposal_id": "1",
"content": null,
"status": "PROPOSAL_STATUS_VOTING_PERIOD",
"final_tally_result": {
"yes": "0",
"abstain": "0",
"no": "0",
"no_with_veto": "0"
},
"submit_time": "2022-03-28T11:50:20.819676256Z",
"deposit_end_time": "2022-03-30T11:50:20.819676256Z",
"total_deposit": [
{
"denom": "stake",
"amount": "10000000010"
}
],
"voting_start_time": "2022-03-28T14:25:26.644857113Z",
"voting_end_time": "2022-03-30T14:25:26.644857113Z"
}
}Using v1:
/cosmos/gov/v1/proposals/{proposal_id}Example:
curl localhost:1317/cosmos/gov/v1/proposals/1Example Output:
{
"proposal": {
"id": "1",
"messages": [
{
"@type": "/cosmos.bank.v1beta1.MsgSend",
"from_address": "cosmos1..",
"to_address": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10"
}
]
}
],
"status": "PROPOSAL_STATUS_VOTING_PERIOD",
"final_tally_result": {
"yes_count": "0",
"abstain_count": "0",
"no_count": "0",
"no_with_veto_count": "0"
},
"submit_time": "2022-03-28T11:50:20.819676256Z",
"deposit_end_time": "2022-03-30T11:50:20.819676256Z",
"total_deposit": [
{
"denom": "stake",
"amount": "10000000"
}
],
"voting_start_time": "2022-03-28T14:25:26.644857113Z",
"voting_end_time": "2022-03-30T14:25:26.644857113Z",
"metadata": "AQ=="
}
}proposals
The proposals endpoint also allows users to query all proposals with optional filters.
Using legacy v1beta1:
/cosmos/gov/v1beta1/proposalsExample:
curl localhost:1317/cosmos/gov/v1beta1/proposalsExample Output:
{
"proposals": [
{
"proposal_id": "1",
"content": null,
"status": "PROPOSAL_STATUS_VOTING_PERIOD",
"final_tally_result": {
"yes": "0",
"abstain": "0",
"no": "0",
"no_with_veto": "0"
},
"submit_time": "2022-03-28T11:50:20.819676256Z",
"deposit_end_time": "2022-03-30T11:50:20.819676256Z",
"total_deposit": [
{
"denom": "stake",
"amount": "10000000"
}
],
"voting_start_time": "2022-03-28T14:25:26.644857113Z",
"voting_end_time": "2022-03-30T14:25:26.644857113Z"
},
{
"proposal_id": "2",
"content": null,
"status": "PROPOSAL_STATUS_DEPOSIT_PERIOD",
"final_tally_result": {
"yes": "0",
"abstain": "0",
"no": "0",
"no_with_veto": "0"
},
"submit_time": "2022-03-28T14:02:41.165025015Z",
"deposit_end_time": "2022-03-30T14:02:41.165025015Z",
"total_deposit": [
{
"denom": "stake",
"amount": "10"
}
],
"voting_start_time": "0001-01-01T00:00:00Z",
"voting_end_time": "0001-01-01T00:00:00Z"
}
],
"pagination": {
"next_key": null,
"total": "2"
}
}Using v1:
/cosmos/gov/v1/proposalsExample:
curl localhost:1317/cosmos/gov/v1/proposalsExample Output:
{
"proposals": [
{
"id": "1",
"messages": [
{
"@type": "/cosmos.bank.v1beta1.MsgSend",
"from_address": "cosmos1..",
"to_address": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10"
}
]
}
],
"status": "PROPOSAL_STATUS_VOTING_PERIOD",
"final_tally_result": {
"yes_count": "0",
"abstain_count": "0",
"no_count": "0",
"no_with_veto_count": "0"
},
"submit_time": "2022-03-28T11:50:20.819676256Z",
"deposit_end_time": "2022-03-30T11:50:20.819676256Z",
"total_deposit": [
{
"denom": "stake",
"amount": "10000000010"
}
],
"voting_start_time": "2022-03-28T14:25:26.644857113Z",
"voting_end_time": "2022-03-30T14:25:26.644857113Z",
"metadata": "AQ=="
},
{
"id": "2",
"messages": [
{
"@type": "/cosmos.bank.v1beta1.MsgSend",
"from_address": "cosmos1..",
"to_address": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10"
}
]
}
],
"status": "PROPOSAL_STATUS_DEPOSIT_PERIOD",
"final_tally_result": {
"yes_count": "0",
"abstain_count": "0",
"no_count": "0",
"no_with_veto_count": "0"
},
"submit_time": "2022-03-28T14:02:41.165025015Z",
"deposit_end_time": "2022-03-30T14:02:41.165025015Z",
"total_deposit": [
{
"denom": "stake",
"amount": "10"
}
],
"voting_start_time": null,
"voting_end_time": null,
"metadata": "AQ=="
}
],
"pagination": {
"next_key": null,
"total": "2"
}
}voter vote
The votes endpoint allows users to query a vote for a given proposal.
Using legacy v1beta1:
/cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter}Example:
curl localhost:1317/cosmos/gov/v1beta1/proposals/1/votes/cosmos1..Example Output:
{
"vote": {
"proposal_id": "1",
"voter": "cosmos1..",
"option": "VOTE_OPTION_YES",
"options": [
{
"option": "VOTE_OPTION_YES",
"weight": "1.000000000000000000"
}
]
}
}Using v1:
/cosmos/gov/v1/proposals/{proposal_id}/votes/{voter}Example:
curl localhost:1317/cosmos/gov/v1/proposals/1/votes/cosmos1..Example Output:
{
"vote": {
"proposal_id": "1",
"voter": "cosmos1..",
"options": [
{
"option": "VOTE_OPTION_YES",
"weight": "1.000000000000000000"
}
],
"metadata": ""
}
}votes
The votes endpoint allows users to query all votes for a given proposal.
Using legacy v1beta1:
/cosmos/gov/v1beta1/proposals/{proposal_id}/votesExample:
curl localhost:1317/cosmos/gov/v1beta1/proposals/1/votesExample Output:
{{
"votes": [
{
"proposal_id": "1",
"voter": "cosmos1..",
"option": "VOTE_OPTION_YES",
"options": [
{
"option": "VOTE_OPTION_YES",
"weight": "1.000000000000000000"
}
]
}
],
"pagination": {
"next_key": null,
"total": "1"
}
}Using v1:
/cosmos/gov/v1/proposals/{proposal_id}/votesExample:
curl localhost:1317/cosmos/gov/v1/proposals/1/votesExample Output:
{
"votes": [
{
"proposal_id": "1",
"voter": "cosmos1..",
"options": [
{
"option": "VOTE_OPTION_YES",
"weight": "1.000000000000000000"
}
],
"metadata": ""
}
],
"pagination": {
"next_key": null,
"total": "1"
}
}params
The params endpoint allows users to query all parameters for the gov module.
Using legacy v1beta1:
/cosmos/gov/v1beta1/params/{params_type}Example:
curl localhost:1317/cosmos/gov/v1beta1/params/votingExample Output:
{
"voting_params": {
"voting_period": "172800s"
},
"deposit_params": {
"min_deposit": [
],
"max_deposit_period": "0s"
},
"tally_params": {
"quorum": "0.000000000000000000",
"threshold": "0.000000000000000000",
"veto_threshold": "0.000000000000000000"
}
}Using v1:
/cosmos/gov/v1/params/{params_type}Example:
curl localhost:1317/cosmos/gov/v1/params/votingExample Output:
{
"voting_params": {
"voting_period": "172800s"
},
"deposit_params": {
"min_deposit": [
],
"max_deposit_period": "0s"
},
"tally_params": {
"quorum": "0.000000000000000000",
"threshold": "0.000000000000000000",
"veto_threshold": "0.000000000000000000"
}
}deposits
The deposits endpoint allows users to query a deposit for a given proposal from a given depositor.
Using legacy v1beta1:
/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits/{depositor}Example:
curl localhost:1317/cosmos/gov/v1beta1/proposals/1/deposits/cosmos1..Example Output:
{
"deposit": {
"proposal_id": "1",
"depositor": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10000000"
}
]
}
}Using v1:
/cosmos/gov/v1/proposals/{proposal_id}/deposits/{depositor}Example:
curl localhost:1317/cosmos/gov/v1/proposals/1/deposits/cosmos1..Example Output:
{
"deposit": {
"proposal_id": "1",
"depositor": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10000000"
}
]
}
}proposal deposits
The deposits endpoint allows users to query all deposits for a given proposal.
Using legacy v1beta1:
/cosmos/gov/v1beta1/proposals/{proposal_id}/depositsExample:
curl localhost:1317/cosmos/gov/v1beta1/proposals/1/depositsExample Output:
{
"deposits": [
{
"proposal_id": "1",
"depositor": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10000000"
}
]
}
],
"pagination": {
"next_key": null,
"total": "1"
}
}Using v1:
/cosmos/gov/v1/proposals/{proposal_id}/depositsExample:
curl localhost:1317/cosmos/gov/v1/proposals/1/depositsExample Output:
{
"deposits": [
{
"proposal_id": "1",
"depositor": "cosmos1..",
"amount": [
{
"denom": "stake",
"amount": "10000000"
}
]
}
],
"pagination": {
"next_key": null,
"total": "1"
}
}tally
The tally endpoint allows users to query the tally of a given proposal.
Using legacy v1beta1:
/cosmos/gov/v1/proposals/{proposal_id}/tallyExample:
curl localhost:1317/cosmos/gov/v1/proposals/1/tallyExample Output:
{
"tally": {
"yes": "1000000",
"abstain": "0",
"no": "0",
"no_with_veto": "0"
}
}Using v1:
/cosmos/gov/v1/proposals/{proposal_id}/tallyExample:
curl localhost:1317/cosmos/gov/v1/proposals/1/tallyExample Output:
{
"tally": {
"yes": "1000000",
"abstain": "0",
"no": "0",
"no_with_veto": "0"
}
}