block

Get blocks by reference

If a hash is passed, returns the matching block. If a number is passed, gives the blocks by that number - could be multiple blocks if there's a pruned block in that slot.

get/blocks/{block_ref}

Request

  • Base URL: https://bridge-hub.polkadot.crystal.api.submerge.io/v1
  • URL: https://bridge-hub.polkadot.crystal.api.submerge.io/v1/blocks/{block_ref}
  • Auth: none declared

Path parameters

block_refstring required

Block reference. Either a block number (integer ≥ 0), or a block hash in hex (with or without 0x prefix, case-insensitive).

Response

List of matching blocks.

eventCountinteger required

Number of events in the block.

extrinsicCountinteger required

Number of extrinsics in the block.

extrinsicRootstring required

32-byte Blake2b-256, always 0x-prefixed and lowercase in responses. Inputs elsewhere may accept mixed case or missing 0x; the API normalizes outputs.

hashstring required

32-byte Blake2b-256, always 0x-prefixed and lowercase in responses. Inputs elsewhere may accept mixed case or missing 0x; the API normalizes outputs.

numberinteger required

Block height.

parentHashstring required

32-byte Blake2b-256, always 0x-prefixed and lowercase in responses. Inputs elsewhere may accept mixed case or missing 0x; the API normalizes outputs.

specVersioninteger required

Runtime spec version.

stateRootstring required

32-byte Blake2b-256, always 0x-prefixed and lowercase in responses. Inputs elsewhere may accept mixed case or missing 0x; the API normalizes outputs.

status'proposed' | 'pruned' | 'finalized' required

Block status.

  • finalized: Blocks that have been finalized on chain.
  • proposed: Blocks that have been authored but not yet finalized.
  • pruned: Blocks that have been removed or are no longer accessible.
timestampinteger

Block timestamp. Milliseconds.

weightobject

Block weight in JSON format. Schema depends on runtime metadata.

Example response

[
  {
    "author": {
      "type": "accountId",
      "value": "0x269a84431cd8dfc5762beadfa54a8f21597c12d4f31e51f9f6f985f65ba0c626"
    },
    "eventCount": 56,
    "extrinsicCount": 2,
    "extrinsicRoot": "0x7893dd573a5033a6d785bf4038c237cbd8e1f3730d177d4f9b21c8d2c7b34454",
    "hash": "0xc82fe0d5752d42ae3d325f14206859f86cec7447f244d5b4bccfc2a00bd58df8",
    "number": 27419831,
    "parentHash": "0x1615581259dd1ac45fea1b23406367ca79c9f6dfa3b3b1115517c6e86250c42b",
    "specVersion": 1006001,
    "stateRoot": "0x8c8b0b599733c41bad79a617d8f2f0213a5d965d287cee16c9efd65f23001603",
    "status": "finalized",
    "timestamp": 1755773684012,
    "weight": {
      "mandatory": {
        "proofSize": "204955",
        "refTime": "701777135384"
      },
      "normal": {
        "proofSize": "0",
        "refTime": "0"
      },
      "operational": {
        "proofSize": "0",
        "refTime": "0"
      }
    }
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.