{"uid":"cap_shHQc1EHhWStm79eVKiZx","slug":"agentshelf-ethereum-event-log-fetcher-646c38df","name":"Agentshelf Ethereum Event Log Fetcher","description":"Call when an agent needs raw Ethereum logs for one contract, with optional topic0-topic3, a block range of at most 2000, and an optional event signature for decoding. HTTP 429 is not billed. Read-only. No spend. Send JSON fields address (string), topic0 (string), event (string). Exact $0.005 USDC on Base. Try unpaid POST /v1/sandbox/eth-events first.","url":"https://agentshelf.syntexa.ch/v1/eth-events?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"event":{"type":"string","pattern":"^[A-Za-z_][A-Za-z0-9_]*\\([A-Za-z0-9_,\\s]*\\)$","examples":["Transfer(address indexed from, address indexed to, uint256 value)"],"maxLength":300,"description":"Optional Solidity event signature. Example: Transfer(address indexed from, address indexed to, uint256 value). topic0 defaults to its keccak. Arrays are not decoded."},"topic0":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","examples":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"],"description":"First log topic, 32 bytes of hex. Example: 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef is ERC-20 Transfer. Omit it for a wildcard in that position."},"topic1":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"Second log topic, 32 bytes of hex. Example: 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef is ERC-20 Transfer. Omit it for a wildcard in that position."},"topic2":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"Third log topic, 32 bytes of hex. Example: 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef is ERC-20 Transfer. Omit it for a wildcard in that position."},"topic3":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"Fourth log topic, 32 bytes of hex. Example: 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef is ERC-20 Transfer. Omit it for a wildcard in that position."},"address":{"type":"string","examples":["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"],"description":"Contract on Ethereum mainnet. Example: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 (Circle USDC). Logs are filtered to this address. EIP-55 or all one case."},"to_block":{"type":"string","description":"Last block, inclusive, or latest. The inclusive span is at most 2000 blocks. Omit both bounds for the latest 25 blocks. Omit it to anchor the default window."},"from_block":{"type":"string","pattern":"^(0|[1-9]\\d*)$","description":"First block, inclusive. The inclusive span is at most 2000 blocks. Omit both bounds for the latest 25 blocks. Omit both bounds for the default recent window."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MRqUIF3h4gRJ8A6Jr0l0L","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches raw Ethereum event logs for a specific contract address with optional topic filtering and ABI-based decoding over a block range of up to 2000 blocks.","exampleAgentPrompt":"Can you pull all ERC-20 Transfer events for the USDC contract (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) from block 20000000 to 20002000, using the event signature Transfer(address indexed from, address indexed to, uint256 value)?","exampleUseCases":[{"title":"Track ERC-20 token transfers","prompt":"Fetch all Transfer events emitted by the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 from block 19500000 to 19502000, decode them using Transfer(address indexed from, address indexed to, uint256 value)."},{"title":"Monitor Uniswap pool swaps","prompt":"Get raw Swap event logs from the Uniswap V3 WETH/USDC pool at 0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640 for the last 2000 blocks, filtering by topic0 0xc42079f94a6350d7e6235f29174924f928cc2ac818eb64fed8004e115fbcca67."},{"title":"Audit NFT ownership changes","prompt":"Pull all ERC-721 Transfer logs for the Bored Ape Yacht Club contract at 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D from block 19800000 to 19802000 so I can see which NFTs changed hands."}],"resultDescription":"Returns an array of raw Ethereum log objects, each containing block number, transaction hash, log index, address, topics array, and raw data field. If an event signature is supplied, decoded parameter values are also included alongside each log entry.","failureModes":["Block range exceeds 2000 blocks — returns an error asking you to narrow the range","Invalid address format (not EIP-55 or consistent case) — returns a validation error","Invalid topic format (not 0x-prefixed 32-byte hex) — returns a validation error","No logs found in the specified range — returns an empty array","Ethereum node unavailable or congested — returns a 5xx error","HTTP 429 rate limit — not billed, request can be retried","Malformed event signature not matching pattern — returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need raw or decoded Ethereum event logs for a specific contract without setting up your own Ethereum node or indexer. It is ideal for targeted, time-bounded queries (up to 2000 blocks) where you know the contract address and optionally the event signature or topic hashes. Prefer the free sandbox endpoint (/v1/sandbox/eth-events) for testing before spending $0.005 USDC per call on production queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-26T07:01:54.487Z","isFirstParty":false,"canonicalSlug":"agentshelf-ethereum-event-log-fetcher-646c38df"}