Skip to main content

/cosmos/staking/v1beta1/validators REST API Endpoint

Queries all validators that match the given status.

Updated on
May 15, 2024

/cosmos/staking/v1beta1/validators REST API Endpoint

Query Parameters

status
string
Enables to query for validators matching a given status
pagination.key
string
The value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set
pagination.offset
string
The 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.limit
string
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_total
boolean
When set to true it 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.reverse
boolean
It is set to true if results are to be returned in the descending order

Returns

validators
array
An array containing information about validators
operator_address
string
The address of the validator
consensus_pubkey
object
The consensus_pubkey object which contains the following fields:
@type
string
The type of the public key
key
string
The public key
jailed
boolean
A boolean indicating whether the validator is currently jailed
status
string
The status of the validator, which indicates whether it's bonded or not
tokens
string
The total number of tokens held by the validator
delegator_shares
string
The total number of shares delegated to the validator
description
object
The description object which contains the following fields:
moniker
string
The name or moniker of the validator
identity
string
Identity information of the validator
website
string
Website of the validator
security_contact
string
Security contact information of the validator
details
string
Additional details about the validator
unbonding_height
string
The height at which the validator began unbonding
unbonding_time
string
The time at which the unbonding process started
commission
object
The commission object which contains the following fields:
commission_rates
object
The commission_rates object which contains the following fields:
rate
string
The current commission rate
max_rate
string
The maximum commission rate allowed
max_change_rate
string
The maximum change rate for commission
update_time
string
The time at which the commission information was last updated
min_self_delegation
string
The minimum amount of self-delegation required for the validator
unbonding_on_hold_ref_count
string
(Optional) Strictly positive if this validator's unbonding has been stopped by external modules
unbonding_ids
array
(Optional) A list of unbonding ids, each uniquely identifying an unbonding of this validator
pagination
object
The pagination object which contains the following fields:
next_key
string
A key used for retrieving the next page of data, if available
total
string
The total number of validators in the dataset
Request
1
curl --location 'https://docs-demo.cosmos-mainnet.quiknode.pro/cosmos/staking/v1beta1/validators'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free