latestOpenAPI 3.1.02026-08-0837114837.8 KB

c099830c76a0

get-logs

Commonly used to get all the event logs of the latest block, or for a range of blocks. Includes sender contract metadata as well as decoded logs.

get/v1/{chainName}/events/

Path parameters

chainNamestring required

The chain name eg: eth-mainnet.

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.

addressstring

The address of the log events sender contract.

topicsstring

The topic hash(es) to retrieve logs with.

block-hashstring

The block hash to retrieve logs for.

skip-decodeboolean

Omit decoded log events.

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.