Skip to main content

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

Commonly used to render the transfer-in and transfer-out of a token along with historical prices from an address.

Updated on
Jan 09, 2025

v1/{chainName}/address/{walletAddress}/transfers_v2/ 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
contract-address
string
The requested contract address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically
starting-block
integer
The block height to start from, defaults to 0
ending-block
integer
The block height to end at, defaults to current block height
page-size
integer
The number of results to return per page. Omitting this parameter defaults to 100
page-number
integer
The page number to retrieve

Returns

data
object
The response data containing following fields:
address
string
The blockchain address for which transaction data is retrieved
updated_at
string
The timestamp when the data was last updated
quote_currency
string
The currency used for quoting values
chain_id
integer
The ID of the blockchain network
chain_name
string
The name of the blockchain network
items
array
An array of transaction 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 offset of the transaction in the block
successful
boolean
Indicates if the transaction was successful
miner_address
string
The address of the miner who validated the block
from_address
string
The sender's address for the transaction
from_address_label
string
A label for the sender's address, if available
to_address
string
The recipient's address for the transaction
to_address_label
string
A label for the recipient's address, if available
value
string
The value of the transaction
value_quote
integer
The quoted value of the transaction in the specified currency
pretty_value_quote
string
A formatted string of the quoted value
gas_metadata
object
Metadata about the gas used in the transaction
contract_decimals
integer
The number of decimals used by the token contract
contract_name
string
The name of the token contract
contract_ticker_symbol
string
The ticker symbol of the token contract
contract_address
string
The address of the token contract
supports_erc
array
A list of supported ERC standards
logo_url
string
The URL of the token's logo
gas_offered
integer
The amount of gas offered for the transaction
gas_spent
integer
The amount of gas spent for the transaction
gas_price
integer
The price of gas used in the transaction
fees_paid
string
The total fees paid for the transaction
gas_quote
integer
The quoted value of gas in the specified currency
pretty_gas_quote
string
A formatted string of the gas quote
gas_quote_rate
integer
The rate of gas in the specified currency
transfers
array
An array of transfer details within the transaction
block_signed_at
string
The timestamp when the block was signed
tx_hash
string
The unique hash of the transaction
from_address
string
The sender's address for the transfer
to_address
string
The recipient's address for the transfer
delta
string
The change in balance resulting from the transfer
pagination
object
Pagination details for the result set
has_more
boolean
Indicates if there are more pages of data
page_number
integer
The current page number
page_size
integer
The number of items per page
total_count
integer
The total number of items 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/address/0xdAC17F958D2ee523a2206206994597C13D831ec7/transfers_v2/?contract-address=0xdAC17F958D2ee523a2206206994597C13D831ec7' \
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