{"uid":"cap_x4RNxcNDlXPvY_NmbZPk8","slug":"blockscout-address-event-logs-15d38602","name":"Blockscout Address Event Logs","description":"Access to api/v2/addresses/:address_hash/logs. List event logs emitted by or involving a specific address","url":"https://api.blockscout.com/:chain_id/api/v2/addresses/:address_hash_param/logs","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"},"pathParams":{"type":"object","properties":{"chain_id":{"type":"string"},"address_hash_param":{"type":"string"}}},"queryParams":{"type":"object","properties":{"index":{"type":"integer"},"topic":{"type":"string"},"items_count":{"type":"integer"},"block_number":{"type":"integer"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CQt8O4Hu3s8q8EWyz7iKU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves paginated event logs emitted by or involving a specific blockchain address on a given chain","exampleAgentPrompt":"Pull up all the event logs for the smart contract at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum mainnet (chain ID 1) — I want to see what events it has emitted, starting from block 18000000.","exampleUseCases":[{"title":"Audit ERC-20 token transfer events","prompt":"Show me all the event logs for the USDC token contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum (chain 1) so I can audit its Transfer and Approval events."},{"title":"Monitor DeFi protocol activity","prompt":"Fetch the latest 50 event logs for the Uniswap V3 pool contract 0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640 on chain 1 so I can track liquidity and swap events."},{"title":"Debug smart contract interactions","prompt":"Get the event logs for contract address 0xC36442b4a4522E871399CD717aBDD847Ab11FE88 on Optimism (chain 10) filtered by topic 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef to debug token transfers."}],"resultDescription":"Returns a paginated list of event log entries associated with the given address on the specified chain. Each log entry typically includes the transaction hash, block number, log index, topics array (event signature and indexed parameters), raw data field, and the emitting contract address. Pagination is supported via index and items_count parameters.","failureModes":["Invalid or malformed address hash returns 400 or empty result","Unsupported or unknown chain_id returns 404 or error","Topic filter with invalid hex string may return empty logs or error","Pagination index out of range returns empty items array","Rate limiting or payment issues return 402 or 429","Network or node unavailability causes 503 timeout"],"whenToPreferThis":"Choose this endpoint when you need on-chain event log history for a specific address on any EVM-compatible chain supported by Blockscout, especially when you want multichain coverage without running your own node. Prefer it over Etherscan-style APIs when you need open, decentralized block explorer data with per-call micropayment pricing. It is well-suited for smart contract auditing, DeFi monitoring, and event-driven workflows that require historical log data filtered by address and optionally by topic or block range.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:47:00.888Z","isFirstParty":false}