Skip to main content

v1/{chainName}/address/{walletAddress}/transactions_summary/ REST API Endpoint

Commonly used to fetch the earliest and latest transactions, and the transaction count for a wallet. Calculate the age of the wallet and the time it has been idle and quickly gain insights into their engagement with web3.

Updated on
Jan 09, 2025

v1/{chainName}/address/{walletAddress}/transactions_summary/ REST API Endpoint

Path Parameters

chainName
string
REQUIRED
The chain name eg: eth-mainnet
walletAddress
string
REQUIRED
The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically

Query Parameters

quote-currency
string
The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP
with-gas
boolean
Include gas summary details. Additional charge of 1 credit when true. Response times may be impacted for wallets with millions of transactions

Returns

data
object
The response data containing following fields:
updated_at
string
The timestamp when the data was last updated
address
string
The wallet address associated with the transactions
chain_id
integer
The ID of the blockchain network
chain_name
string
The name of the blockchain network
items
array
An array of transaction summary items
total_count
integer
The total number of transactions for the address
earliest_transaction
object
Details of the earliest transaction
block_signed_at
string
The timestamp when the block containing the transaction was signed
tx_hash
string
The hash of the earliest transaction
tx_detail_link
string
A link to the details of the earliest transaction
latest_transaction
object
Details of the latest transaction (currently empty)
block_signed_at
string
The timestamp when the block containing the transaction was signed
tx_hash
string
The hash of the latest transaction
tx_detail_link
string
A link to the details of the latest transaction
gas_summary
object
A summary of gas fees for transactions
total_sent_count
integer
The total number of transactions sent
total_fees_paid
string
The total gas fees paid across all transactions
total_gas_quote
integer
The total gas fees in the quoted currency
pretty_total_gas_quote
string
The total gas fees in quoted currency formatted as a readable string
average_gas_quote_per_tx
integer
The average gas fees in quoted currency per transaction
pretty_average_gas_quote_per_tx
string
The average gas fees per transaction formatted as a readable string
gas_metadata
object
Metadata for the gas fees
contract_decimals
integer
The number of decimals used in the gas contract
contract_name
string
The name of the gas contract
contract_ticker_symbol
string
The ticker symbol of the gas contract
contract_address
string
The address of the gas contract
supports_erc
array
A list of ERC standards supported by the contract
logo_url
string
The URL of the contract's logo
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/address/0x00000000219ab540356cBB839Cbe05303d7705Fa/transactions_summary/' \
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