{"uid":"cap_9InmFVIxhPWgA_t4Y22uM","slug":"blockscout-address-event-logs-api-0995ef52","name":"Blockscout Address Event Logs API","description":"Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data","url":"https://api.blockscout.com/%7Bchain_id%7D/api/v2/addresses/%7Baddress_hash_param%7D/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":{"type":"json","example":{"items":[{"data":"string","index":0,"topics":["string"],"address":{"hash":"string","name":"string","is_scam":true,"metadata":{},"proxy_type":"string","reputation":"string","is_contract":true,"is_verified":true,"public_tags":[{"label":"string","address_hash":"string","display_name":"string"}],"private_tags":[{"label":"string","address_hash":"string","display_name":"string"}],"ens_domain_name":"string","implementations":[{"name":"string","address_hash":"string"}],"watchlist_names":[{"label":"string","display_name":"string"}]},"decoded":{},"block_hash":"string","block_number":0,"smart_contract":{},"block_timestamp":"string","transaction_hash":"string"}],"next_page_params":{}}},"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_mzjMZggfzfy6dnYH0LOos","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 smart contract event logs emitted by a specific address on a given blockchain network","exampleAgentPrompt":"Can you pull the latest smart contract event logs for address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum mainnet (chain ID 1) using Blockscout, filtered to topic 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef?","exampleUseCases":[{"title":"Audit DeFi Protocol Events","prompt":"Pull all the event logs emitted by the Uniswap V3 pool contract 0x8ad599c3A0ff1De082011EFDDc58f1908eb6e6D8 on Ethereum (chain 1) from Blockscout so I can audit recent Swap events by topic."},{"title":"Monitor NFT Transfer Activity","prompt":"Get the recent event logs for NFT contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum using Blockscout — I want to see Transfer events so I can track ownership changes."},{"title":"Debug Failed Contract Interactions","prompt":"Show me the last 20 event logs for smart contract address 0x6B175474E89094C44Da98b954EedeAC495271d0F on chain 100 (Gnosis) via Blockscout so I can debug what events fired recently."}],"resultDescription":"Returns a paginated list of event log objects, each containing the raw data field, topic hashes, decoded log payload, emitting address with metadata (name, verification status, proxy type, tags, ENS name), block hash, block number, block timestamp, and transaction hash. Also includes next_page_params for cursor-based pagination.","failureModes":["Invalid or malformed address_hash_param returns an error or empty result","Unsupported chain_id returns a 404 or chain-not-found error","Address with no logs returns an empty items array","Invalid topic hash format causes a query error","Pagination index out of range returns empty items","Network congestion or node unavailability causes timeout"],"whenToPreferThis":"Use this endpoint when you need the full event log history for a specific contract or wallet address on a supported EVM chain, especially when you want decoded event data, address metadata (ENS names, tags, verification), and cross-chain flexibility via Blockscout's multichain infrastructure. Prefer this over generic RPC eth_getLogs calls when you also need enriched address metadata alongside raw log data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-10T12:39:38.800Z","isFirstParty":false}