# Event Logs - eth_getLogs (Base & Ethereum)

> Event Logs - eth_getLogs (Base & Ethereum) is a paid API for AI agents from scanpay-edge.alextaghiashvili.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-01).

Fetches Ethereum/Base contract event logs via eth_getLogs, returning count, block numbers, tx hashes, topics, and data previews with optional topic0 filter.

## Facts

- Endpoint: GET https://scanpay-edge.alextaghiashvili.workers.dev/api/v1/tx-logs?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/event-logs-eth-getlogs-base-ethereum-ff36cae5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cADaW4bgLRZvPxlqW0pOH

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 event-logs-eth-getlogs-base-ethereum-ff36cae5
```

Example prompt: Can you pull the event logs for the USDC contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, filtered by the Transfer topic (0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef), covering the last 2000 blocks?

## When to prefer this

Choose this endpoint when you need lightweight, pay-per-call access to Ethereum or Base contract event logs without managing your own RPC node or API key. It is ideal for agents that need on-demand event log lookups with topic0 filtering and structured JSON output, especially for DeFi monitoring, NFT tracking, or contract debugging. Prefer it over raw RPC calls when you want automatic pricing transparency and don't want to manage node infrastructure.

## Known failure modes

- Invalid or non-checksummed contract address returns an error or empty logs
- Block range too wide may exceed node limits or return truncated results
- Unsupported network (not Base or Ethereum) returns an error
- Invalid topic0 hex string causes a query error
- Payment not completed (x402 flow failure) blocks the request
- Contract with no events in the specified range returns count: 0 and empty logs array

## How this service works

Pay-per-call x402 APIs for AI agents: OpenAI-compatible LLM chat, perp funding and arbitrage spreads, crypto prices, gas, FX, Solana SPL mint audit, token price by contract, x402 delivery-receipt verification, web search, clean page extraction, batch tools and deterministic code-security scanning. USDC on Base or Solana, no signup, no API key, from $0.0001 a call.

## Output

Returns a JSON object containing: total log count, the queried contract address, network name, chain ID, block range (from_block, to_block), price in USD, and an array of log objects each with block_number, tx_hash, log_index, topics array, and data field (hex-encoded).

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "limit": {
       "type": "integer"
      },
      "blocks": {
       "type": "integer"
      },
      "topic0": {
       "type": "string"
      },
      "address": {
       "type": "string"
      },
      "network": {
       "enum": [
        "base",
        "ethereum"
       ],
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "logs": [
   {
    "data": "0x0000000000000000000000000000000000000000000000000000000000000001",
    "topics": [
     "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
    ],
    "tx_hash": "0x834f01e6c76729c794c675897b02457c9ede43101dd93749f07b78001378d8a3",
    "log_index": 0,
    "block_number": 53336036
   }
  ],
  "count": 1,
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "network": "base",
  "product": "scanpay.tx_logs",
  "chain_id": "eip155:8453",
  "to_block": 53336036,
  "price_usd": 0.005,
  "from_block": 53334036
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/event-logs-eth-getlogs-base-ethereum-ff36cae5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from scanpay-edge.alextaghiashvili.workers.dev](https://www.zero.xyz/host/scanpay-edge.alextaghiashvili.workers.dev/llms.txt)