{"uid":"cap_cADaW4bgLRZvPxlqW0pOH","slug":"event-logs-eth-getlogs-base-ethereum-ff36cae5","name":"Event Logs - eth_getLogs (Base & Ethereum)","description":"Pay-per-call x402 APIs for AI agents: OpenAI-compatible LLM chat, perp funding and arbitrage spreads, crypto prices, gas, FX, Solana SPL mint audit, token price by contract, x402 delivery-receipt verification, web search, clean page extraction, batch tools and deterministic code-security scanning. USDC on Base or Solana, no signup, no API key, from $0.0001 a call.","url":"https://scanpay-edge.alextaghiashvili.workers.dev/api/v1/tx-logs?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"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"limit":{"type":"integer"},"blocks":{"type":"integer"},"topic0":{"type":"string"},"address":{"type":"string"},"network":{"enum":["base","ethereum"],"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"logs":[{"data":"0x0000000000000000000000000000000000000000000000000000000000000001","topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"],"tx_hash":"0x834f01e6c76729c794c675897b02457c9ede43101dd93749f07b78001378d8a3","log_index":0,"block_number":53336036}],"count":1,"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"base","product":"scanpay.tx_logs","chain_id":"eip155:8453","to_block":53336036,"price_usd":0.005,"from_block":53334036}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SAqBI76_fMGnC72A9EMeO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches Ethereum/Base contract event logs via eth_getLogs, returning count, block numbers, tx hashes, topics, and data previews with optional topic0 filter.","exampleAgentPrompt":"Can you pull the event logs for the USDC contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, filtered by the Transfer topic (0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef), covering the last 2000 blocks?","exampleUseCases":[{"title":"Monitor ERC-20 Transfer events on Base","prompt":"Get me all Transfer event logs for the USDC token contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base between blocks 53334000 and 53336000, filtered by topic0 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef."},{"title":"Debug DeFi contract event history","prompt":"I need to inspect the raw event logs emitted by the Uniswap v3 pool contract 0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640 on Ethereum mainnet for the last 500 blocks — show me the topics, tx hashes, and data for each log."},{"title":"Count NFT mint events in a block range","prompt":"How many mint events did the NFT contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum emit between blocks 18000000 and 18002000? Filter by the Transfer topic0 from the zero address."}],"resultDescription":"Returns a JSON object containing: total log count, the queried contract address, network name, chain ID, block range (from_block, to_block), price in USD, and an array of log objects each with block_number, tx_hash, log_index, topics array, and data field (hex-encoded).","failureModes":["Invalid or non-checksummed contract address returns an error or empty logs","Block range too wide may exceed node limits or return truncated results","Unsupported network (not Base or Ethereum) returns an error","Invalid topic0 hex string causes a query error","Payment not completed (x402 flow failure) blocks the request","Contract with no events in the specified range returns count: 0 and empty logs array"],"whenToPreferThis":"Choose this endpoint when you need lightweight, pay-per-call access to Ethereum or Base contract event logs without managing your own RPC node or API key. It is ideal for agents that need on-demand event log lookups with topic0 filtering and structured JSON output, especially for DeFi monitoring, NFT tracking, or contract debugging. Prefer it over raw RPC calls when you want automatic pricing transparency and don't want to manage node infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:57:07.175Z","isFirstParty":false,"canonicalSlug":"event-logs-eth-getlogs-base-ethereum-ff36cae5"}