# WickedAPI Chain Block Header Lookup

> WickedAPI Chain Block Header Lookup is a paid API for AI agents from api.wickedapi.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-27).

Returns block header data (number, hash, timestamp, miner, tx count, gas used/limit, base fee) for the latest, safe, finalized, or any specific Ethereum block.

## Facts

- Endpoint: GET https://api.wickedapi.com/v1/chain-block?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wickedapi-chain-block-header-lookup-318cf338
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EQG0u_2mPAXxzeq161yl0

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 wickedapi-chain-block-header-lookup-318cf338
```

Example prompt: Can you pull up the block header for the latest finalized Ethereum block — I need the block number, timestamp, miner, gas used, gas limit, and base fee?

## When to prefer this

Use this endpoint when you need lightweight block header metadata (number, hash, timestamp, miner, gas stats, base fee) without full transaction or receipt data. Prefer it over full block RPC calls when you only need header-level on-chain context, especially for monitoring, auditing, or anchoring timestamps to block data.

## Known failure modes

- Invalid block number returns an error or empty response
- Block number beyond current chain height returns not-found error
- Network connectivity issues may cause timeouts
- Rate limiting if too many calls are made in quick succession

## How this service works

Block header lookup: number, hash, timestamp, miner, tx count, gas used/limit and base fee. Latest by default, or any block number, safe or finalized.

## Output

Returns a block header object containing the block number, hash, timestamp, miner address, transaction count, gas used, gas limit, and base fee for the requested block (defaulting to the latest block if no block number or tag is specified).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wickedapi-chain-block-header-lookup-318cf338/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.wickedapi.com](https://www.zero.xyz/host/api.wickedapi.com/llms.txt)