{"uid":"cap_Jyk1IgTRPeqiT3bkKb9rL","slug":"chain-openverbs-com-eth-getlogs-contract-event-logs-e0727f8e","name":"chain.openverbs.com – eth_getLogs Contract Event Logs","description":"Query a contract's event logs over a bounded block range via `eth_getLogs`: filter by `address` (required) and optional `topics`, get back raw logs (topics, data, block, tx hash, log index) with ERC-20/721 Transfer logs auto-decoded to `{from, to, value}`. Block span is capped (large windows are clamped); results are capped by `limit`. Reads live on-chain data with automatic endpoint fallback.","url":"https://chain.openverbs.com/v1/logs","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{"chain":{"enum":["ethereum","base","arbitrum","optimism","polygon"],"type":"string","description":"EVM chain to query. One of: ethereum, base, arbitrum, optimism, polygon. Default \"ethereum\"."},"limit":{"type":"integer","maximum":5000,"minimum":1,"description":"Max logs to return (default 1000)."},"topics":{"type":"array","items":{"type":["string","null"],"pattern":"^0x[0-9a-fA-F]{64}$"},"maxItems":4,"description":"Optional topic filters (topic0 = event signature hash). Up to 4; null matches any."},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Contract address to query logs for (required — bounds the query)."},"toBlock":{"type":["string","integer"],"description":"End block (decimal or 0x-hex) or \"latest\" (default). Max 5000-block span."},"fromBlock":{"type":["string","integer"],"description":"Start block (decimal or 0x-hex; not a tag)."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"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_dYM060NZ46UdaoAye-9em","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":"Fetches raw and auto-decoded event logs for a specific contract address over a bounded block range on EVM chains, with optional topic filtering.","exampleAgentPrompt":"Pull the last 500 Transfer event logs from the USDC contract (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) on Ethereum, filtering by the Transfer event signature hash as topic0.","exampleUseCases":[{"title":"Track ERC-20 token transfers","prompt":"Get me the last 1000 Transfer events from the USDT contract at 0xdAC17F958D2ee523a2206206994597C13D831ec7 on Ethereum, from block 19000000 to latest, so I can see who's been moving tokens around."},{"title":"Monitor NFT mints on Base","prompt":"Fetch the event logs for the NFT contract 0x1234567890abcdef1234567890abcdef12345678 on Base from block 12500000 to 12505000, filtering by the Transfer topic to catch any mints or transfers."},{"title":"Audit contract activity on Arbitrum","prompt":"Pull up to 2000 raw event logs for the Uniswap V3 pool contract 0xC31E54c7a869B9FcBEcc14363CF510d1c41fa443 on Arbitrum between blocks 150000000 and 150005000 so I can audit recent swap and liquidity events."}],"resultDescription":"Returns an array of log objects, each containing: topics array (raw 32-byte hex), data field, block number, transaction hash, log index, and contract address. ERC-20/721 Transfer logs are automatically decoded into a structured {from, to, value} object alongside the raw data. Results are capped by the limit parameter and block span is clamped to a maximum window.","failureModes":["Invalid or missing contract address returns a validation error","Block range exceeding the cap is clamped silently — results may not cover the full requested range","No logs found in range returns an empty array","Invalid topic hex format (not 0x + 64 hex chars) causes a schema validation error","Unsupported chain name causes an enumeration error","Very high limit values are capped at 5000","RPC endpoint failures trigger automatic fallback but may cause latency spikes"],"whenToPreferThis":"Choose this endpoint when you need to retrieve historical or recent on-chain event logs for a specific contract on EVM chains (Ethereum, Base, Arbitrum, Optimism, Polygon), especially when you want automatic decoding of ERC-20/721 Transfer events. Prefer this over general blockchain APIs when you need topic-filtered, bounded log queries with automatic endpoint fallback and a simple REST interface rather than a full RPC node.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:30:06.296Z","isFirstParty":false}