Skip to main content

v1/{chainName}/events/ REST API Endpoint

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.

Updated on
Jan 09, 2025

v1/{chainName}/events/ REST API Endpoint

Path Parameters

chainName
string
REQUIRED
The name of the blockchain, e.g., eth-mainnet

Query Parameters

starting-block
integer
The starting block number for the query
ending-block
string
The ending block number for the query
address
string
The blockchain address to filter events for
topics
string
The event topics to filter the logs
block-hash
string
The block hash to filter logs by
skip-decode
boolean
The option to skip decoding the log data

Returns

data
object
The main container for API response data
updated_at
string
The timestamp of the latest update
chain_id
integer
The unique ID of the blockchain
chain_name
string
The name of the blockchain (e.g., eth-mainnet)
items
array
The list of transaction log items in the block
block_signed_at
string
The timestamp when the block was signed
block_height
integer
The height of the block
tx_offset
integer
The transaction offset within the block
log_offset
integer
The log offset within the transaction
tx_hash
string
The transaction hash associated with the log
raw_log_topics
array
The raw log topics of the transaction
sender_contract_decimals
integer
The decimal precision of the sender contract
sender_name
string
The name of the sender contract
sender_contract_ticker_symbol
string
The ticker symbol of the sender contract
sender_address
string
The address of the sender
sender_address_label
string
The label associated with the sender address, if any
sender_logo_url
string
The URL of the sender's logo
supports_erc
array
The list of supported ERC standards
sender_factory_address
string
The factory address of the sender, if applicable
raw_log_data
string
The raw data of the log
decoded
object
The decoded log data
name
string
The name of the decoded event
signature
string
The event signature of the decoded log
params
array
The list of parameters in the decoded 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 value is decoded
value
string
The value of the parameter
pagination
object
Pagination details of the response
has_more
boolean
Indicates if there are more pages available
page_number
integer
The current page number
page_size
integer
The number of items per page
total_count
integer
The total number of items, if available
error
boolean
Indicates whether an error occurred
error_message
string
The error message if an error occurred, or null otherwise
error_code
string
The error code if an error occurred, or null otherwise
Request
1
curl --location 'https://api.covalenthq.com/v1/eth-mainnet/events/' \
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