cosmos/base/tendermint/v1beta1/validatorsets/{height}

GetValidatorSetByHeight queries validator-set at a given height.

Parameters

Object NameRequiredTypeDetail
height✅IntegerHeight to query for block.
pagination.key❌StringThe value returned in PageResponse.next_key to begin querying the next page most efficiently. If provided, then pagination.offset is not allowed.
pagination.offset❌IntegerA numeric offset that can be used when pagination.key is unavailable. It is less efficient than pagination.key. If provided, then pagination.key is not allowed.
pagination.limit❌IntegerThe 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_total❌BooleanIf set to true, the result will include a count of the total number of items available for pagination. count_total is only respected when offset is used. It is ignored when key is set.
pagination.reverse❌BooleanSet to true if results are to be returned in the descending order.
/cosmos/base/tendermint/v1beta1/validatorsets/{height}

Result

Example

Request

curl <your-rest-endpoint>/cosmos/base/tendermint/v1beta1/validatorsets/14381996?pagination.limit=2 \
  -X GET \
  -H "accept: application/json"

Return

{
    "block_height": "14381996",
    "validators": [
        {
            "address": "cosmosvalcons14sk4vptumprktehmuvvf0yynarjy4gv08t64t4",
            "pub_key": {
                "@type": "/cosmos.crypto.ed25519.PubKey",
                "key": "0kNlxBMpm+5WtfHIG1xsWatOXTKPLtmSqn3EiEIDZeI="
            },
            "voting_power": "12535782",
            "proposer_priority": "-7997945"
        },
        {
            "address": "cosmosvalcons1yxv746y5egu3l2p0q8pvv99lavgr6ptvdhx306",
            "pub_key": {
                "@type": "/cosmos.crypto.ed25519.PubKey",
                "key": "C+VWc34ZF6n/QoIAXo4191OwKxQWpbFnrGKCqcNbe1E="
            },
            "voting_power": "10491582",
            "proposer_priority": "94642626"
        }
    ],
    "pagination": {
        "next_key": null,
        "total": "175"
    }
}