v1

latestOpenAPI 3.1.02026-07-2411205.0 MB

Get Blocks

get/api/block/v1

Query parameters

network'finney' | 'nakamoto' | 'kusanagi' | 'testnet'
block_startinteger

block number for start of range

block_endinteger

block number for end of range

timestamp_startinteger

Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive)

timestamp_endinteger

Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive)

block_numberinteger

Exact block number (as opposed to a range).

hashstring

Block hash number.

spec_versioninteger
validatorstring

not used

order'spec_version_asc' | 'spec_version_desc' | 'block_number_asc' | 'block_number_desc' | 'timestamp_asc' | 'timestamp_desc' | 'hash_asc' | 'hash_desc' | 'events_count_asc' | 'events_count_desc' | 'extrinsics_count_asc' | 'extrinsics_count_desc'
pageinteger

The page number of the response.

limitinteger

The number of responses. max is 200,

Response

200

Example response

{
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total_items": 5012772,
    "total_pages": 100256,
    "next_page": 2
  },
  "data": [
    {
      "block_number": 5012771,
      "hash": "0xa8a178b7dd69db4137e36a5a111a9b1d1e6c3ec4120a8427d9ee20993b9097dc",
      "parent_hash": "0xa7703c86d57e82e54edae7a3a26acc2745ce647112e7d55418ecf5c843a9b2e5",
      "state_root": "0x6122a6e6ffbef31269e522a4cefed502920b311676ac4c8b7847f3b1711527f6",
      "extrinsics_root": "0x5693b7ec443ed7e940ec6d16603c24b69286a8d6cf8c0bf57961a59cf985d8b2",
      "spec_name": "node-subtensor",
      "spec_version": 244,
      "impl_name": "node-subtensor",
      "impl_version": 1,
      "timestamp": "2025-02-26T17:47:48Z",
      "events_count": 50,
      "extrinsics_count": 17,
      "calls_count": 17
    }
  ]
}