/cosmos/tx/v1beta1/txs/block/{height} REST API Endpoint

Path Parameters

height

string

REQUIRED

The height of the block to query

Query Parameters

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

object

Transaction data

body

object

The body object which contains the transaction payload and associated metadata

messages

array

An array of messages containing actions or instructions executed in the transaction

@type

string

The type of message, indicating the module and action being performed

client_id

string

The identifier of the IBC client associated with this message

header

object

The client update header, representing a new state of the blockchain

@type

string

The type of the header, usually identifying the consensus protocol (e.g., Tendermint)

signed_header

object

A signed block header with commit used for light client verification

header

object

The header fields representing block metadata

version

object

Protocol version used for the block

block

string

Version number of the block protocol

app

string

Version number of the application state protocol

chain_id

string

Unique ID of the blockchain network

height

string

The height of the block in the chain

time

string

Timestamp when the block was created

last_block_id

object

Identifier of the previous block

hash

string

Hash of the last block

part_set_header

object

Metadata for block part set validation

total

integer

Total number of parts

hash

string

Merkle hash of all block parts

last_commit_hash

string

Hash of the last commit info

data_hash

string

Merkle root of transaction data

validators_hash

string

Hash of the validator set at the block height

next_validators_hash

string

Hash of the next validator set

consensus_hash

string

Hash of consensus-related parameters

app_hash

string

Hash representing application state after transactions

last_results_hash

string

Hash of results from the previous block’s transactions

evidence_hash

string

Hash of evidence data for byzantine validators

proposer_address

string

Address of the validator who proposed the block

commit

object

Contains the commit signatures used to finalize the block

height

string

The block height this commit corresponds to

round

integer

Consensus round number

block_id

object

Block ID that was signed in this commit

hash

string

Hash of the block ID

part_set_header

object

Header for the part set of the block

total

integer

Total number of parts

hash

string

Hash of the block parts

signatures

array

An array of validator signatures on the block

block_id_flag

string

Indicates which block ID the validator signed

validator_address

string

Address of the signing validator

timestamp

string

Time at which the signature was made

signature

string

Cryptographic signature of the block ID

validator_set

object

Validator set corresponding to the block being verified

validators

array

List of validators active during this block

address

string

Address of the validator

pub_key

object

Validator public key details

ed25519

string

The ed25519 encoded public key

voting_power

string

Validator's voting power

proposer_priority

string

Value used to determine block proposer selection

proposer

object

The validator who proposed the block

address

string

Address of the proposer

pub_key

object

Public key of the proposer

ed25519

string

The ed25519 encoded public key

voting_power

string

Voting power of the proposer

proposer_priority

string

Proposer's selection weight

total_voting_power

string

Total cumulative voting power of all validators in the set

trusted_height

object

Trusted consensus height from which the new header is verified

revision_number

string

Chain-specific revision number

revision_height

string

Height in the given revision

trusted_validators

object

Validator set at the trusted height used for verification

validators

array

List of trusted validators

address

string

Address of the trusted validator

pub_key

object

Trusted validator's public key

ed25519

string

The ed25519 encoded public key

voting_power

string

Trusted validator's voting power

proposer_priority

string

Trusted validator’s proposer priority

proposer

object

The proposer in the trusted validator set

address

string

Address of the trusted proposer

pub_key

object

Trusted proposer’s public key

ed25519

string

The ed25519 encoded public key

voting_power

string

Voting power of the trusted proposer

proposer_priority

string

Priority of the trusted proposer

total_voting_power

string

Total voting power of trusted validator set

signer

string

Address of the signer submitting the client update message

memo

string

A memo to include in the transaction, often used for human-readable notes or tags

timeout_height

string

An optional height after which the transaction will no longer be valid

extension_options

array

An optional array of custom extension options for advanced use cases

non_critical_extension_options

array

An optional array of non-critical extension options; failure to process these does not invalidate the transaction

auth_info

object

Authorization info for the transaction

signer_infos

array

Info about signers of the transaction

public_key

object

Public key of the signer

type

string

The type of the public key

key

string

The key of the public key

mode_info

object

Mode info for signing

single

object

Single mode info

mode

string

Signing mode

multi

object

Multi-signature mode info

bitarray

object

Bit array for multi-signature

extra_bits_stored

integer

Extra bits stored in the bit array

elems

string

Elements of the bit array

mode_infos

array

Info about each signing mode in a multi-signature

sequence

string

Sequence number of the signer

fee

object

Fee information for the transaction

amount

array

Amount of fees for the transaction

denom

string

The denomination of the fee

amount

string

The amount of the fee

gas_limit

string

The gas limit for the transaction

payer

string

The payer of the transaction fees

granter

string

The granter of the transaction fees

tip

object

The optional tip used for transaction fees paid in another denom

amount

array

Array of objects representing the amount of the tip

denom

string

The denomination of the tip

amount

string

The amount of the tip

tipper

string

The address of the account paying for the tip

signatures

array

An array of signatures for the transaction

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

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

square_size

string

The size (in bytes) of each side of the data square used in Celestia's data availability layer

hash

string

The root hash (typically a Merkle root or namespaced Merkle tree root) representing the entire data square; used for verifying data availability and integrity

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

The address of the validator

validator_index

string

The validator index

signature

string

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

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

The address of the validator

validator_index

string

The validator index

signature

string

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

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

The address of the validator who created this signature

timestamp

string

The timestamp of the signature

signature

string

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

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

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

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

The address of the validator who created this signature

timestamp

string

The timestamp of the signature

signature

string

The signature

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 transaction in the dataset

Request

curl --location 'https://docs-demo.celestia-mainnet.quiknode.pro/cosmos/tx/v1beta1/txs/block/12345'

package main

import (
	"context"
	tx "cosmossdk.io/api/cosmos/tx/v1beta1"
	"encoding/hex"
	"fmt"
	"google.golang.org/grpc"
	"log"
)

func main() {
	endpoint := "YOUR_QUICKNODE_ENDPOINT"
	target, opts := getGrpcOptions(endpoint)
	grpcConn, err := grpc.Dial(target, opts...)
	if err != nil {
		log.Fatal(err)
	}
	defer grpcConn.Close()

	req := &tx.GetBlockWithTxsRequest{
		Height: 12345,
	}
	txClient := tx.NewServiceClient(grpcConn)
	resp, err := txClient.GetBlockWithTxs(context.Background(), req)
	if err != nil {
		log.Fatal(err)
	}
	hash := hex.EncodeToString(resp.GetBlockId().Hash)
	fmt.Printf("Block Height: %d, Hash: %s, Txs: %d\n", resp.GetBlock().GetHeader().Height, hash, len(resp.GetTxs()))
}

const requestOptions = {
    method: "GET",
    redirect: "follow"
  };
  
  fetch("https://docs-demo.celestia-mainnet.quiknode.pro/cosmos/tx/v1beta1/txs/block/12345", requestOptions)
    .then((response) => response.text())
    .then((result) => console.log(result))
    .catch((error) => console.error(error));

import requests

url = "https://docs-demo.celestia-mainnet.quiknode.pro/cosmos/tx/v1beta1/txs/block/12345"

payload = {}
headers = {}

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

print(response.text)

require "uri"
require "net/http"

url = URI("https://docs-demo.celestia-mainnet.quiknode.pro/cosmos/tx/v1beta1/txs/block/12345")

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

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

response = https.request(request)
puts response.read_body

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free

/cosmos/tx/v1beta1/txs/block/{height} REST API Endpoint

Fetches a block with decoded txs.

Path Parameters

Query Parameters

Returns