Skip to main content

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

Fetches a block with decoded txs.

Updated on
Jul 02, 2025

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

txs
array

(Optional) An array of decoded transactions in the block

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_message
object

(Optional) Nested client message for IBC client updates

packet
object

(Optional) IBC packet payload

acknowledgement
string

(Optional) IBC acknowledgement bytes

proof_acked
string

(Optional) Proof that the packet was acknowledged

proof_height
object

(Optional) Block height proof for IBC verification

namespaces
array

(Optional) Namespace IDs for blob-related messages

blob_sizes
array

(Optional) Blob sizes for blob-related messages

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 | null

(Optional) Public key of the signer

@type
string

Protobuf type URL for the public key

key
string

The public key bytes

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 | null

(Optional) The optional tip used for transaction fees paid in another denom, or null when no tip

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

(Optional) 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

(Optional) 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

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

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

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

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free