# TzKT Tezos Block Lookup by Level

> TzKT Tezos Block Lookup by Level 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-14).

Retrieve detailed metadata for a specific Tezos blockchain block by its level number, including fees, baker, reward, and timestamp

## Facts

- Endpoint: GET https://x402.tzkt.io/v1/blocks/%7Blevel%7D
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tzkt-tezos-block-lookup-by-level-1e52b02b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_w1YH-aNOmyPtjC4hf5B_A

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-tezos-block-lookup-by-level-1e52b02b
```

Example prompt: Can you fetch the block details for Tezos block level 5000000, including all operations and with the quote in USD?

## When to prefer this

Use this endpoint when you need to look up on-chain metadata for a specific Tezos block by its level number, particularly when you need baker identity, baking rewards, fees, or block timestamp. Prefer this over generic block explorers when you need programmatic, structured REST API access with x402 micropayment support and no API key.

## Known failure modes

- Block level does not exist yet (future block) — returns 404 not found
- Invalid level format (non-integer or negative) — returns 400 bad request
- Payment of 0.002 USDC not fulfilled — returns 402 payment required
- Network/node unavailability — returns 503 or timeout
- Invalid quote currency symbol — may return 400 or ignore the parameter

## 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 with the block's level, hash, protocol version, baker address, fees collected, baking reward, round/priority, and ISO 8601 timestamp for the specified block level.

## 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-tezos-block-lookup-by-level-1e52b02b/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)