# Base eth_getBlockByNumber

> Base 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 Base blockchain block by block number or 'latest' using eth_getBlockByNumber

## Facts

- Endpoint: GET https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/base_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/base-eth-getblockbynumber-0664b019
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_a9exQkLZm-6PVbF1ST5x9

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 base-eth-getblockbynumber-0664b019
```

Example prompt: Can you grab the latest block from the Base blockchain and show me its block number, timestamp, gas used, and miner address?

## When to prefer this

Use this endpoint when you need full block metadata from the Base L2 network by block number or the latest block. Prefer this over generic Ethereum mainnet block endpoints when your target chain is Base specifically. This endpoint is ideal for agents monitoring Base chain progress, verifying block finality, or extracting block-level on-chain data without running your own node.

## Known failure modes

- Invalid block number format returns an error or null result
- Block number higher than current chain tip returns not-found or null
- Malformed query parameter causes request rejection
- Network or RPC node downtime causes 5xx error
- Payment not provided or insufficient USDC results in 402 Payment Required

## 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 containing full block metadata for the requested Base block, including hash, number, miner, nonce, gas used, gas limit, timestamp, base fee per gas, blob gas used, state root, transactions root, receipts root, logs bloom, parent hash, withdrawals root, and parent beacon block root. The response also indicates the chain ('ethereum'), the method used ('eth_getBlockByNumber'), and a service identifier.

## 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": "base",
  "method": "eth_getBlockByNumber",
  "result": {
   "hash": "0xea00d8455c460589a746efd2ddb95112df516d68f47f41c7247249b5519397d6",
   "size": "0x14e2f",
   "miner": "0x4200000000000000000000000000000000000011",
   "nonce": "0x0000000000000000",
   "number": "0x3245954",
   "uncles": [],
   "gasUsed": "0x20543ad",
   "mixHash": "0x1107a40b1f89981b57fd6f8e24717d0e76cf87525d041987514d3c139405a90f",
   "gasLimit": "0x17d78400",
   "extraData": "0x01000000640000000500000000004c4b40",
   "logsBloom": "0x5ec0c56035693ee7c0495a12f60bfbb6b73dd4f1a02ea3711ae4529f3852ed90b33e8b48b46627a63646c0dfe0ceff9d4a3bbec7dd25e362afc19ee3edb7b708a641fed8847ba50edb87d43dd2a852b4d9430c075a6d1af815d3a39cdf7eff42bae2a0aadaab0cee3f66c9750d872e88c123401219742e",
   "stateRoot": "0xe0df8779fdd9e7b3b0ebb0bf73314f53a093f0812eabfd8420d6537c9b5de8b4",
   "timestamp": "0x6ad30f8b",
   "difficulty": "0x0",
   "parentHash": "0x1fd770bbc4aa41d486f43084897347279410637eb3233f2afa7c6eb4994c0655",
   "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
   "blobGasUsed": "0x49fdb0",
   "withdrawals": [],
   "receiptsRoot": "0xdd340ae2e87543370b59c54eb67043fd0108ed319fef18f5357fee05a3d2e12d",
   "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
   "transactions": [
    "0xd0050c0481165f1b64e8be794aa79b503ba7718d10087982ccf6283477d54d66",
    "0x30a89c4cf89346243822f98da080791feaf5b2b3e1128e530018a6060071ca53"
   ],
   "baseFeePerGas": "0x4c4b40",
   "excessBlobGas": "0x0",
   "withdrawalsRoot": "0xbb0b3c9c1132167b3257e9f50c915d664fce551810ebb0fbfa883441b76ed426",
   "transactionsRoot": "0xf59afdfe8e069e8e60a09c3069da7017829938e90e6cf8bf785bf33b9248fee5",
   "parentBeaconBlockRoot": "0x62515d9866021870f7635c4a8e0ac37fb94e5ac70133aa8a0946a19ba7349239"
  },
  "service": "x402_chain_reads_v1.base_eth_getblockbynumber"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-eth-getblockbynumber-0664b019/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)