{"uid":"cap_6lMZidTIAuLO4xLVUW-Go","slug":"evm-event-logs-reader-516146df","name":"EVM Event Logs Reader","description":"Read a contract's recent event logs on an EVM network over a bounded block window and decode them. Logs are decoded from an event signature you supply, or from the contract's verified ABI, or by resolving the topic to a name via 4byte. Raw logs are always returned; decoded fields are added where possible.","url":"https://payai.agentstools.dev/evm/logs?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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","required":["address"],"properties":{"limit":{"type":"integer","maximum":200,"minimum":1,"description":"Max decoded logs to return (default 200)"},"blocks":{"type":"integer","maximum":10000,"minimum":1,"description":"Look-back window in blocks (default 2000)"},"topic0":{"type":"string","description":"Event topic0 hash to filter by (alternative to signature), 0x + 64 hex"},"address":{"type":"string","description":"Contract address, 0x + 40 hex"},"network":{"enum":["base","ethereum","arbitrum","optimism","polygon","bnb"],"type":"string","description":"EVM network (default base)"},"signature":{"type":"string","description":"Event signature to filter and decode by, e.g. Transfer(address,address,uint256)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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":{"p10Cents":"1.0000","medianCents":"1.0000","p90Cents":"1.0000","minCents":"1.0000","maxCents":"1.0000","p95Cents":"1.0000","sampleCount":1,"varies":false,"failureChargeRate":1},"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_ayuckovjiCVUhqZXTHx84","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 and decodes recent event logs from a smart contract on an EVM-compatible blockchain over a configurable block window","exampleAgentPrompt":"Pull the last 500 blocks of Transfer events from the contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum and decode them using the signature Transfer(address,address,uint256).","exampleUseCases":null,"resultDescription":"Returns a list of raw event log objects (block number, transaction hash, log index, topics, data) with decoded fields appended where possible — either from the supplied event signature, the contract's verified ABI, or 4byte topic resolution. Both raw and decoded representations are included.","failureModes":["Invalid contract address format returns an error","Unsupported network name returns a validation error","Block window exceeding 10000 blocks is rejected","Topic0 hash in wrong format (not 0x + 64 hex) fails validation","No logs found in the window returns an empty list","Contract has no verified ABI and topic cannot be resolved via 4byte — raw logs returned without decoding","Rate limit or payment failure returns a 402 error"],"whenToPreferThis":"Use this endpoint when you need to read historical or recent on-chain event logs from a specific smart contract on a major EVM network (Base, Ethereum, Arbitrum, Optimism, Polygon, BNB), especially when you want automatic decoding via event signature or ABI. Prefer this over raw RPC calls when you want decoded fields returned alongside raw logs without manual ABI management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:42:47.557Z","isFirstParty":false,"canonicalSlug":"evm-event-logs-reader-516146df"}