# ETH Mainnet ETH Logs

> ETH Mainnet ETH Logs is a paid API for AI agents from ari001.tailb4ac3a.ts.net, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-13).

Fetches Ethereum mainnet contract event logs for a given contract address using eth_getLogs, optionally filtered by event signature and block range

## Facts

- Endpoint: GET https://ari001.tailb4ac3a.ts.net/v1/ventures/x402_eth_reads_v1/eth_mainnet_eth_getlogs?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eth-mainnet-eth-logs-809d0b66
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ebUz_QJf2OhF5FScAVbyL

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 eth-mainnet-eth-logs-809d0b66
```

Example prompt: Pull the last 20 blocks of event logs from the Ethereum mainnet contract at 0xdAC17F958D2ee523a2206206994597C13D831ec7, filtering for topic0 0xddf252ad1be2c89b69c2b068fc378daa952ba7f56d11cc0f76b8a9c1e1e38a7c (ERC-20 Transfer events).

## When to prefer this

Choose this endpoint when you need raw Ethereum mainnet contract event logs (eth_getLogs) filtered by contract address and optionally by event signature, especially for real-time or near-real-time on-chain event monitoring. Prefer this over full transaction lookup endpoints when you care about emitted events rather than transaction details, and over Base-chain endpoints when the contract you're targeting is deployed on Ethereum mainnet specifically.

## Known failure modes

- Invalid contract address format (not 0x + 40 hex) returns a validation error
- Invalid topic0 format (not 0x + 64 hex) returns a validation error
- Blocks parameter out of range (0 or >100) returns an error
- Contract address with no logs in the requested block range returns an empty array
- RPC node unavailability or timeout on Ethereum mainnet may cause failed responses
- Payment failure (insufficient USDC balance for $0.003 fee) blocks the request

## How this service works

Ethereum mainnet contract event logs via eth_getLogs. Query parameters: address (contract, 0x + 40 hex), topic0 (optional event signature hash, 0x + 64 hex), blocks (optional, last N blocks, 1-100, default 10). Base RPC read of an address, block or transaction.

## Output

Returns a list of Ethereum event log objects for the specified contract address, each containing the block number, transaction hash, log index, emitted topics (including topic0 through topic3), and raw data payload, covering the requested number of recent blocks (default 10, max 100).

## 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": {
      "blocks": {
       "type": "string",
       "description": "optional, last N blocks, 1-100 (default 10)"
      },
      "topic0": {
       "type": "string",
       "description": "optional event signature hash, 0x + 64 hex"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "contract, 0x + 40 hex"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eth-mainnet-eth-logs-809d0b66/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ari001.tailb4ac3a.ts.net](https://www.zero.xyz/host/ari001.tailb4ac3a.ts.net/llms.txt)