Query Parameters

height

string

REQUIRED

The block height

Returns

block_id

object

The block_id object which contains the information about the block's ID

hash

string

The hash of the block

part_set_header

object

The part_set_header object which contains the information about the parts of the block

total

integer

The total number of parts

hash

string

The hash of the parts

block

object

The block object which contains the following fields: (Deprecated: please use 'sdk_block' instead)

header

object

The header object which contains the information about the block header

version

object

The version of the block and the application

block

string

The block version

app

string

The application version

chain_id

string

The ID of the blockchain

height

string

The height of the block

time

string

The time at which the block was created

last_block_id

object

The last_block_id object which contains the information about the last block's ID

hash

string

The hash of the last block

part_set_header

object

The parts object which contains the information about the parts of the last block

total

integer

The total number of parts of the last block

hash

string

The hash of the parts of the last block

last_commit_hash

string

The hash of the last commit

data_hash

string

The hash of the block's data

validators_hash

string

The hash of the validators

next_validators_hash

string

The hash of the next validators

consensus_hash

string

The hash of the consensus

app_hash

string

The hash of the application

last_results_hash

string

The hash of the last results

evidence_hash

string

The hash of the evidence

proposer_address

string

The address of the proposer

data

object

The data object which contains the following fields:

txs

array

An array of transactions

evidence

object

An object of evidence which contains the following fields:

evidence

array

An array of evidence

duplicate_vote_evidence

object

Contains evidence of a validator signed two conflicting votes

vote_a

object

Vote represents a prevote or precommit vote from validators for consensus

type

string

The type of signed message in the consensus. It can be one of - 'SIGNED_MSG_TYPE_UNKNOWN', 'SIGNED_MSG_TYPE_PREVOTE', 'SIGNED_MSG_TYPE_PRECOMMIT', 'SIGNED_MSG_TYPE_PROPOSAL'. By default it is set to 'SIGNED_MSG_TYPE_UNKNOWN'

height

string

The height of the last commit

round

integer

The round of the last commit

block_id

object

The block_id object which provide the information about the ID of the last commit's block

hash

string

The hash of the last commit's block

part_set_header

object

The parts object which provide the information about the parts of the last commit's block

total

integer

The total number of parts of the last commit's block

hash

string

The hash of the parts of the last commit's block

timestamp

string

The timestamp

validator_address

string | null

The address of the validator

validator_index

string

The validator index

signature

string | null

The signature by the validator if they participated in consensus for the associated block

extension

string

The extension provided by the application. Only valid for precommit messages

extension_signature

string

The extension signature by the validator if they participated in consensus for the associated block. Only valid for precommit messages

vote_b

object

Vote represents a prevote or precommit vote from validators for consensus

type

string

The type of signed message in the consensus. It can be one of - 'SIGNED_MSG_TYPE_UNKNOWN', 'SIGNED_MSG_TYPE_PREVOTE', 'SIGNED_MSG_TYPE_PRECOMMIT', 'SIGNED_MSG_TYPE_PROPOSAL'. By default it is set to 'SIGNED_MSG_TYPE_UNKNOWN'

height

string

The height of the last commit

round

integer

The round of the last commit

block_id

object

The block_id object which provide the information about the ID of the last commit's block

hash

string

The hash of the last commit's block

part_set_header

object

The parts object which provide the information about the parts of the last commit's block

total

integer

The total number of parts of the last commit's block

hash

string

The hash of the parts of the last commit's block

timestamp

string

The timestamp

validator_address

string | null

The address of the validator

validator_index

string

The validator index

signature

string | null

The signature by the validator if they participated in consensus for the associated block

extension

string

The extension provided by the application. Only valid for precommit messages

extension_signature

string

The extension signature by the validator if they participated in consensus for the associated block. Only valid for precommit messages

total_voting_power

string

The total voting power

validator_power

string

The validator power

timestamp

string

The timestamp associated with the evidence

light_client_attack_evidence

object

The height of the evidence

conflicting_block

object

The height of the last commit

signed_header

object

The signed header object which contains the following fields:

header

object

The header object which contains the information about the block header

version

object

The version of the block and the application

block

string

The block version

app

string

The application version

chain_id

string

The ID of the blockchain

height

string

The height of the block

time

string

The time at which the block was created

last_block_id

object

The last_block_id object which contains the information about the last block's ID

hash

string

The hash of the last block

part_set_header

object

The parts object which contains the information about the parts of the last block

total

integer

The total number of parts of the last block

hash

string

The hash of the parts of the last block

last_commit_hash

string

The hash of the last commit

data_hash

string

The hash of the block's data

validators_hash

string

The hash of the validators

next_validators_hash

string

The hash of the next validators

consensus_hash

string

The hash of the consensus

app_hash

string

The hash of the application

last_results_hash

string

The hash of the last results

evidence_hash

string

The hash of the evidence

proposer_address

string

The address of the proposer

commit

object

Commit contains the evidence that a block was committed by a set of validators

height

string

The height of the last commit

round

integer

The round of the last commit

block_id

object

The block_id object which provide the information about the ID of the last commit's block

hash

string

The hash of the last commit's block

part_set_header

object

The parts object which provide the information about the parts of the last commit's block

total

integer

The total number of parts of the last commit's block

hash

string

The hash of the parts of the last commit's block

signatures

array

An array of signatures which contains the following fields:

block_id_flag

string

The flag for the block ID

validator_address

string | null

The address of the validator who created this signature

timestamp

string

The timestamp of the signature

signature

string | null

The signature

validator_set

object

The validator set object which contains the following fields:

validators

array

An array of validators which contains the following fields:

address

string

The address of the validator

pub_key

object | null

The public key of the validator

type

string

The type of public key

value

string

The value of public key

voting_power

string

Indicates the voting power of the validator

proposer_priority

string

The priority of the validator in proposing block

proposer

array

An array of proposer which contains the following fields:

address

string

The address of the proposer

pub_key

object | null

The public key of the proposer

type

string

The type of public key

value

string

The value of public key

voting_power

string

Indicates the voting power of the proposer

proposer_priority

string

The priority of the proposer in proposing block

total_voting_power

string

The total voting power

common_height

string

The common height

byzantine_validators

Array

The byzantine validators

address

string

The address of the validator

pub_key

object | null

The public key of the validator

type

string

The type of public key

value

string

The value of public key

voting_power

string

Indicates the voting power of the validator

proposer_priority

string

The priority of the validator in proposing block

total_voting_power

string

The total voting power

timestamp

string

The timestamp associated with the evidence

last_commit

object

The last_commit object which provide the information about the last commit

height

string

The height of the last commit

round

integer

The round of the last commit

block_id

object

The block_id object which provide the information about the ID of the last commit's block

hash

string

The hash of the last commit's block

part_set_header

object

The parts object which provide the information about the parts of the last commit's block

total

integer

The total number of parts of the last commit's block

hash

string

The hash of the parts of the last commit's block

signatures

array

An array of signatures which contains the following fields:

block_id_flag

string

The flag for the block ID

validator_address

string | null

The address of the validator who created this signature

timestamp

string

The timestamp of the signature

signature

string | null

The signature

sdk_block

object

(Optional) The sdk block object which contains the following fields:

header

object

The header object which contains the information about the block header

version

object

The version of the block and the application

block

string

The block version

app

string

The application version

chain_id

string

The ID of the blockchain

height

string

The height of the block

time

string

The time at which the block was created

last_block_id

object

The last_block_id object which contains the information about the last block's ID

hash

string

The hash of the last block

part_set_header

object

The parts object which contains the information about the parts of the last block

total

integer

The total number of parts of the last block

hash

string

The hash of the parts of the last block

last_commit_hash

string

The hash of the last commit

data_hash

string

The hash of the block's data

validators_hash

string

The hash of the validators

next_validators_hash

string

The hash of the next validators

consensus_hash

string

The hash of the consensus

app_hash

string

The hash of the application

last_results_hash

string

The hash of the last results

evidence_hash

string

The hash of the evidence

proposer_address

string

The address of the proposer

data

object

The data object which contains the following fields:

txs

array

An array of transactions

evidence

object

An object of evidence which contains the following fields:

evidence

array

An array of evidence

duplicate_vote_evidence

object

Contains evidence of a validator signed two conflicting votes

vote_a

object

Vote represents a prevote or precommit vote from validators for consensus

type

string

The type of signed message in the consensus. It can be one of - 'SIGNED_MSG_TYPE_UNKNOWN', 'SIGNED_MSG_TYPE_PREVOTE', 'SIGNED_MSG_TYPE_PRECOMMIT', 'SIGNED_MSG_TYPE_PROPOSAL'. By default it is set to 'SIGNED_MSG_TYPE_UNKNOWN'

height

string

The height of the last commit

round

integer

The round of the last commit

block_id

object

The block_id object which provide the information about the ID of the last commit's block

hash

string

The hash of the last commit's block

part_set_header

object

The parts object which provide the information about the parts of the last commit's block

total

integer

The total number of parts of the last commit's block

hash

string

The hash of the parts of the last commit's block

timestamp

string

The timestamp

validator_address

string | null

The address of the validator

validator_index

string

The validator index

signature

string | null

The signature by the validator if they participated in consensus for the associated block

extension

string

The extension provided by the application. Only valid for precommit messages

extension_signature

string

The extension signature by the validator if they participated in consensus for the associated block. Only valid for precommit messages

vote_b

object

Vote represents a prevote or precommit vote from validators for consensus

type

string

The type of signed message in the consensus. It can be one of - 'SIGNED_MSG_TYPE_UNKNOWN', 'SIGNED_MSG_TYPE_PREVOTE', 'SIGNED_MSG_TYPE_PRECOMMIT', 'SIGNED_MSG_TYPE_PROPOSAL'. By default it is set to 'SIGNED_MSG_TYPE_UNKNOWN'

height

string

The height of the last commit

round

integer

The round of the last commit

block_id

object

The block_id object which provide the information about the ID of the last commit's block

hash

string

The hash of the last commit's block

part_set_header

object

The parts object which provide the information about the parts of the last commit's block

total

integer

The total number of parts of the last commit's block

hash

string

The hash of the parts of the last commit's block

timestamp

string

The timestamp

validator_address

string | null

The address of the validator

validator_index

string

The validator index

signature

string | null

The signature by the validator if they participated in consensus for the associated block

extension

string

The extension provided by the application. Only valid for precommit messages

extension_signature

string

The extension signature by the validator if they participated in consensus for the associated block. Only valid for precommit messages

total_voting_power

string

The total voting power

validator_power

string

The validator power

timestamp

string

The timestamp associated with the evidence

light_client_attack_evidence

object

The height of the evidence

conflicting_block

object

The height of the last commit

signed_header

object

The signed header object which contains the following fields:

header

object

The header object which contains the information about the block header

version

object

The version of the block and the application

block

string

The block version

app

string

The application version

chain_id

string

The ID of the blockchain

height

string

The height of the block

time

string

The time at which the block was created

last_block_id

object

The last_block_id object which contains the information about the last block's ID

hash

string

The hash of the last block

part_set_header

object

The parts object which contains the information about the parts of the last block

total

integer

The total number of parts of the last block

hash

string

The hash of the parts of the last block

last_commit_hash

string

The hash of the last commit

data_hash

string

The hash of the block's data

validators_hash

string

The hash of the validators

next_validators_hash

string

The hash of the next validators

consensus_hash

string

The hash of the consensus

app_hash

string

The hash of the application

last_results_hash

string

The hash of the last results

evidence_hash

string

The hash of the evidence

proposer_address

string

The address of the proposer

commit

object

Commit contains the evidence that a block was committed by a set of validators

height

string

The height of the last commit

round

integer

The round of the last commit

block_id

object

The block_id object which provide the information about the ID of the last commit's block

hash

string

The hash of the last commit's block

part_set_header

object

The parts object which provide the information about the parts of the last commit's block

total

integer

The total number of parts of the last commit's block

hash

string

The hash of the parts of the last commit's block

signatures

array

An array of signatures which contains the following fields:

block_id_flag

string

The flag for the block ID

validator_address

string | null

The address of the validator who created this signature

timestamp

string

The timestamp of the signature

signature

string | null

The signature

validator_set

object

The validator set object which contains the following fields:

validators

array

An array of validators which contains the following fields:

address

string

The address of the validator

pub_key

object | null

The public key of the validator

type

string

The type of public key

value

string

The value of public key

voting_power

string

Indicates the voting power of the validator

proposer_priority

string

The priority of the validator in proposing block

proposer

array

An array of proposer which contains the following fields:

address

string

The address of the proposer

pub_key

object | null

The public key of the proposer

type

string

The type of public key

value

string

The value of public key

voting_power

string

Indicates the voting power of the proposer

proposer_priority

string

The priority of the proposer in proposing block

total_voting_power

string

The total voting power

common_height

string

The common height

byzantine_validators

Array

The byzantine validators

address

string

The address of the validator

pub_key

object | null

The public key of the validator

type

string

The type of public key

value

string

The value of public key

voting_power

string

Indicates the voting power of the validator

proposer_priority

string

The priority of the validator in proposing block

total_voting_power

string

The total voting power

timestamp

string

The timestamp associated with the evidence

last_commit

object

The last_commit object which provide the information about the last commit

height

string

The height of the last commit

round

integer

The round of the last commit

block_id

object

The block_id object which provide the information about the ID of the last commit's block

hash

string

The hash of the last commit's block

part_set_header

object

The parts object which provide the information about the parts of the last commit's block

total

integer

The total number of parts of the last commit's block

hash

string

The hash of the parts of the last commit's block

signatures

array

An array of signatures which contains the following fields:

block_id_flag

string

The flag for the block ID

validator_address

string | null

The address of the validator who created this signature

timestamp

string

The timestamp of the signature

signature

string | null

The signature

Request

1
curl --location 'https://docs-demo.sei-pacific.quiknode.pro/cosmos/base/tendermint/v1beta1/blocks/10000'

1
curl --location 'https://docs-demo.sei-pacific.quiknode.pro/cosmos/base/tendermint/v1beta1/blocks/10000'

1
package main
2

3
import (
4
	"context"
5
	tm "cosmossdk.io/api/cosmos/base/tendermint/v1beta1"
6
	"encoding/hex"
7
	"fmt"
8
	log "github.com/sirupsen/logrus"
9
	"google.golang.org/grpc"
10
)
11

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

21
	tc := tm.NewServiceClient(grpcConn)
22
	resp, err := tc.GetBlockByHeight(context.Background(), &tm.GetBlockByHeightRequest{Height: 10000})
23
	if err != nil {
24
		log.Fatal(err)
25
	}
26
	if resp.GetBlock() == nil {
27
		log.Fatal("failed to get block")
28
	}
29
	hash := hex.EncodeToString(resp.GetBlockId().Hash)
30
	fmt.Printf("block %d has hash %s\n", resp.GetBlock().GetHeader().Height, hash)
31
}
32

1
package main
2

3
import (
4
	"context"
5
	tm "cosmossdk.io/api/cosmos/base/tendermint/v1beta1"
6
	"encoding/hex"
7
	"fmt"
8
	log "github.com/sirupsen/logrus"
9
	"google.golang.org/grpc"
10
)
11

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

21
	tc := tm.NewServiceClient(grpcConn)
22
	resp, err := tc.GetBlockByHeight(context.Background(), &tm.GetBlockByHeightRequest{Height: 10000})
23
	if err != nil {
24
		log.Fatal(err)
25
	}
26
	if resp.GetBlock() == nil {
27
		log.Fatal("failed to get block")
28
	}
29
	hash := hex.EncodeToString(resp.GetBlockId().Hash)
30
	fmt.Printf("block %d has hash %s\n", resp.GetBlock().GetHeader().Height, hash)
31
}
32

1
const requestOptions = {
2
    method: "GET",
3
    redirect: "follow"
4
  };
5

6
  fetch("https://docs-demo.sei-pacific.quiknode.pro/cosmos/base/tendermint/v1beta1/blocks/10000", 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.sei-pacific.quiknode.pro/cosmos/base/tendermint/v1beta1/blocks/10000", 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.sei-pacific.quiknode.pro/cosmos/base/tendermint/v1beta1/blocks/10000"
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.sei-pacific.quiknode.pro/cosmos/base/tendermint/v1beta1/blocks/10000"
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.sei-pacific.quiknode.pro/cosmos/base/tendermint/v1beta1/blocks/10000")
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.sei-pacific.quiknode.pro/cosmos/base/tendermint/v1beta1/blocks/10000")
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