# ARYSPHERE eth_getBlockByNumber – Ethereum Block Lookup

> ARYSPHERE eth_getBlockByNumber – Ethereum Block Lookup is a paid API for AI agents from api.arysphere.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-17).

Fetches a full Ethereum mainnet block by number (or 'latest'), returning all block header fields and metadata, paid per call via x402 USDC on Base.

## Facts

- Endpoint: GET https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/eth_getblockbynumber?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arysphere-eth-getblockbynumber-ethereum-block-lookup-6dd260f0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-aljv9JWZvVUWdWSNgRL2

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 arysphere-eth-getblockbynumber-ethereum-block-lookup-6dd260f0
```

Example prompt: Can you fetch the full block details for Ethereum block number 26,000,000 — I need the miner, gas used, timestamp, and parent hash?

## When to prefer this

Choose this endpoint when you need full Ethereum mainnet block header metadata (miner, gas, timestamp, hashes) for a specific block number or the latest block, and you want a pay-per-call model with no API key or account setup. Prefer this over signing up for Alchemy/Infura when you need occasional lookups billed in USDC on Base via x402.

## Known failure modes

- Invalid or out-of-range block number returns an error or null result
- Malformed block parameter (not hex or 'latest') may return a parse error
- Payment failure via x402 will prevent the call from completing
- Upstream RPC node unavailability may result in timeout or 5xx error

## How this service works

ARYSPHERE sells AI-written verdicts on Base token contracts (a grade, a one-liner, a roast and the contract's facts) and Base/Ethereum chain reads, paid per call in USDC on Base over x402 v2. No account and no API key.

## Output

Returns a JSON object with ok:true, the chain name ('ethereum'), the RPC method name, and a full block object including hash, number, miner, nonce, gasUsed, gasLimit, timestamp, baseFeePerGas, stateRoot, parentHash, transactionsRoot, receiptsRoot, logsBloom, blobGasUsed, excessBlobGas, withdrawalsRoot, and more. No transactions list is returned by default (consistent with eth_getBlockByNumber false behavior).

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "block": {
       "type": "string",
       "description": "a block number, or 'latest'"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "chain": "ethereum",
  "method": "eth_getBlockByNumber",
  "result": {
   "hash": "0x7538fe3a3bb34856c428edf3a6987a3f65c62e420473a509e0ef6e6446aac74b",
   "size": "0x1d1af",
   "miner": "0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97",
   "nonce": "0x0000000000000000",
   "number": "0x18f1ab8",
   "uncles": [],
   "gasUsed": "0x169e64a",
   "mixHash": "0xae6149f7ce26ec6622dcee60ac3581ec58f376c6e617344d5d26fa6c79fcd84f",
   "gasLimit": "0x3938700",
   "extraData": "0x546974616e2028746974616e6275696c6465722e78797a29",
   "logsBloom": "0x51ef0f6b5db85bb77c3f1b4de1e5dfafd5fedf65f45c753c161735b56e9beff5dc2cc73aa3bc2fafb97e7b917abf7dddc76b513d9f67ef73dfff2ff2bfefe4db7379d7e11ef186fae93b772fb47b47ffeee47771edfe1bba7176649acf657edef630646aa6ce2a61faf7faf32e606cc7dbffc2be70d6b6",
   "stateRoot": "0xafc5c4791f953764c1240c4605600bffa650467910ff793a6ad44a44ec5bcdad",
   "timestamp": "0x6ac905e3",
   "difficulty": "0x0",
   "parentHash": "0x49c6e74104654981bc3d21e12e9df6dcb4fad59c775948d9c43ecc662dbbeebe",
   "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
   "blobGasUsed": "0x140000",
   "receiptsRoot": "0xd4d60719e4ba28f68eb398a5d861d44bfdb8a171742a756e0dbcc50250136183",
   "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
   "baseFeePerGas": "0x206e2cc9",
   "excessBlobGas": "0xc0db577",
   "withdrawalsRoot": "0x58b153ac66ecab07f3a899101e5e839985a01f22419ae16886f5321840808584",
   "transactionsRoot": "0xc00956eb9e6da8da2db4d3a68333bf790f6fb92471b67121666f3a739a0b9e6c",
   "parentBeaconBlockRoot": "0x0a477cb0499fc7f2a7d288b176f58f017ce1fc816648df3df102066289a3a962"
  },
  "service": "x402_chain_reads_v1.eth_getblockbynumber"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arysphere-eth-getblockbynumber-ethereum-block-lookup-6dd260f0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arysphere.com](https://www.zero.xyz/host/api.arysphere.com/llms.txt)