Sign in

v1

latestOpenAPI 3.1.02026-07-13570316.1 KB
Gateway

Get Contract Events

Retrieves events emitted by a specific smart contract address on a specific blockchain network. This endpoint provides comprehensive event data including block information, transaction details, event topics, and optional ABI decoding. Results can be filtered, paginated, and sorted to meet specific requirements.

Authentication: Pass x-client-id header for frontend usage from allowlisted origins or x-secret-key for backend usage.

get/v1/contracts/{chainId}/{address}/events

Path parameters

chainIdinteger required

The blockchain network identifier where the contract is deployed.

Example:1

The blockchain network identifier where the contract is deployed.

addressstring required

The smart contract address or ENS name.

The smart contract address or ENS name.

Query parameters

signaturestring

Filter by event signature hash, e.g., '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef' for Transfer event

Filter by event signature hash, e.g., '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef' for Transfer event

filterTopic0string

Filter by event topic 0 (event signature hash)

Filter by event topic 0 (event signature hash)

filterTopic1string

Filter by event topic 1

Filter by event topic 1

filterTopic2string

Filter by event topic 2

Filter by event topic 2

filterTopic3string

Filter by event topic 3

Filter by event topic 3

filterBlockTimestampGteinteger nullable

Filter by block timestamp (Unix timestamp) greater than or equal to this value

Filter by block timestamp (Unix timestamp) greater than or equal to this value

filterBlockTimestampLteinteger nullable

Filter by block timestamp (Unix timestamp) less than or equal to this value

Filter by block timestamp (Unix timestamp) less than or equal to this value

filterBlockNumberGteinteger nullable

Filter by block number greater than or equal to this value

Filter by block number greater than or equal to this value

filterBlockNumberLteinteger nullable

Filter by block number less than or equal to this value

Filter by block number less than or equal to this value

pagenumber nullable

Current page number

Current page number

limitnumber nullable

Number of items per page

Number of items per page

sortOrder'asc' | 'desc'

Sort order: 'asc' for ascending, 'desc' for descending

Sort order: 'asc' for ascending, 'desc' for descending

Response

Contract events retrieved successfully. Returns event data with metadata including pagination information. Includes decoded event parameters when ABI is available.