{"uid":"cap_MSTuT38q4VSvlvVBOFb6d","slug":"base-contract-event-logs-reader-6f790348","name":"Base Contract Event Logs Reader","description":"Recent event logs for any contract on Base over a bounded recent window (reads eth_getLogs). Optionally filter by topic0 (event signature hash). Returns up to 50 logs with block, tx hash, topics and data. Window is limited by the RPC log-range quota. Use this for generic event queries not covered by whale-wallet-tracker or token-deploy-radar.","url":"https://auditor-x402.onrender.com/api/contract-logs?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"topic0":{"type":"string","description":"Optional 32-byte event signature hash (0x...) to filter by"},"address":{"type":"string","description":"Contract address (0x...) to read logs from"},"windowBlocks":{"type":"number","description":"Blocks to scan (10-120, default 100)"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_H7Q2BXdJ7pZSbm0oKX06F","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches recent event logs (via eth_getLogs) for any contract on Base, with optional topic0 filtering, returning up to 50 logs with block, tx hash, topics, and data.","exampleAgentPrompt":"Can you pull the recent event logs for the contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Base, filtering by the Transfer event signature hash 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef, scanning the last 100 blocks?","exampleUseCases":[{"title":"Audit recent DeFi protocol activity","prompt":"Show me the last 100 blocks of event logs for the Aave lending pool at 0x794a61358D6845594F94dc1DB02A252b5b4814aD on Base — I want to see everything that happened recently."},{"title":"Track ERC-20 Transfer events","prompt":"Get all Transfer events from the USDC contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base over the past 50 blocks — use the Transfer topic 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef."},{"title":"Investigate suspicious contract behavior","prompt":"Can you pull the event logs for this contract at 0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD on Base for the last 120 blocks? I want to see if anything unusual was emitted recently."}],"resultDescription":"Returns up to 50 recent event log entries, each containing block number, transaction hash, log index, topics array (including topic0 through topic3), and raw data hex — all scoped to the specified contract address within the requested block window.","failureModes":["RPC log-range quota exceeded if windowBlocks is too large or contract is too active","Invalid contract address returns empty logs or error","Malformed topic0 hash causes filter to fail or return no results","Block window outside allowed range (10-120) rejected","Render.com cold start may cause initial latency or timeout","No logs found returns empty array (not an error, but may confuse agent)"],"whenToPreferThis":"Use this endpoint when you need generic event log queries for any Base contract not covered by specialized endpoints like whale-wallet-tracker or token-deploy-radar. Ideal when you know the contract address and optionally the event signature hash, and want raw log data including topics and calldata. Prefer this over full indexers when you only need a recent bounded window and don't need historical depth beyond 120 blocks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:04:57.046Z","isFirstParty":false,"canonicalSlug":"base-contract-event-logs-reader-6f790348"}