block - Cosmos

block. Explore how to retrieve detailed block data

block - Cosmos [Value: 20CU]
Retrieves detailed block data
Use cases

Use cases

  • Retrieve details of a specific block by height
  • Analyze transactions within a specific block
  • Verify block data for blockchain synchronization
Constraints

Constraints

  • Block height might not exist on all nodes
  • Historical block data may be pruned
  • Heavy load may affect node performance
Get started
Unlock Access to 50+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
curl --location 'https://cosmos-hub.drpc.org' \
--header 'Content-Type: application/json' \
--data '{
      "jsonrpc": "2.0",
      "method": "block",
      "params": [20431584],
      "id": 1
    }'
Copy
Response
200
{
  "jsonrpc": "2.0",
  "result": {
    "block_id": {
      "hash": "ABCDE1234567890...",
      "parts": {
        "total": 1,
        "hash": "FGHIJ1234567890..."
      }
    },
    "block": {
      "header": {
        "version": {
          "block": "11",
          "app": "0"
        },
        "chain_id": "cosmoshub-4",
        "height": "20431584",
        "time": "2022-10-12T10:55:50.385Z",
        "last_block_id": {
          "hash": "KL1234567890...",
          "parts": {
            "total": 1,
            "hash": "MNOPQ1234567890..."
          }
        },
        "last_commit_hash": "RSTU1234567890...",
        "data_hash": "VWXY1234567890...",
        "validators_hash": "ZABC1234567890...",
        "next_validators_hash": "DEFG1234567890...",
        "consensus_hash": "HIJK1234567890...",
        "app_hash": "LMNOP1234567890...",
        "last_results_hash": "QRST1234567890...",
        "evidence_hash": "UVWXY1234567890...",
        "proposer_address": "12345ABCDE..."
      },
      "data": {
        "txs": [
          "ABCDEFG1234567890..."
        ]
      },
      "evidence": {
        "evidence": []
      },
      "last_commit": {
        "height": "20431583",
        "round": 0,
        "block_id": {
          "hash": "QRSTU1234567890...",
          "parts": {
            "total": 1,
            "hash": "VWXYZ1234567890..."
          }
        },
        "signatures": [
          {
            "block_id_flag": 2,
            "validator_address": "ABCDEFGH1234567...",
            "timestamp": "2022-10-12T10:55:50.385Z",
            "signature": "12345ABCDE..."
          }
        ]
      }
    }
  },
  "id": 1
}
Copy

Request params

idinteger
jsonrpcstring
methodstring
Parametersobject
object
heightinteger
The block height to return. If no height is provided, the latest block is to be fetched

Response

200
Return the block of a height

Response params

object
idinteger
jsonrpcstring
resultobject
object
block_idobject
Details about the block's unique identifier.
object
hashstring
The unique hash of the block.
partsobject
Information about block parts.
object
totalinteger
The total number of parts.
hashstring
The hash of the block parts.
blockobject
Contains the detailed information about the block itself.
object
headerobject
The header information of the block.
object
versionobject
The version information of the block.
object
blockstring
The version of the block.
appstring
The version of the application.
chain_idstring
The identifier of the blockchain.
heightstring
The height of the block in the blockchain.
timestring
The timestamp when the block was created.
last_block_idobject
The ID of the previous block.
object
hashstring
The hash of the previous block.
partsobject
Information about the parts of the previous block.
object
totalinteger
The total number of parts in the previous block.
hashstring
The hash of the parts of the previous block.
last_commit_hashstring
The hash of the last commit.
data_hashstring
The hash of the block's data.
validators_hashstring
The hash of the validators set for this block.
next_validators_hashstring
The hash of the next validators set.
consensus_hashstring
The hash of the consensus.
app_hashstring
The hash of the application state after this block.
last_results_hashstring
The hash of the results of the last block.
evidence_hashstring
The hash of any evidence of misbehavior.
proposer_addressstring
The address of the block proposer.
dataobject
The transactions contained in the block.
object
txsarray
An array of transactions included in the block.
evidenceobject
Evidence of any malicious behavior.
object
evidencearray
Array of evidence.
object
last_commitobject
Information about the last commit.
object
heightstring
The height of the block that was committed.
roundinteger
The round number of the last commit.
block_idobject
The block ID that was committed.
object
hashstring
The hash of the committed block.
partsobject
The parts of the committed block.
object
totalinteger
The total number of parts of the committed block.
hashstring
The hash of the parts of the committed block.
signaturesarray
Array of signatures for the last commit.
object
block_id_flaginteger
Flag indicating the block ID.
validator_addressstring
The address of the validator.
timestampstring
The timestamp of the signature.
signaturestring
The signature of the validator.
Cosmos APIblock_by_hash