# TzKT Block Lookup by Hash

> TzKT Block Lookup by Hash is a paid API for AI agents from x402.tzkt.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Retrieves detailed metadata for a specific Tezos block identified by its hash, including fees, baker, reward, and optional operations.

## Facts

- Endpoint: GET https://x402.tzkt.io/v1/blocks/%7Bhash%7D
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tzkt-block-lookup-by-hash-272b5d71
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-JutGB-K4yd53KiIzfHlF

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tzkt-block-lookup-by-hash-272b5d71
```

Example prompt: Can you pull up the details for Tezos block BLockHashABC123 — I want to see the baker, fees, reward, and timestamp, and include all the operations in the response?

## When to prefer this

Use this endpoint when you have a specific Tezos block hash and need authoritative, indexed metadata about that block (baker, fees, reward, operations) without running your own Tezos node. It requires no API key and charges a small per-call micropayment via x402. Prefer this over general Tezos RPC nodes when you want structured, pre-indexed data with optional quote currency support and don't want to parse raw node output.

## Known failure modes

- Block hash not found — returns 404 if the hash does not correspond to any known block
- Invalid hash format — malformed hash strings may return 400 Bad Request
- Network or gateway errors from the x402 payment layer — payment may fail before the request reaches TzKT
- Rate limiting or payment failure — if the $0.002 USDC micropayment is not processed, the request is rejected

## How this service works

TzKT is a comprehensive Tezos blockchain indexer API. Access blocks, operations, accounts, contracts, bigmaps, delegates, tokens and network stats through a fast REST API. No signup or API key required.

## Output

Returns a JSON object containing the block's hash, level, protocol version (proto), baker object, fees (integer), reward (integer), priority (integer), and ISO 8601 timestamp. If the operations flag is set, all operations included in the block are also returned. Quote currency can be specified for fiat-equivalent valuations.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "quote": {
   "type": "string",
   "description": "Quote currency"
  },
  "operations": {
   "type": "boolean",
   "description": "Include all operations in response"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "fees": {
   "type": "integer"
  },
  "hash": {
   "type": "string"
  },
  "baker": {
   "type": "object"
  },
  "level": {
   "type": "integer"
  },
  "proto": {
   "type": "integer"
  },
  "reward": {
   "type": "integer"
  },
  "priority": {
   "type": "integer"
  },
  "timestamp": {
   "type": "string",
   "format": "date-time"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tzkt-block-lookup-by-hash-272b5d71/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.tzkt.io](https://www.zero.xyz/host/x402.tzkt.io/llms.txt)