{"uid":"cap_BSgzapzTsDXPcksW85CKV","slug":"ethereum-mainnet-eth-getlogs-event-logs-reader-17d71765","name":"Ethereum Mainnet eth_getLogs (Event Logs Reader)","description":"ARYSPHERE sells AI-written verdicts on Base token contracts (a grade, a one-liner, a roast and the contract's facts) and Base/Ethereum chain reads, paid per call in USDC on Base over x402 v2. No account and no API key.","url":"https://api.arysphere.com/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":{"type":"json","example":{"ok":true,"chain":"ethereum","method":"eth_getLogs","result":{"logs":[{"data":"0x0000000000000000000000000000000000000000000000000000000011000a58","topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","0x000000000000000000000000bdb3ba9ffe392549e1f8658dd2630c141fdf47b6"],"address":"0xdac17f958d2ee523a2206206994597c13d831ec7","removed":false,"logIndex":"0x17","blockHash":"0xf88c7d6da7b73bdf869dac8661602de3f98f208d7eb052a1073edd6e5041a363","blockNumber":"0x18ff029","blockTimestamp":"0x6ad30f1b","transactionHash":"0x4c1a6d22ae7677c3c500e5ad82827193dbc4aaf488a6af3c3e7c8ce5e04334a0","transactionIndex":"0x2"},{"data":"0x0000000000000000000000000000000000000000000000000000000002faf080","topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","0x000000000000000000000000924e1b33b1fc3041351b2082ddd11d5c8bcca370"],"address":"0xdac17f958d2ee523a2206206994597c13d831ec7","removed":false,"logIndex":"0x39","blockHash":"0xf88c7d6da7b73bdf869dac8661602de3f98f208d7eb052a1073edd6e5041a363","blockNumber":"0x18ff029","blockTimestamp":"0x6ad30f1b","transactionHash":"0x6cb83f77e12d2b4be5980a47bcfd0f3a24a3743cbc49775a323172f539610a5f","transactionIndex":"0x8"}],"count":1394,"to_block":26210354,"truncated":true,"from_block":26210345},"service":"x402_eth_reads_v1.eth_mainnet_eth_getlogs"}},"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_G9mmygxgxlHLWQNa-40Kd","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 from an Ethereum mainnet smart contract, filtered by event topic and block range.","exampleAgentPrompt":"Pull the last 20 blocks of Transfer event logs from the Ethereum mainnet contract at 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913, filtering by topic0 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef.","exampleUseCases":[{"title":"Monitor ERC-20 token transfer activity","prompt":"Fetch me the last 50 blocks of Transfer event logs from the USDC contract on Ethereum mainnet at 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48, using topic0 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef."},{"title":"Debug a smart contract deployment","prompt":"I just deployed a contract on Ethereum mainnet at 0x1234567890abcdef1234567890abcdef12345678 — can you grab all event logs from the last 10 blocks so I can verify it's emitting events correctly?"},{"title":"Track DeFi protocol swap events","prompt":"Get me the last 30 blocks of Swap event logs from the Uniswap V3 pool at 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 on Ethereum mainnet, filtering by the Swap topic0 hash 0xc42079f94a6350d7e6235f29174924f928cc2ac818eb64fed8004e115fbcca67."}],"resultDescription":"A JSON object containing an array of raw event log entries, each with fields including address, topics, data, blockNumber, blockHash, transactionHash, transactionIndex, logIndex, blockTimestamp, and removed flag. Also includes metadata: total count, from_block, to_block, truncated flag, chain, and method name.","failureModes":["Invalid contract address format (not 0x + 40 hex) returns a validation error","Invalid topic0 hash format (not 0x + 64 hex) returns a validation error","Block range out of bounds (N < 1 or N > 100) returns a validation error","No logs found for the given filters returns an empty logs array","RPC node timeout or Ethereum mainnet connectivity issue returns a 5xx error","Payment failure or insufficient USDC balance returns a 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need to read raw smart contract event logs from Ethereum mainnet using eth_getLogs, particularly when you want to filter by a specific event signature (topic0) and limit the range to the most recent N blocks. Prefer it over Base or Gnosis siblings when your contract is deployed on Ethereum mainnet. It is well-suited for monitoring ERC-20 transfers, DEX swaps, or any EVM event without needing to decode or index the data yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T12:40:52.233Z","isFirstParty":false,"canonicalSlug":"ethereum-mainnet-eth-getlogs-event-logs-reader-17d71765"}