Skip to main content

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

Fetches a block with decoded txs.

Updated on
May 09, 2024

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

An array of decoded transactions in the block

body
object

The body of the transaction

messages
array

Messages included in the transaction

@type
string

The type URL of the message

exchange_rates
string

The exchange rates

feeder
string

The feeder address

validator
string

The validator address

memo
string

Memo field for additional info

timeout_height
string

Block height after which this transaction will not be processed

extension_options
array

Extension options for advanced transaction processing

type_url
string

The type URL of the extension

value
string

The value of the extension

non_critical_extension_options
array

Non-critical extension options

type_url
string

The type URL of the non-critical extension

value
string

The value of the non-critical extension

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 URL of the public key

key
string

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

gas_estimate
string

(Optional) The gas estimate for the transaction

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

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

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