# Base Reads Bundle

> Base Reads Bundle is a paid API for AI agents from api.arysphere.com, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-17).

Returns ETH balance for a Base address and Ethereum mainnet network info (chain ID, block number, gas price) in a single paid API call.

## Facts

- Endpoint: GET https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/base_reads_bundle?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-reads-bundle-daf117ac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Wgyg2jCQ_Otxc70AxqL74

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-reads-bundle-daf117ac
```

Example prompt: What's the current ETH balance for 0x1234567890abcdef1234567890abcdef12345678 on Base, and also give me the latest Ethereum mainnet block number and gas price — all in one shot.

## When to prefer this

Prefer this endpoint when you need both a Base address ETH balance and current Ethereum mainnet network info (gas price, block number, chain status) simultaneously and want to minimize round-trips and total cost. It costs $0.008 for both reads together, which is more efficient than two separate calls. If you only need one of the two data types, use the individual endpoints instead. Ideal for agents doing cross-chain portfolio checks, bridging decisions, or monitoring workflows that require both balance and network state in a single atomic read.

## Known failure modes

- Invalid or malformed address (not matching ^0x[0-9a-fA-F]{40}$) causes a 400 error
- If either sub-service (Base balance or Ethereum network info) fails, the entire bundle call fails — no partial results
- Payment failure or insufficient USDC balance returns 402 Payment Required
- Network timeout or RPC node unavailability on either chain causes the whole call to fail
- Rate limiting may return 429 if called too frequently

## 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 two keyed parts: 'base_eth_getbalance' containing the native ETH balance of the queried address on Base (as both a hex string and a decimal number), and 'network_info_summary' containing Ethereum mainnet data including chain ID, current block number, gas price in wei, block gas used/limit, block timestamp, transaction count, and base fee per gas. The call only succeeds if both parts respond successfully.

## 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": {
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "0x + 40 hex"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "parts": {
   "base_eth_getbalance": {
    "ok": true,
    "hex": "0x0",
    "chain": "base",
    "method": "eth_getBalance",
    "result": 0,
    "service": "x402_chain_reads_v1.base_eth_getbalance"
   },
   "network_info_summary": {
    "ok": true,
    "hex": {
     "eth_chainId": "0x2105",
     "eth_gasPrice": "0x5b8d80",
     "eth_blockNumber": "0x3245954"
    },
    "chain": "base",
    "method": "summary",
    "result": {
     "chain_id": 8453,
     "block_number": 52713812,
     "gas_price_wei": 6000000,
     "block_gas_used": 33899437,
     "block_gas_limit": 400000000,
     "block_timestamp": 1792216971,
     "block_transactions": 190,
     "base_fee_per_gas_wei": 5000000
    },
    "service": "x402_chain_reads_v1.network_info_summary"
   }
  },
  "service": "x402_chain_reads_v1.base_reads_bundle"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-reads-bundle-daf117ac/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)