{"uid":"cap_aWBwgAl3-VvQ8acFJUPE6","slug":"ethereum-mainnet-eth-getlogs-event-logs-by-contract-83cd9238","name":"Ethereum Mainnet eth_getLogs (Event Logs by Contract)","description":"","url":"https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/eth_mainnet_getlogs?utm_source=zero.xyz","method":"POST","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":"down","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_bNab-GIj7XPsPkZ4Bol8p","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 Ethereum mainnet event logs for a contract address, optionally filtered by event signature hash and block range (last 1–100 blocks).","exampleAgentPrompt":"Pull the last 50 blocks of event logs for the Ethereum mainnet contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48, filtered to the Transfer event signature 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef.","exampleUseCases":[{"title":"Monitor recent DeFi protocol events","prompt":"Show me the last 100 blocks of on-chain events for the Uniswap V3 pool contract at 0x8ad599c3A0ff1De082011EFDDc58f1908eb6e6D8 on Ethereum mainnet — I want to see everything that was emitted."},{"title":"Track ERC-20 Transfer events","prompt":"Fetch all Transfer event logs from the last 25 blocks for the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48, using topic0 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef."},{"title":"Audit smart contract activity window","prompt":"Get me the raw eth_getLogs entries for the last 10 blocks from the Ethereum contract at 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D so I can see what events it fired recently."}],"resultDescription":"Returns an array of raw eth_getLogs entries from Ethereum mainnet, each containing fields such as address, topics (topic0, topic1, …), data (hex-encoded), blockNumber, transactionHash, logIndex, and removed flag — the unprocessed on-chain event log objects as returned by the Ethereum JSON-RPC.","failureModes":["Invalid contract address format (must be 0x + 40 hex chars) returns a 4xx error","Invalid topic0 format (must be 0x + 64 hex chars) returns a validation error","blocks value out of range (must be 1–100) returns an error","No logs found for the given address/topic/block range returns an empty array","RPC node unavailability or mainnet congestion may cause timeouts","Payment failure or insufficient USDC balance prevents the call ($0.003 per call via x402)"],"whenToPreferThis":"Choose this endpoint when you need raw Ethereum mainnet event log data for a specific contract without setting up your own RPC node or managing API keys — ideal for lightweight on-chain event monitoring, one-off audits, or agent workflows that need recent log history (up to 100 blocks). Prefer it over full node queries when you want a pay-per-use model with no subscription overhead. Not suitable for historical queries spanning thousands of blocks or cross-chain log aggregation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-21T12:25:30.081Z","isFirstParty":false,"canonicalSlug":"ethereum-mainnet-eth-getlogs-event-logs-by-contract-83cd9238"}