# Ethereum Mainnet Block by Number (eth_getBlockByNumber)

> Ethereum Mainnet Block by Number (eth_getBlockByNumber) 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 specific Ethereum mainnet block by block number or 'latest' via eth_getBlockByNumber

## Facts

- Endpoint: GET https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_eth_get_block_by_number?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-block-by-number-eth-getblockbynumber-a8bc0f45
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1KbtrIrdTmFTmwat3rsAF

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-block-by-number-eth-getblockbynumber-a8bc0f45
```

Example prompt: What are the details of the latest Ethereum mainnet block — give me the hash, miner, gas used, timestamp, and base fee?

## When to prefer this

Use this endpoint when you need detailed Ethereum mainnet block header data — including miner, gas metrics, timestamps, state root, and fee info — for a specific block number or the latest block. Prefer this over general Web3 RPC providers when you need a simple pay-per-call HTTP GET with no node setup, API key management, or rate-limit negotiation.

## Known failure modes

- Invalid block number format returns an error
- Block number ahead of chain tip returns null result
- Network congestion may cause slow response
- Malformed or missing 'block' parameter causes bad request
- Service unavailable if Ethereum node is down

## 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, chain='ethereum', method='eth_getBlockByNumber', and a result object containing the full block header: hash, number, miner, nonce, gasUsed, gasLimit, timestamp, baseFeePerGas, blobGasUsed, excessBlobGas, stateRoot, parentHash, transactionsRoot, receiptsRoot, withdrawalsRoot, logsBloom, extraData, mixHash, sha3Uncles, difficulty, size, uncles, and parentBeaconBlockRoot.

## 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-block-by-number-eth-getblockbynumber-a8bc0f45/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)