# Axiomworks Block Lookup API

> Axiomworks Block Lookup API is a paid API for AI agents from api.axiomworks.co.uk, paid per call via x402, $0.001/call, status down (last checked 2026-11-17).

Retrieves EVM blockchain block data by block number, tag (latest/finalized), or timestamp for historical queries across Base, Ethereum, Arbitrum, Optimism, and Polygon.

## Facts

- Endpoint: GET https://api.axiomworks.co.uk/block?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/axiomworks-block-lookup-api-0809a48e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_a7FmAkdW8X5dHI3ST35n_

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 axiomworks-block-lookup-api-0809a48e
```

Example prompt: What was the last block mined on Base before midnight on January 1, 2026? I need the block number, hash, and base fee.

## When to prefer this

Use this endpoint when you need to map a human-readable date/time to an EVM block number for historical queries (e.g., historical balances, snapshot voting), when you need basic block metadata (hash, tx count, base fee) quickly and cheaply, or when you need to resolve 'latest', 'safe', or 'finalized' tags to concrete block data across Base, Ethereum, Arbitrum, Optimism, or Polygon. At $0.001/call it is cost-effective for high-frequency lookups. Prefer this over a full RPC node when you don't want to manage infrastructure and only need lightweight block metadata.

## Known failure modes

- Block number out of range returns an error or null result
- Unsupported chain value returns a validation error
- Timestamp in the future may return the latest block or an error
- Malformed timestamp string (non-ISO, non-Unix) causes a 400 error
- Network unavailability for a specific chain may cause a timeout
- Missing required parameters returns a schema validation error
- Hex block numbers that are malformed may cause parsing errors

## How this service works

Use this to get a block by number/latest/finalized, or find the block at a date/time (timestamp → block, for historical balance or event queries). Returns number, hash, time, tx count, base fee. Example: {timestamp:"2026-01-01T00:00:00Z", chain:"base"}. $0.001.

## Output

Returns a JSON object containing the block number (integer), block hash (hex string), ISO 8601 timestamp (time_iso), Unix timestamp (integer), transaction count (integer or null), and base fee in Gwei (number or null) for the matched block on the requested EVM chain.

## 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": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon"
       ],
       "type": "string",
       "description": "EVM chain (default base)"
      },
      "number": {
       "type": "string",
       "description": "Block number (decimal/hex) or latest|safe|finalized"
      },
      "timestamp": {
       "type": "string",
       "description": "Unix seconds or ISO date: returns last block at/before it"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "hash": {
       "type": "string"
      },
      "number": {
       "type": "integer"
      },
      "time_iso": {
       "type": "string"
      },
      "tx_count": {
       "type": [
        "integer",
        "null"
       ]
      },
      "timestamp": {
       "type": "integer"
      },
      "base_fee_gwei": {
       "type": [
        "number",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/axiomworks-block-lookup-api-0809a48e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.axiomworks.co.uk](https://www.zero.xyz/host/api.axiomworks.co.uk/llms.txt)
