{"uid":"cap_9HEUlS1njZomy-6JQ6WE_","slug":"evm-event-logs-by-contract-topic-and-block-range-d483d21c","name":"EVM Event Logs by Contract, Topic, and Block Range","description":"Event logs filtered by contract, topic and block range — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/evm-logs?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"chain":{"enum":["ethereum","base","polygon","arbitrum","optimism","bsc","avalanche","gnosis","linea","scroll"],"type":"string"},"topic0":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"toBlock":{"type":"string"},"fromBlock":{"type":"string"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"evm-logs","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.006,"receipt_id":"g402-<16hex>"},"generated_at":"<iso8601>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_W3Dmys65ndSNleDf5fBqS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves on-chain event logs filtered by smart contract address, topic hash, and block range across 10 EVM-compatible chains.","exampleAgentPrompt":"Pull all Transfer event logs (topic0 0xddf252ad1be2c89b69c2b068fc378daa952ba7f204e10000000000000000003e) for the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum from block 19000000 to 19001000.","exampleUseCases":[{"title":"DeFi swap event audit","prompt":"Get all Swap events (topic0 0xd78ad95fa46c994b6551d0da85fc275fe613ce37657fb8d5e3d130840159d822) from the Uniswap V2 USDC/ETH pool at 0xB4e16d0168e52d35CaCD2c6185b44281Ec28C9Dc on Ethereum between blocks 18500000 and 18510000."},{"title":"ERC-20 token transfer history","prompt":"Fetch all Transfer events for the DAI token contract at 0x6B175474E89094C44Da98b954EedeAC495271d0F on Polygon from block 50000000 to 50050000 — I need to see every transfer that happened in that window."},{"title":"DAO governance event monitoring","prompt":"Retrieve all ProposalCreated events (topic0 0x7d84a6263ae0d98d3329bd7b46bb4e8d6f98cd35a7adb45c274c8b7fd5ebd5e0) from the Compound Governor contract at 0xc0Da02939E1441F497fd74F78cE7Decb17B66529 on Ethereum between blocks 17000000 and 17100000."}],"resultDescription":"Returns a JSON object with ok status, event log data for the matched logs, a payment receipt containing transaction hash, USD amount charged, and a receipt ID, plus a generated_at ISO8601 timestamp.","failureModes":["Invalid contract address format (must be 0x + 40 hex chars) returns validation error","Invalid topic0 hash format (must be 0x + 64 hex chars) returns validation error","Unsupported chain name returns enum validation error","Block range too large may time out or return partial results","No matching logs in the specified range returns empty log array","Payment failure (insufficient USDC balance) blocks request execution"],"whenToPreferThis":"Choose this endpoint when you need on-chain EVM event logs filtered precisely by contract address, topic hash, and block range across any of 10 supported chains without running your own node. It is ideal for agents doing DeFi analytics, token transfer audits, DAO governance monitoring, or any task requiring historical smart contract events. Prefer it over general-purpose RPC providers when you want a pay-per-call model without API key management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:55:43.786Z","isFirstParty":false,"canonicalSlug":"evm-event-logs-by-contract-topic-and-block-range-d483d21c"}