{"uid":"cap_47EZuFSEkKv2YoDMdlfUp","slug":"ethereum-contract-event-log-reader-724a3634","name":"Ethereum Contract Event Log Reader","description":"Recent contract event logs on Ethereum (eth_getLogs): the events a contract emitted over the last N blocks (1-1,000, default 50), optionally filtered by topic0 (the 0x 32-byte event signature hash). Returns up to 100 logs with block, transaction hash and topics. Use to watch transfers or contract events; for one transaction's outcome use eth_receipt.","url":"https://agent-data-tools.revmesh2074.workers.dev/eth/logs?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["address"],"properties":{"blocks":{"type":"integer","description":"How many recent blocks to scan (1-1000, default 50)"},"topic0":{"type":"string","description":"Optional 0x event signature hash to filter by"},"address":{"type":"string","description":"0x contract address"}}},"responseSchema":{"type":"object","properties":{"logs":{"type":"array","items":{"type":"object","properties":{"tx":{"type":"string"},"data":{"type":"string"},"block":{"type":"number"},"topics":{"type":"array","items":{"type":"string"}},"logIndex":{"type":"number"}}}},"chain":{"type":"string"},"count":{"type":"number"},"address":{"type":"string"},"chainId":{"type":"number"},"toBlock":{"type":"number"},"fromBlock":{"type":"number"},"truncated":{"type":"boolean"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2NYPooOD2wiKKzItZzXLE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches recent on-chain event logs for a given Ethereum contract address, with optional topic filtering and block range control","exampleAgentPrompt":"Pull the last 100 blocks of event logs for the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum, filtered to Transfer events using topic0 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef.","exampleUseCases":[{"title":"Monitor ERC-20 Transfer activity","prompt":"Show me the last 200 blocks of Transfer event logs from the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 — filter by topic0 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef so I only get Transfer events."},{"title":"Audit recent DEX pool swaps","prompt":"Fetch the last 50 blocks of on-chain logs for the Uniswap v3 USDC/ETH pool at 0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640 so I can see what swap events have been emitted."},{"title":"Debug smart contract events after deploy","prompt":"Get me all event logs from the contract I just deployed at 0x1234567890abcdef1234567890abcdef12345678 over the last 10 blocks so I can confirm the right events were fired."}],"resultDescription":"Returns a JSON object containing an array of log entries (each with transaction hash, raw data, block number, topics array, and log index), plus metadata: chain name, chain ID, from/to block range, contract address, total count, and a truncated flag indicating if results were capped.","failureModes":["Invalid or malformed contract address returns an error","Block range outside 1-1000 bounds rejected","Invalid topic0 hash format causes filter failure","Contract with no logs in the scanned range returns empty array","RPC node unavailability may cause transient failures","Very high-activity contracts may return truncated=true with partial results"],"whenToPreferThis":"Choose this endpoint when you need raw, unindexed event log data directly from the Ethereum chain without needing a full indexing service like The Graph. Ideal for lightweight, ad-hoc log queries against a known contract address over recent blocks. Best for agents that need fresh, real-time log data and can pay $0.001 per call with no API key setup. Not suited for deep historical queries spanning thousands of blocks or complex multi-contract log aggregation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:44:50.440Z","isFirstParty":false,"canonicalSlug":"ethereum-contract-event-log-reader-724a3634"}