# Gnosis Chain Event Logs (eth_getLogs)

> Gnosis Chain Event Logs (eth_getLogs) 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 raw event logs from a Gnosis Chain smart contract address, filtered by topic and block range, using eth_getLogs.

## Facts

- Endpoint: GET https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/gnosis_eth_getlogs?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/gnosis-chain-event-logs-eth-getlogs-9fd81436
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bgeUP_a8c_dgqRQgPnpEr

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 gnosis-chain-event-logs-eth-getlogs-9fd81436
```

Example prompt: Can you pull the last 20 blocks of Transfer event logs from the Gnosis Chain contract at 0x9C58BAcC331c9aa871AFD802DB6379a98e80CEdb, filtering by the ERC-20 Transfer topic 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef?

## When to prefer this

Use this endpoint when you need raw on-chain event logs specifically from the Gnosis Chain (xDai) network for a known contract address. Prefer this over Ethereum or Base equivalents when the contract is deployed on Gnosis Chain. Ideal for monitoring token transfers, DeFi events, or any contract-emitted events in a recent block window without needing to run your own node.

## Known failure modes

- Invalid contract address format (not 0x + 40 hex) returns validation error
- Invalid topic0 format (not 0x + 64 hex) returns validation error
- Blocks parameter out of range (must be 1-100) returns error
- Contract address with no events in the requested block range returns empty logs array
- RPC node unavailability or Gnosis Chain congestion may cause timeout
- Payment of 0.003 USDC via x402 protocol required; missing or invalid payment returns 402

## 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 an array of raw event log entries, each with fields including address, topics, data, blockNumber, blockHash, blockTimestamp, transactionHash, transactionIndex, logIndex, and removed flag. Also includes count of total matching logs, from_block, to_block, and a truncated flag indicating whether the result was capped.

## 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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "chain": "gnosis",
  "method": "eth_getLogs",
  "result": {
   "logs": [
    {
     "data": "0x00000000000000000000000000000000000000000000000000000000002333a8",
     "topics": [
      "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      "0x0000000000000000000000007f90122bf0700f9e7e1f688fe926940e8839f353"
     ],
     "address": "0xddafbb505ad214d7b80b1f830fccc89b60fb7a83",
     "removed": false,
     "logIndex": "0x3",
     "blockHash": "0xd8f60070c47b0aebf5c1a1048e7218cba3060604c73bf6931d3c5f48e8733b5e",
     "blockNumber": "0x2e89bea",
     "blockTimestamp": "0x6ad30f7b",
     "transactionHash": "0x88f237062d07deb3ac426d697631d89a86860b8aa0746822c155e7c77b8a5574",
     "transactionIndex": "0x0"
    },
    {
     "data": "0x00000000000000000000000000000000000000000000000000000000002333a8",
     "topics": [
      "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      "0x000000000000000000000000b45373129b4220160b92bd2320869f44d48ecd01"
     ],
     "address": "0xddafbb505ad214d7b80b1f830fccc89b60fb7a83",
     "removed": false,
     "logIndex": "0x6",
     "blockHash": "0xd8f60070c47b0aebf5c1a1048e7218cba3060604c73bf6931d3c5f48e8733b5e",
     "blockNumber": "0x2e89bea",
     "blockTimestamp": "0x6ad30f7b",
     "transactionHash": "0x88f237062d07deb3ac426d697631d89a86860b8aa0746822c155e7c77b8a5574",
     "transactionIndex": "0x0"
    }
   ],
   "count": 2,
   "to_block": 48798701,
   "truncated": false,
   "from_block": 48798692
  },
  "service": "x402_chain_reads_v1.gnosis_eth_getlogs"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gnosis-chain-event-logs-eth-getlogs-9fd81436/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)