latestOpenAPI 3.1.02026-08-0837114837.8 KB

c099830c76a0

get-log-events-by-contract-address

Commonly used to get all the event logs emitted from a particular contract address. Useful for building dashboards that examine on-chain interactions.

get/v1/{chainName}/events/address/{contractAddress}/

Path parameters

chainNamestring required

The chain name eg: eth-mainnet.

contractAddressstring required

The requested contract address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically.

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.

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.