Path Parameters

chainName

string

REQUIRED

The chain name eg: base-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

no-logs

boolean

Flag to exclude logs from the response

block-signed-at-asc

boolean

Sort the transactions in ascending chronological order. By default, it's set to false and returns transactions in descending chronological order

Returns

data

object

The response data containing details of the wallet and its token approvals

address

string

The wallet address to fetch transaction details for

updated_at

string

The timestamp when the data was last updated

quote_currency

string

The currency used for quoting transaction values

chain_id

integer

The unique identifier for the blockchain network

chain_name

string

The name of the blockchain network

current_page

integer

The current page of the paginated transactions list

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

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/base-mainnet/bulk/transactions/0x00000000219ab540356cBB839Cbe05303d7705Fa/' \
2
--header 'Content-Type: application/json' \
3
--header 'Authorization: Bearer YOUR_API_KEY'

1
curl --location 'https://api.covalenthq.com/v1/base-mainnet/bulk/transactions/0x00000000219ab540356cBB839Cbe05303d7705Fa/' \
2
--header 'Content-Type: application/json' \
3
--header 'Authorization: Bearer YOUR_API_KEY'

1
const myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3
myHeaders.append("Authorization", "Bearer YOUR_API_KEY");
4

5
const requestOptions = {
6
  method: "GET",
7
  headers: myHeaders,
8
  redirect: "follow"
9
};
10

11
fetch("https://api.covalenthq.com/v1/base-mainnet/bulk/transactions/0x00000000219ab540356cBB839Cbe05303d7705Fa/", requestOptions)
12
  .then((response) => response.text())
13
  .then((result) => console.log(result))
14
  .catch((error) => console.error(error));

1
const myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3
myHeaders.append("Authorization", "Bearer YOUR_API_KEY");
4

5
const requestOptions = {
6
  method: "GET",
7
  headers: myHeaders,
8
  redirect: "follow"
9
};
10

11
fetch("https://api.covalenthq.com/v1/base-mainnet/bulk/transactions/0x00000000219ab540356cBB839Cbe05303d7705Fa/", requestOptions)
12
  .then((response) => response.text())
13
  .then((result) => console.log(result))
14
  .catch((error) => console.error(error));

1
import requests
2
import json
3

4
url = "https://api.covalenthq.com/v1/base-mainnet/bulk/transactions/0x00000000219ab540356cBB839Cbe05303d7705Fa/"
5

6
payload = {}
7
headers = {
8
  'Content-Type': 'application/json',
9
  'Authorization': 'Bearer YOUR_API_KEY'
10
}
11

12
response = requests.request("GET", url, headers=headers, data=payload)
13

14
print(response.text)
15

1
import requests
2
import json
3

4
url = "https://api.covalenthq.com/v1/base-mainnet/bulk/transactions/0x00000000219ab540356cBB839Cbe05303d7705Fa/"
5

6
payload = {}
7
headers = {
8
  'Content-Type': 'application/json',
9
  'Authorization': 'Bearer YOUR_API_KEY'
10
}
11

12
response = requests.request("GET", url, headers=headers, data=payload)
13

14
print(response.text)
15

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://api.covalenthq.com/v1/base-mainnet/bulk/transactions/0x00000000219ab540356cBB839Cbe05303d7705Fa/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Get.new(url)
11
request["Content-Type"] = "application/json"
12
request["Authorization"] = "Bearer YOUR_API_KEY"
13

14
response = https.request(request)
15
puts response.read_body
16

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://api.covalenthq.com/v1/base-mainnet/bulk/transactions/0x00000000219ab540356cBB839Cbe05303d7705Fa/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Get.new(url)
11
request["Content-Type"] = "application/json"
12
request["Authorization"] = "Bearer YOUR_API_KEY"
13

14
response = https.request(request)
15
puts response.read_body
16

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free