# Ethereum Mainnet Get Block By Number

> Ethereum Mainnet Get Block By Number 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 the full Ethereum mainnet block header for a given block number or the latest block.

## Facts

- Endpoint: GET https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_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/ethereum-mainnet-get-block-by-number-35b35041
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2UCM57NCK47emMj7w5Oxb

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 ethereum-mainnet-get-block-by-number-35b35041
```

Example prompt: Can you pull the Ethereum mainnet block header for block number 26,300,000? I need the hash, miner, timestamp, and gas used.

## When to prefer this

Use this endpoint when you need full Ethereum mainnet block header metadata for a specific block number or the latest block. Prefer it over transaction-level endpoints when you need block-level aggregates like gas totals, miner, timestamp, or state/receipts roots. Ideal for on-chain auditing, chain indexing, and block confirmation checks on Ethereum mainnet specifically (not Base or other L2s).

## Known failure modes

- Invalid or non-existent block number returns an error or null result
- Block number in the future (beyond latest) returns null
- Malformed block parameter (non-hex, non-numeric, not 'latest') results in a bad request error
- Network or RPC node unavailability causes a timeout or 5xx error
- Payment not completed (x402 protocol) results in a 402 Payment Required response

## 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 and a 'result' field containing the full Ethereum block header: block hash, number, miner, nonce, gas used, gas limit, base fee per gas, timestamp, parent hash, state root, transactions root, receipts root, logs bloom, mix hash, extra data, blob gas used, excess blob gas, withdrawals root, sha3Uncles, uncles array, and parent beacon block root.

## 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/ethereum-mainnet-get-block-by-number-35b35041/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)