Sign in
events

Get contract events

Get contract events

get/v1/events/{contractAddress}

Request

  • Base URL: https://insight.thirdweb.com
  • URL: https://insight.thirdweb.com/v1/events/{contractAddress}
  • Auth: API key in header x-client-id

Path parameters

contractAddressstring required
Example:vitalik.eth

Query parameters

chainnumber[]

Use chain_id instead

[
  20,
  56,
  1
]
chain_idnumber[]

The chain ID(s) to request the data for. You can specify multiple chain IDs, up to a maximum of 55. Use repeated query parameters, e.g., ?chain_id=20&chain_id=56. Optional, because a single chain can as well be specified as a subdomain

[
  20,
  56,
  1
]
filter_block_numbernumber

Filter by block number

Example:1000000
filter_block_number_gtenumber

Filter by block number greater than or equal to

Example:1000000
filter_block_number_gtnumber

Filter by block number greater than

Example:1000000
filter_block_number_ltenumber

Filter by block number less than or equal to

Example:1000000
filter_block_number_ltnumber

Filter by block number less than

Example:1000000
filter_block_hashstring

Filter by block hash

Example:0x3a1fba5abd9d41457944e91ed097e039b7b12d3d7ba324a3f422db2277a48e28
filter_block_timestampnumber

Filter by block timestamp

Example:1715222400
filter_block_timestamp_gtenumber

Filter by block timestamp greater than or equal to

Example:1715222400
filter_block_timestamp_gtnumber

Filter by block timestamp greater than

Example:1715222400
filter_block_timestamp_ltenumber

Filter by block timestamp less than or equal to

Example:1715222400
filter_block_timestamp_ltnumber

Filter by block timestamp less than

Example:1715222400
'block_number'
OR
string
sort_order'asc' | 'desc'

Sort order (asc or desc)

Example:desc
group_byunknown
aggregatestring

Aggregation(s). You can specify multiple with repeated query parameters, e.g., ?aggregate=count()&aggregate=sum(gas_used)

Example:count()
filter_transaction_indexnumber nullable

Filter by transaction index

Example:5
filter_transaction_index_gtenumber nullable

Filter by transaction index greater than or equal to

Example:5
filter_transaction_index_gtnumber nullable

Filter by transaction index greater than

Example:5
filter_transaction_index_ltenumber nullable

Filter by transaction index less than or equal to

Example:5
filter_transaction_index_ltnumber nullable

Filter by transaction index less than

Example:5
decodeboolean nullable

Enable ABI decoding of the transactions/events data

Example:true
filter_transaction_hashstring

Filter by transaction hash

Example:0x218b632d932371478d1ae5a01620ebab1a2030f9dad6f8fba4a044ea6335a57e
filter_log_indexnumber nullable

Filter by log index

Example:5
filter_log_index_gtenumber nullable

Filter by log index greater than or equal to

Example:5
filter_log_index_gtnumber nullable

Filter by log index greater than

Example:5
filter_log_index_ltenumber nullable

Filter by log index less than or equal to

Example:5
filter_log_index_ltnumber nullable

Filter by log index less than

Example:5
filter_topic_1string

Filter by topic 1

Example:0xa6697e974e6a320f454390be03f74955e8978f1a6971ea6730542e37b66179bc
filter_topic_2string

Filter by topic 2

Example:0xa6697e974e6a320f454390be03f74955e8978f1a6971ea6730542e37b66179bc
filter_topic_3string

Filter by topic 3

Example:0xa6697e974e6a320f454390be03f74955e8978f1a6971ea6730542e37b66179bc
filter_topic_0string

Filter by topic 0

Example:0xa6697e974e6a320f454390be03f74955e8978f1a6971ea6730542e37b66179bc
limitinteger

The number of items to return

Example:20
pageinteger nullable

Page number (0-indexed). Maximum value depends on query parameters: 20 for regular queries, 500 when using aggregate or group_by parameters.

Response

Successful response

aggregationsunknown

Changes

No recorded changes to this operation across all 1 revision of this API.