{"uid":"cap_8XsoEdZHSvvdR7j0sjv8W","slug":"contract-event-logs-3fc41cd1","name":"Contract Event Logs","description":"Event logs a contract emitted (eth_getLogs), filtered by event signature such as Transfer(address,address,uint256) or a topic hash, over a block range (max 5,000 blocks, default last 100). Use to monitor swaps, mints or governance.","url":"https://bess-x402.onrender.com/v1/evm/events?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":{"chain":{"type":"string","description":"ethereum, base, arbitrum, optimism or polygon"},"event":{"type":"string","description":"Event signature or topic hash"},"limit":{"type":"integer","description":"Maximum number of results (1-500)"},"address":{"type":"string","description":"Contract address"},"to_block":{"type":"string","description":"End block (default latest)"},"from_block":{"type":"string","description":"Start block"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__SBmyP6az5NdlxZWpICC1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches raw event logs emitted by an EVM smart contract over a block range, filtered by event signature or topic hash","exampleAgentPrompt":"Can you pull all Transfer events emitted by the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum over the last 500 blocks, up to 200 results?","exampleUseCases":[{"title":"Monitor DEX swap activity","prompt":"Fetch all Swap events from the Uniswap v3 WETH/USDC pool at 0x8ad599c3A0ff1De082011EFDDc58f1908eb6e6D8 on Ethereum over the last 2000 blocks, limit 500 results."},{"title":"Track NFT mints on Base","prompt":"Get all Transfer events where the sender is the zero address for the NFT contract 0xd4307E0D0A41e856E3aBf96Ad24c6bC5f6D04F4f on Base from block 10000000 to block 10005000."},{"title":"Audit DAO governance proposals","prompt":"Pull all ProposalCreated events from the Compound Governor contract at 0xc0Da02939E1441F497fd74F78cE7Decb17B66529 on Ethereum over the last 5000 blocks so I can see recent governance activity."}],"resultDescription":"Returns a list of raw event log objects emitted by the specified contract, each including transaction hash, block number, log index, topics array (with the event signature hash and indexed parameters), and the raw data field for non-indexed parameters. Results are bounded by the requested block range (max 5,000 blocks) and limit (1–500).","failureModes":["Block range exceeds 5,000 blocks — returns error indicating range limit","Invalid or non-checksummed contract address — returns bad request error","Unsupported chain name — returns error with supported chain list","No logs found in range — returns empty results array","Invalid event signature format — returns filter error","Rate limit or payment failure — returns 402 payment required"],"whenToPreferThis":"Choose this endpoint when you need raw event logs from a specific smart contract on Ethereum, Base, Arbitrum, Optimism, or Polygon, especially when filtering by a known event signature like Transfer, Swap, or Mint. It is ideal for monitoring DeFi protocol activity, tracking token transfers, auditing governance events, or triggering agent workflows based on on-chain state changes. Prefer it over full-node RPC calls when you want a simple REST interface without managing Web3 infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T12:33:32.417Z","isFirstParty":false,"canonicalSlug":"contract-event-logs-3fc41cd1"}