Get Blocks

Endpoint

GET /api/block/v1

Parameters

Name	In	Type	Required	Description
block_start	query	integer		block number for start of range
block_end	query	integer		block number for end of range
timestamp_start	query	integer		Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive)
timestamp_end	query	integer		Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive)
block_number	query	integer		Exact block number (as opposed to a range).
hash	query	string		Block hash number.
spec_version	query	integer
validator	query	string		not used
order	query	string
page	query	integer		The page number of the response.
limit	query	integer		The number of responses. max is 200,

Responses

200 — 200

Media: application/json

{
  "type": "object",
  "properties": {
    "pagination": {
      "type": "object",
      "properties": {
        "current_page": {
          "type": "integer",
          "example": 1,
          "default": 0
        },
        "per_page": {
          "type": "integer",
          "example": 50,
          "default": 0
        },
        "total_items": {
          "type": "integer",
          "example": 5012772,
          "default": 0
        },
        "total_pages": {
          "type": "integer",
          "example": 100256,
          "default": 0
        },
        "next_page": {
          "type": "integer",
          "example": 2,
          "default": 0
        },
        "prev_page": {}
      }
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "block_number": {
            "type": "integer",
            "example": 5012771,
            "default": 0
          },
          "hash": {
            "type": "string",
            "example": "0xa8a178b7dd69db4137e36a5a111a9b1d1e6c3ec4120a8427d9ee20993b9097dc"
          },
          "parent_hash": {
            "type": "string",
            "example": "0xa7703c86d57e82e54edae7a3a26acc2745ce647112e7d55418ecf5c843a9b2e5"
          },
          "state_root": {
            "type": "string",
            "example": "0x6122a6e6ffbef31269e522a4cefed502920b311676ac4c8b7847f3b1711527f6"
          },
          "extrinsics_root": {
            "type": "string",
            "example": "0x5693b7ec443ed7e940ec6d16603c24b69286a8d6cf8c0bf57961a59cf985d8b2"
          },
          "spec_name": {
            "type": "string",
            "example": "node-subtensor"
          },
          "spec_version": {
            "type": "integer",
            "example": 244,
            "default": 0
          },
          "impl_name": {
            "type": "string",
            "example": "node-subtensor"
          },
          "impl_version": {
            "type": "integer",
            "example": 1,
            "default": 0
          },
          "timestamp": {
            "type": "string",
            "example": "2025-02-26T17:47:48Z"
          },
          "validator": {},
          "events_count": {
            "type": "integer",
            "example": 50,
            "default": 0
          },
          "extrinsics_count": {
            "type": "integer",
            "example": 17,
            "default": 0
          },
          "calls_count": {
            "type": "integer",
            "example": 17,
            "default": 0
          }
        }
      }
    }
  }
}

400 — 400

Media: application/json

{
  "type": "object",
  "properties": {}
}

Authentication

All Taostats API requests require an Authorization header containing your API key. See Getting Started.