latestOpenAPI 3.1.02026-08-0837114837.8 KB

c099830c76a0

get-log-events-by-topic-hash

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.

get/v1/{chainName}/events/topics/{topicHash}/

Path parameters

chainNamestring required

The chain name eg: eth-mainnet.

topicHashstring required

The endpoint will return event logs that contain this topic hash.

Query parameters

starting-blockinteger

The first block to retrieve log events with. Accepts decimals, hexadecimals, or the strings earliest and latest.

ending-blockstring

The last block to retrieve log events with. Accepts decimals, hexadecimals, or the strings earliest and latest.

secondary-topicsstring

Additional topic hash(es) to filter on - padded & unpadded address fields are supported. Separate multiple topics with a comma.

page-sizeinteger

Number of items per page. Omitting this parameter defaults to 100.

page-numberinteger

0-indexed page number to begin pagination.

Response

Successful response

updated_atstring date-time

The timestamp when the response was generated. Useful to show data staleness to users.

chain_idinteger

The requested chain ID eg: 1.

chain_namestring

The requested chain name eg: eth-mainnet.

chain_tip_heightinteger

The latest block height of the blockchain at the time this response was provided.

chain_tip_signed_atstring date-time

The timestamp of the latest signed block at the time this response was provided.