Get Validators by Block Height

POST

https://luna-tendermint.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Calls the validators JSON-RPC method to retrieve a paginated list of validators at a given block height.

Body

application/json

jsonrpcstring2.0required

JSON-RPC protocol version, must be "2.0".

idintegerrequired

Unique identifier for the request, used to match the response.

methodstringvalidatorsrequired

The method name to call.

paramsobjectrequired

Show child attributes

heightstringrequired

The block height for which to query the validators.

pagestringrequired

Page number for pagination (1-based).

per_pagestringrequired

Number of validators to return per page.

Response

200OK

Successful response containing validators list and metadata

Get Validators by Block Height

curl -X POST 'https://luna-tendermint.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 0,
    "method": "validators",
    "params": {
      "height": "21870321",
      "page": "1",
      "per_page": "30"
    }
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://luna-tendermint.nownodes.io/");
const result = await provider.send("validators", {
  "height": "21870321",
  "page": "1",
  "per_page": "30"
});
console.log(result);

require 'eth'
require 'json'
require 'net/http'

uri = URI('https://luna-tendermint.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "validators",
  "params": {
    "height": "21870321",
    "page": "1",
    "per_page": "30"
  },
  "id": 1
}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://luna-tendermint.nownodes.io/"))
response = w3.provider.make_request("validators", {
  "height": "21870321",
  "page": "1",
  "per_page": "30"
})
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://luna-tendermint.nownodes.io/"),
});

const result = await client.request({
  method: "validators",
  params: {
  "height": "21870321",
  "page": "1",
  "per_page": "30"
},
});

console.log(result);

const endpoint = "https://luna-tendermint.nownodes.io/";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({ jsonrpc: "2.0", method: "validators", params: {
  "height": "21870321",
  "page": "1",
  "per_page": "30"
}, id: 1 });
console.log(result);

const response = await fetch('https://luna-tendermint.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 0,
      "method": "validators",
      "params": {
        "height": "21870321",
        "page": "1",
        "per_page": "30"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 0,
  "method": "validators",
  "params": {
    "height": "21870321",
    "page": "1",
    "per_page": "30"
  }
}

response = requests.post('https://luna-tendermint.nownodes.io/', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://luna-tendermint.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "id": 0,
    "method": "validators",
    "params": {
      "height": "21870321",
      "page": "1",
      "per_page": "30"
    }
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

Request Body

{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "validators",
  "params": {
    "height": "21870321",
    "page": "1",
    "per_page": "30"
  }
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "block_height": "21870321",
    "validators": [
      {
        "address": "B1852D17FA66B5382A8F770725CC5B228B357750",
        "pub_key": {
          "type": "tendermint/PubKeyEd25519",
          "value": "7AaTbVWTaspcBBsJHHoxGx8wZb0rZbYL4l7QkQT+uPM="
        },
        "voting_power": "9252454",
        "proposer_priority": "-6484917"
      }
    ],
    "count": "30",
    "total": "100"
  }
}

Documentation

How to migrate to NOWNodes

Get Validators by Block Height

Authorizations

Body

Response