Get transaction summary for address

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.

^{Credit Cost: 1 per call.
Processing: Batch}

Related guides

How Token Gating and Membership dApps Use the GoldRush API

Comparing GoldRush’s Transactions API to RPC Providers

How to Get Transaction History for an Address on Ethereum

Building Web3 Wallets (Part 7) - Multi-Chain Wallet Activity Summary

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.

Response

200 - application/json

address

string

The requested address.

chain_id

integer

The requested chain ID eg: 1.

chain_name

string

The requested chain name eg: eth-mainnet.

items

object[]

List of response items.

Show child attributes

items.earliest_transaction

object

The earliest transaction detected.

Show child attributes

items.earliest_transaction.block_signed_at

string

The block signed timestamp in UTC.

items.earliest_transaction.tx_detail_link

string

The link to the transaction details using the Covalent API.

items.earliest_transaction.tx_hash

string

The requested transaction hash.

items.gas_summary

object

The gas summary for the transactions.

Show child attributes

items.gas_summary.average_gas_quote_per_tx

number

The average gas quote per transaction.

items.gas_summary.gas_metadata

object

The requested chain native gas token metadata.

Show child attributes

items.gas_summary.gas_metadata.contract_address

string

Use the relevant contract_address to lookup prices, logos, token transfers, etc.

items.gas_summary.gas_metadata.contract_decimals

integer

Use contract decimals to format the token balance for display purposes - divide the balance by 10^{contract_decimals}.

items.gas_summary.gas_metadata.contract_name

string

The string returned by the name() method.

items.gas_summary.gas_metadata.contract_ticker_symbol

string

The ticker symbol for this contract. This field is set by a developer and non-unique across a network.

items.gas_summary.gas_metadata.logo_url

string

The contract logo URL.

items.gas_summary.gas_metadata.supports_erc

string[]

A list of supported standard ERC interfaces, eg: ERC20 and ERC721.

items.gas_summary.pretty_average_gas_quote_per_tx

string

A prettier version of the quote for rendering purposes.

items.gas_summary.pretty_total_gas_quote

string

A prettier version of the quote for rendering purposes.

items.gas_summary.total_fees_paid

string

b;The total transaction fees paid by the address, denoted in wei.

items.gas_summary.total_gas_quote

number

The total transaction fees paid by the address, denoted in quote-currency.

items.gas_summary.total_sent_count

integer

The total number of transactions sent by the address.

items.latest_transaction

object

The latest transaction detected.

items.total_count

integer

The total number of transactions.

updated_at

string

The timestamp when the response was generated. Useful to show data staleness to users.