Skip to main content

v1/{chainName}/events/topics/{topicHash}/ REST API Endpoint

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.

Updated on
Jan 09, 2025

v1/{chainName}/events/topics/{topicHash}/ REST API Endpoint

Path Parameters

chainName
string
REQUIRED
The name of the blockchain to query
topicHash
string
REQUIRED
The topic hash for which to query event logs

Query Parameters

starting-block
integer
The starting block number for the query
ending-block
string
The ending block number for the query
secondary-topics
string
The secondary topic hashes to filter the events
page-size
integer
The number of items to return per page
page-number
integer
The page number to retrieve

Returns

data
object
The data object which contains the following fields:
updated_at
string
The timestamp of the last update for this data
chain_id
integer
The ID of the blockchain network
chain_name
string
The name of the blockchain
items
array
An array containing details about the block transactions and logs
block_signed_at
string
The timestamp when the block was signed
block_height
integer
The height of the block
tx_offset
integer
The offset of the transaction in the block
log_offset
integer
The offset of the log within the transaction
tx_hash
string
The transaction hash associated with the log
raw_log_topics
array
The raw log topics for the event
sender_contract_decimals
integer
The number of decimals for the sender contract (if applicable)
sender_name
string
The name of the sender contract
sender_contract_ticker_symbol
string
The ticker symbol for the sender contract
sender_address
string
The blockchain address of the sender
sender_address_label
string
A label or identifier for the sender address
sender_logo_url
string
The URL of the logo associated with the sender address
supports_erc
array
The list of supported ERC standards for the sender contract
sender_factory_address
string
The address of the contract factory that created the sender contract
raw_log_data
string
The raw data of the log
decoded
object
The decoded log event data
name
string
The name of the event
signature
string
The event's signature
params
array
An array of parameters for the event
name
string
The name of the parameter
type
string
The data type of the parameter
indexed
boolean
Indicates whether the parameter is indexed
decoded
boolean
Indicates whether the parameter has been decoded
value
string
The value of the parameter
pagination
object
Details about the pagination of the response
has_more
boolean
Indicates whether more results are available
page_number
integer
The current page number
page_size
integer
The number of results per page
total_count
integer
The total number of results available
Request
1
curl --location 'https://api.covalenthq.com/v1/eth-mainnet/events/topics/0xc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d2/?starting-block=21414186&ending-block=21414187' \
2
--header 'Content-Type: application/json' \
3
--header 'Authorization: Bearer YOUR_API_KEY'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free