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

self_del_address

string

The self-delegation address associated with the validator

relayer_address

string

The relayer address associated with the validator

challenger_address

string

The challenger address associated with the validator

bls_key

string

The validator's BLS public key

pagination

object

The pagination object which contains the following fields:

next_key

string|null

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.moca-testnet.quiknode.pro/cosmos/staking/v1beta1/validators'

1
curl --location 'https://docs-demo.moca-testnet.quiknode.pro/cosmos/staking/v1beta1/validators'

1
package main
2

3
import (
4
	"context"
5
	stk "cosmossdk.io/api/cosmos/staking/v1beta1"
6
	"fmt"
7
	"google.golang.org/grpc"
8
	"log"
9
)
10

11
func main() {
12
	endpoint := "YOUR_QUICKNODE_ENDPOINT"
13
	target, opts := getGrpcOptions(endpoint)
14
	grpcConn, err := grpc.Dial(target, opts...)
15
	if err != nil {
16
		log.Fatal(err)
17
	}
18
	defer grpcConn.Close()
19

20
	staking := stk.NewQueryClient(grpcConn)
21
	resp, err := staking.Validators(context.Background(), &stk.QueryValidatorsRequest{})
22
	if err != nil {
23
		log.Fatal(err)
24
	}
25
	for _, validator := range resp.Validators {
26
		fmt.Printf("operator: %s, status: %s\n", validator.OperatorAddress, validator.GetStatus().String())
27
	}
28
}
29

1
package main
2

3
import (
4
	"context"
5
	stk "cosmossdk.io/api/cosmos/staking/v1beta1"
6
	"fmt"
7
	"google.golang.org/grpc"
8
	"log"
9
)
10

11
func main() {
12
	endpoint := "YOUR_QUICKNODE_ENDPOINT"
13
	target, opts := getGrpcOptions(endpoint)
14
	grpcConn, err := grpc.Dial(target, opts...)
15
	if err != nil {
16
		log.Fatal(err)
17
	}
18
	defer grpcConn.Close()
19

20
	staking := stk.NewQueryClient(grpcConn)
21
	resp, err := staking.Validators(context.Background(), &stk.QueryValidatorsRequest{})
22
	if err != nil {
23
		log.Fatal(err)
24
	}
25
	for _, validator := range resp.Validators {
26
		fmt.Printf("operator: %s, status: %s\n", validator.OperatorAddress, validator.GetStatus().String())
27
	}
28
}
29

1
const requestOptions = {
2
    method: "GET",
3
    redirect: "follow"
4
  };
5
  
6
  fetch("https://docs-demo.moca-testnet.quiknode.pro/cosmos/staking/v1beta1/validators", requestOptions)
7
    .then((response) => response.text())
8
    .then((result) => console.log(result))
9
    .catch((error) => console.error(error));

1
const requestOptions = {
2
    method: "GET",
3
    redirect: "follow"
4
  };
5
  
6
  fetch("https://docs-demo.moca-testnet.quiknode.pro/cosmos/staking/v1beta1/validators", requestOptions)
7
    .then((response) => response.text())
8
    .then((result) => console.log(result))
9
    .catch((error) => console.error(error));

1
import requests
2

3
url = "https://docs-demo.moca-testnet.quiknode.pro/cosmos/staking/v1beta1/validators"
4

5
payload = {}
6
headers = {}
7

8
response = requests.request("GET", url, headers=headers, data=payload)
9

10
print(response.text)
11

1
import requests
2

3
url = "https://docs-demo.moca-testnet.quiknode.pro/cosmos/staking/v1beta1/validators"
4

5
payload = {}
6
headers = {}
7

8
response = requests.request("GET", url, headers=headers, data=payload)
9

10
print(response.text)
11

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.moca-testnet.quiknode.pro/cosmos/staking/v1beta1/validators")
5

6
https = Net::HTTP.new(url.host, url.port)
7
https.use_ssl = true
8

9
request = Net::HTTP::Get.new(url)
10

11
response = https.request(request)
12
puts response.read_body
13

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.moca-testnet.quiknode.pro/cosmos/staking/v1beta1/validators")
5

6
https = Net::HTTP.new(url.host, url.port)
7
https.use_ssl = true
8

9
request = Net::HTTP::Get.new(url)
10

11
response = https.request(request)
12
puts response.read_body
13

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free