# Joe EVM RPC – Block by Number

> Joe EVM RPC – Block by Number is a paid API for AI agents from joe-evm-rpc.marnick-yezo.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Fetches details of a specific EVM block (Base or Ethereum) by block number, hex, or tag such as 'latest'.

## Facts

- Endpoint: GET https://joe-evm-rpc.marnick-yezo.workers.dev/api/chain/block/%7Bnumber%7D
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/joe-evm-rpc-block-by-number-44cdec69
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3nBd7n0r8pdSBIoGxYmh7

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 joe-evm-rpc-block-by-number-44cdec69
```

Example prompt: What are the details of the latest block on Base — hash, timestamp, gas used, and the list of transactions?

## When to prefer this

Choose this endpoint when an AI agent needs lightweight, pay-per-call access to EVM block data on Base or Ethereum without managing RPC keys or infrastructure. It is especially useful for agents operating with x402 micropayment flows on Base, where the $0.001 USDC cost per call is settled programmatically. Prefer it over self-hosted RPC when minimal setup and on-chain payment are priorities.

## Known failure modes

- Invalid block number format returns an error or empty result
- Requesting a block number beyond the current chain tip may return null or an error
- Unsupported network value (not 'base' or 'ethereum') causes a validation error
- Upstream RPC node downtime causes a 5xx or timeout response
- Insufficient USDC payment (x402 protocol) causes a 402 Payment Required rejection

## How this service works

Live Base and Ethereum RPC for AI agents: block tip, balances, transactions, and ENS. $0.001 USDC per call on Base.

## Output

Returns a JSON object with a `data.result` block object containing the block hash, hex-encoded block number, gas used, gas limit, Unix timestamp, parent hash, and an array of transaction hashes included in the block, plus metadata about the network, RPC endpoint used, cost in USDC, and a unique request ID.

## 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"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "pathParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "number"
     ],
     "properties": {
      "number": {
       "type": "string",
       "description": "Block number, hex, or latest|earliest|safe|finalized"
      },
      "network": {
       "enum": [
        "base",
        "ethereum"
       ],
       "type": "string",
       "default": "base",
       "description": "EVM network. Default base."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "result": {
    "hash": "0xabc",
    "number": "0x1",
    "gasUsed": "0x1",
    "gasLimit": "0x1",
    "timestamp": "0x0",
    "parentHash": "0xdef",
    "transactions": [
     "0x1"
    ]
   }
  },
  "meta": {
   "rpc": "https://mainnet.base.org",
   "network": "base",
   "endpoint": "/api/chain/block/{number}",
   "cost_usdc": "0.001",
   "request_id": "00000000abcdef01"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/joe-evm-rpc-block-by-number-44cdec69/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from joe-evm-rpc.marnick-yezo.workers.dev](https://www.zero.xyz/host/joe-evm-rpc.marnick-yezo.workers.dev/llms.txt)