Skip to main content

v1/{chainName}/events/address/{contractAddress}/ REST API Endpoint

Commonly used to get all the event logs emitted from a particular contract address. Useful for building dashboards that examine on-chain interactions.

Updated on
Jan 09, 2025

v1/{chainName}/events/address/{contractAddress}/ REST API Endpoint

Path Parameters

chainName
string
REQUIRED
The name of the blockchain to query
contractAddress
string
REQUIRED
The address of the smart contract to query events for

Query Parameters

starting-block
integer
The starting block number for the query
ending-block
string
The ending block number for the query
page-size
integer
The number of items to return per page
page-number
integer
The page number to retrieve

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
Request
1
curl --location 'https://api.covalenthq.com/v1/eth-mainnet/events/address/0x4485cD74DAeC9C57593a173bd854C24EDBFaC3e8/?starting-block=21414186%20' \
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