v1/{chainName}/bulk/transactions/{walletAddress}/{timeBucket}/ 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
timeBucket
integer
REQUIRED
The 0-indexed 15-minute time bucket. E.g. 27 Feb 2023 05:23 GMT = 1677475383 (Unix time). 1677475383/900=1863861 timeBucket
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
no-logs
boolean
Flag to exclude logs from the response
Returns
data
object
The response data containing details of the wallet and its token approvals
updated_at
string
The timestamp indicating when the data was last updated
chain_id
integer
The unique identifier of the blockchain network
chain_name
string
The name of the blockchain network
links
object
An object containing pagination links for navigating through pages of data
prev
string
The URL link to the previous page of the data. Null if no previous page exists
next
string
The URL link to the next page of the data. Null if no next page exists
items
array
An array of items
block_signed_at
string
The timestamp when the block was signed
block_height
integer
The height of the block in the blockchain
block_hash
string
The unique hash of the block
tx_hash
string
The unique hash of the transaction
tx_offset
integer
The position of the transaction in the block
successful
boolean
Indicates whether the transaction was successful
from_address
string
The address of the transaction sender
miner_address
string
The address of the miner who mined the block
from_address_label
string
A label or name associated with the sender's address, if available
to_address
string
The address of the transaction recipient
to_address_label
string
The label or description associated with the recipient address
value
string
The amount of cryptocurrency transferred in the transaction, expressed as a raw string value
value_quote
integer
The fiat currency equivalent of the transaction value at the time of execution
pretty_value_quote
string
A human-readable string representation of the fiat currency equivalent of the transaction value
gas_metadata
object
The gas metadata object providing details about the gas contract, including its address, name, and token details
contract_decimals
integer
The number of decimal places used by the contract for token calculations
contract_name
string
The name of the contract associated with the transaction
contract_ticker_symbol
string
The ticker symbol representing the contract's token
contract_address
string
The blockchain address of the contract
supports_erc
string
A list of strings specifying the ERC standards supported by the contract, such as ERC20 or ERC721
logo_url
string
A URL pointing to the logo associated with the contract
gas_offered
integer
The amount of gas that was initially offered for the transaction
gas_spent
integer
The actual amount of gas consumed during the transaction execution
gas_price
integer
The price per unit of gas offered by the sender, typically measured in Gwei
fees_paid
string
The total transaction fees paid, calculated as gas spent multiplied by gas price
gas_quote
integer
The transaction fee expressed in the quoted currency (e.g., USD)
pretty_gas_quote
string
A human-readable representation of the transaction fee in the quoted currency
gas_quote_rate
integer
The exchange rate used to convert gas fees from the native currency to the quoted currency
explorers
array
An array containing information about blockchain explorers related to the transaction
label
string
The name or label of the explorer
url
string
The URL of the blockchain explorer
dex_details
array
(Optional) An array of details about DEX (Decentralized Exchange) activities related to the transaction
log_offset
integer
The offset of the log entry in the block
protocol_name
string
The name of the DEX protocol involved in the transaction
protocol_address
string
The address of the DEX protocol's smart contract
protocol_logo_url
string
The URL of the logo for the DEX protocol
aggregator_name
string
The name of the aggregator involved in the transaction, if applicable
aggregator_address
string
The address of the aggregator's smart contract
version
integer
The version number of the protocol used
fork_version
integer
The fork version of the protocol, if applicable
fork
string
The name of the blockchain fork, if relevant
event
string
The specific event type that occurred in the transaction
pair_address
string
The address of the token pair involved in the transaction
pair_lp_fee_bps
integer
The liquidity provider fee in basis points (bps)
lp_token_address
string
The address of the liquidity pool token
lp_token_ticker
string
The ticker symbol of the liquidity pool token
lp_token_num_decimals
integer
The number of decimals for the liquidity pool token
lp_token_name
string
The name of the liquidity pool token
lp_token_value
string
The value of the liquidity pool token
exchange_rate_usd
integer
The exchange rate in USD for the token pair
token_0_address
string
The address of the first token in the pair
token_0_ticker
string
The ticker symbol of the first token
token_0_num_decimals
integer
The number of decimals for the first token
token_0_name
string
The name of the first token
token_1_address
string
The address of the second token in the pair
token_1_ticker
string
The ticker symbol of the second token
token_1_num_decimals
integer
The number of decimals for the second token
token_1_name
string
The name of the second token
token_0_amount
string
The amount of the first token involved in the transaction
token_0_quote_rate
integer
The quote rate for the first token in USD
token_0_usd_quote
integer
The USD equivalent of the first token amount
pretty_token_0_usd_quote
string
A human-readable USD equivalent of the first token amount
token_0_logo_url
string
The URL of the logo for the first token
token_1_amount
string
The amount of the second token involved in the transaction
token_1_quote_rate
integer
The quote rate for the second token in USD
token_1_usd_quote
integer
The USD equivalent of the second token amount
pretty_token_1_usd_quote
string
A human-readable USD equivalent of the second token amount
token_1_logo_url
string
The URL of the logo for the second token
sender
string
The address of the sender in the transaction
recipient
string
The address of the recipient in the transaction
nft_sale_details
array
(Optional) An array containing details of NFT sales associated with the transaction
log_offset
integer
The offset of the log entry in the block
topic0
string
The first topic of the event log, typically used for event identification
protocol_contract_address
string
The address of the NFT protocol's contract involved in the sale
protocol_name
string
The name of the NFT protocol facilitating the sale
protocol_logo_url
string
The URL of the logo representing the NFT protocol
to
string
The address of the recipient in the NFT sale
from
string
The address of the sender in the NFT sale
maker
string
The address of the maker (order creator) in the NFT trade
taker
string
The address of the taker (order fulfiller) in the NFT trade
token_id
string
The unique identifier of the NFT token involved in the sale
collection_address
string
The address of the NFT collection's contract
collection_name
string
The name of the NFT collection
token_address
string
The address of the token used in the sale
token_name
string
The name of the token used in the sale
ticker_symbol
string
The ticker symbol of the token used in the sale
num_decimals
integer
The number of decimal places used by the token
contract_quote_rate
integer
The exchange rate of the token used in the sale, quoted in USD
nft_token_price
integer
The price of the NFT token in the native token
nft_token_price_usd
integer
The price of the NFT token in USD
pretty_nft_token_price_usd
string
A human-readable string representation of the NFT token price in USD
nft_token_price_native
integer
The price of the NFT token in the native blockchain currency
pretty_nft_token_price_native
string
A human-readable string representation of the NFT token price in the native currency
token_count
integer
The number of tokens involved in the NFT sale
num_token_ids_sold_per_sale
integer
The number of unique token IDs sold in a single sale
num_token_ids_sold_per_tx
integer
The number of unique token IDs sold in a single transaction
num_collections_sold_per_sale
integer
The number of NFT collections involved in a single sale
num_collections_sold_per_tx
integer
The number of NFT collections involved in a single transaction
trade_type
string
The type of trade (e.g., primary sale, secondary sale)
trade_group_type
string
The group type of the trade (e.g., batch, single)
lending_details
array
(Optional) An array of lending details containing information about lending transactions
log_offset
integer
The offset of the log entry in the block
protocol_name
string
The name of the lending protocol involved in the transaction
protocol_address
string
The address of the lending protocol's contract
protocol_logo_url
string
The URL of the lending protocol's logo
version
string
The version of the lending protocol
fork
string
The fork of the lending protocol, if applicable
fork_version
string
The version of the protocol fork, if applicable
event
string
The specific event type associated with the lending transaction
lp_token_name
string
The name of the liquidity provider token
lp_decimals
integer
The number of decimal places for the liquidity provider token
lp_ticker_symbol
string
The ticker symbol for the liquidity provider token
lp_token_address
string
The address of the liquidity provider token contract
lp_token_amount
integer
The amount of liquidity provider tokens involved in the transaction
lp_token_price
integer
The price of the liquidity provider token
exchange_rate
integer
The exchange rate between the liquidity provider token and the underlying asset
exchange_rate_usd
integer
The exchange rate between the liquidity provider token and USD
token_name_in
string
The name of the input token for the lending transaction
token_decimal_in
integer
The number of decimal places for the input token
token_address_in
string
The address of the input token's contract
token_ticker_in
string
The ticker symbol of the input token
token_logo_in
string
The URL of the logo for the input token
token_amount_in
integer
The amount of input tokens involved in the lending transaction
amount_in_usd
integer
The value of the input tokens in USD
pretty_amount_in_usd
string
A human-readable string representation of the input token value in USD
token_name_out
string
The name of the output token for the lending transaction
token_decimals_out
integer
The number of decimal places for the output token
token_address_out
string
The address of the output token's contract
token_ticker_out
string
The ticker symbol of the output token
token_logo_out
string
The URL of the logo for the output token
token_amount_out
integer
The amount of output tokens involved in the lending transaction
amount_out_usd
integer
The value of the output tokens in USD
pretty_amount_out_usd
string
A human-readable string representation of the output token value in USD
borrow_rate_mode
integer
The mode of the borrowing rate (e.g., stable or variable)
borrow_rate
integer
The borrowing rate for the transaction
on_behalf_of
string
The address of the entity on whose behalf the transaction is performed
liquidator
string
The address of the liquidator involved in the lending transaction, if applicable
user
string
The address of the user initiating the lending transaction
log_events
array
(Optional) An array of log events that detail specific occurrences within a transaction
block_signed_at
string
The timestamp at which the block containing the log event was signed
block_height
integer
The height of the block containing the log event
tx_offset
integer
The offset of the transaction in the block
log_offset
integer
The offset of the log event within the transaction
tx_hash
string
The hash of the transaction associated with the log event
raw_log_topics
string
A list of string values representing the raw topics for the log event
sender_contract_decimals
integer
The number of decimal places used by the sender's contract
sender_name
string
The name of the sender's contract, if available
sender_contract_ticker_symbol
string
The ticker symbol of the sender's contract, if available
sender_address
string
The address of the sender involved in the log event
sender_address_label
string
The label associated with the sender's address, if available
sender_logo_url
string
The URL of the logo for the sender's contract or address
supports_erc
string
A list of string values indicating the supported ERC standards for the sender's contract
sender_factory_address
string
The address of the factory contract that created the sender's contract, if applicable
raw_log_data
string
The raw data of the log event
decoded
object
The decoded object which contains detailed information about the log event
name
string
The name of the event associated with the log
signature
string
The signature of the event associated with the log
params
array
An array of parameters associated with the log event
name
string
The name of the parameter
type
string
The data type of the parameter
indexed
boolean
Indicates whether the parameter is indexed in the log
decoded
boolean
Indicates whether the parameter has been decoded
value
string
The value of the parameter
safe_details
array
(Optional) An array of safe details providing information about the owners and signatures of the safe
owner_address
string
The address of the owner associated with the safe
signature
string
The cryptographic signature provided by the owner for safe operations
signature_type
string
The type of cryptographic signature used for the safe
Request
1curl --location 'https://api.covalenthq.com/v1/eth-mainnet/bulk/transactions/0x00000000219ab540356cBB839Cbe05303d7705Fa/1863860/' \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