log_events_by_topic
Retrieve all event logs matching a specific topic hash across all contracts on a blockchain. Ideal for tracking event types like transfers or approvals across multiple contracts.
Instructions
Commonly used to get all event logs of the same topic hash across all contracts within a particular chain. Useful for cross-sectional analysis of event logs that are emitted on-chain.Requires chainName (blockchain network) and topicHash (the event signature hash). Optional parameters include block range (startingBlock, endingBlock), secondaryTopics for filtering by additional parameters, and pagination settings (pageSize default 10, pageNumber default 0). Returns decoded event logs matching the specified topic hash, ideal for tracking specific event types across multiple contracts on a blockchain.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chainName | Yes | The blockchain network to query (e.g., 'eth-mainnet', 'matic-mainnet', 'bsc-mainnet'). | |
| topicHash | Yes | The event signature hash (topic[0]) to search for. This is the keccak256 hash of the event signature. | |
| startingBlock | No | Starting block number to begin search from. Use with endingBlock to define a range. | |
| endingBlock | No | Ending block number to search until. Use with startingBlock to define a range. | |
| secondaryTopics | No | Additional topic filters (topic[1], topic[2], topic[3]) to narrow down the search. | |
| pageSize | No | Number of log events to return per page. Default is 10, maximum is 100. | |
| pageNumber | No | Page number for pagination, starting from 0. Default is 0. |