{"uid":"cap_ebUz_QJf2OhF5FScAVbyL","slug":"eth-mainnet-eth-logs-809d0b66","name":"ETH Mainnet ETH Logs","description":"Ethereum mainnet contract event logs via eth_getLogs. Query parameters: address (contract, 0x + 40 hex), topic0 (optional event signature hash, 0x + 64 hex), blocks (optional, last N blocks, 1-100, default 10). Base RPC read of an address, block or transaction.","url":"https://ari001.tailb4ac3a.ts.net/v1/ventures/x402_eth_reads_v1/eth_mainnet_eth_getlogs?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","properties":{"blocks":{"type":"string","description":"optional, last N blocks, 1-100 (default 10)"},"topic0":{"type":"string","description":"optional event signature hash, 0x + 64 hex"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"contract, 0x + 40 hex"}}}},"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_CajB8jMPWT4CWcBWoK8hL","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 Ethereum mainnet contract event logs for a given contract address using eth_getLogs, optionally filtered by event signature and block range","exampleAgentPrompt":"Pull the last 20 blocks of event logs from the Ethereum mainnet contract at 0xdAC17F958D2ee523a2206206994597C13D831ec7, filtering for topic0 0xddf252ad1be2c89b69c2b068fc378daa952ba7f56d11cc0f76b8a9c1e1e38a7c (ERC-20 Transfer events).","exampleUseCases":[{"title":"Monitor DeFi protocol contract events","prompt":"Get me the last 50 blocks of logs from the Uniswap V2 pair contract at 0xB4e16d0168e52d35CaCD2c6185b44281Ec28C9Dc on Ethereum mainnet so I can see recent Swap events."},{"title":"Track ERC-20 Transfer events on-chain","prompt":"Fetch all Transfer event logs from the USDT contract at 0xdAC17F958D2ee523a2206206994597C13D831ec7 on Ethereum mainnet for the last 10 blocks, filtering by topic0 0xddf252ad1be2c89b69c2b068fc378daa952ba7f56d11cc0f76b8a9c1e1e38a7c."},{"title":"Audit recent smart contract activity","prompt":"Can you pull the last 100 blocks of event logs from the Ethereum contract at 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D so I can audit what events it's been emitting?"}],"resultDescription":"Returns a list of Ethereum event log objects for the specified contract address, each containing the block number, transaction hash, log index, emitted topics (including topic0 through topic3), and raw data payload, covering the requested number of recent blocks (default 10, max 100).","failureModes":["Invalid contract address format (not 0x + 40 hex) returns a validation error","Invalid topic0 format (not 0x + 64 hex) returns a validation error","Blocks parameter out of range (0 or >100) returns an error","Contract address with no logs in the requested block range returns an empty array","RPC node unavailability or timeout on Ethereum mainnet may cause failed responses","Payment failure (insufficient USDC balance for $0.003 fee) blocks the request"],"whenToPreferThis":"Choose this endpoint when you need raw Ethereum mainnet contract event logs (eth_getLogs) filtered by contract address and optionally by event signature, especially for real-time or near-real-time on-chain event monitoring. Prefer this over full transaction lookup endpoints when you care about emitted events rather than transaction details, and over Base-chain endpoints when the contract you're targeting is deployed on Ethereum mainnet specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:30:08.086Z","isFirstParty":false,"canonicalSlug":"eth-mainnet-eth-logs-809d0b66"}