Get paginated transactions for address (v3)

GET

{chainName}

address

{walletAddress}

transactions_v3

page

{page}

^{Credit Cost: 0.1 per item.}
^{Processing: Realtime}

This endpoint returns paginated transactions, starting with the earliest transactions on page 0. For the most recent transactions, refer to the endpoint.

Requests that return status 200 and no data cost 0.1 credits.

Enabling no-logs reduces request cost to 0.05 per item.

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.

page

integer

required

The requested page, 0-indexed.

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

Omit log events.

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.

Response

200 - application/json

address

string

The requested address.

updated_at

string

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

quote_currency

string

The requested quote currency eg: USD.

chain_id

integer

The requested chain ID eg: 1.

chain_name

string

The requested chain name eg: eth-mainnet.

current_page

integer

The current page of the response.

links

object

items

object[]

List of response items.

items.block_signed_at

string

The block signed timestamp in UTC.

items.block_height

integer

The height of the block.

items.block_hash

string

The hash of the block. Use it to remove transactions from re-org-ed blocks.

items.tx_hash

string

The requested transaction hash.

items.tx_offset

integer

The offset is the position of the tx in the block.

items.successful

boolean

Indicates whether a transaction failed or succeeded.

items.from_address

string

The sender's wallet address.

items.miner_address

string

The address of the miner.

items.from_address_label

string

The label of from address.

items.to_address

string

The receiver's wallet address.

items.to_address_label

string

The label of to address.

items.value

string

b;The value attached to this tx.

items.value_quote

number

The value attached in quote-currency to this tx.

items.pretty_value_quote

string

A prettier version of the quote for rendering purposes.

items.gas_metadata

object

The requested chain native gas token metadata.

items.gas_offered

integer

items.gas_spent

integer

The gas spent for this tx.

items.gas_price

integer

The gas price at the time of this tx.

items.fees_paid

string

b;The total transaction fees (gas_price * gas_spent) paid for this tx, denoted in wei.

items.gas_quote

number

The gas spent in quote-currency denomination.

items.pretty_gas_quote

string

A prettier version of the quote for rendering purposes.

items.gas_quote_rate

number

The native gas exchange rate for the requested quote-currency.

items.explorers

object[]

The explorer links for this transaction.

items.dex_details

object[]

The details for the dex transaction.

items.dex_details.log_offset

integer

The offset is the position of the log entry within an event log.

items.dex_details.protocol_name

string

Stores the name of the protocol that facilitated the event.

items.dex_details.protocol_address

string

Stores the contract address of the protocol that facilitated the event.

items.dex_details.protocol_logo_url

string

The protocol logo URL.

items.dex_details.aggregator_name

string

Stores the aggregator responsible for the event.

items.dex_details.aggregator_address

string

Stores the contract address of the aggregator responsible for the event.

items.dex_details.version

integer

DEXs often have multiple version - e.g Uniswap V1, V2 and V3. The version field allows you to look at a specific version of the DEX.

items.dex_details.fork_version

integer

Similarly to the version field, fork_version gives you the version of the forked DEX. For example, most DEXs are a fork of Uniswap V2; therefore, fork = aave & fork_version = 2

items.dex_details.fork

string

Many DEXs are a fork of an already established DEX. The fork field allows you to see which DEX has been forked.

items.dex_details.event

string

Stores the event taking place - e.g swap, add_liquidity and remove_liquidity.

items.dex_details.pair_address

string

Stores the address of the pair that the user interacts with.

items.dex_details.pair_lp_fee_bps

number

items.dex_details.lp_token_address

string

items.dex_details.lp_token_ticker

string

items.dex_details.lp_token_num_decimals

integer

items.dex_details.lp_token_name

string

items.dex_details.lp_token_value

string

items.dex_details.exchange_rate_usd

number

items.dex_details.token_0_address

string

Stores the address of token 0 in the specific pair.

items.dex_details.token_0_ticker

string

Stores the ticker symbol of token 0 in the specific pair.

items.dex_details.token_0_num_decimals

integer

Stores the number of contract decimals of token 0 in the specific pair.

items.dex_details.token_0_name

string

Stores the contract name of token 0 in the specific pair.

items.dex_details.token_1_address

string

Stores the address of token 1 in the specific pair.

items.dex_details.token_1_ticker

string

Stores the ticker symbol of token 1 in the specific pair.

items.dex_details.token_1_num_decimals

integer

Stores the number of contract decimals of token 1 in the specific pair.

items.dex_details.token_1_name

string

Stores the contract name of token 1 in the specific pair.

items.dex_details.token_0_amount

string

Stores the amount of token 0 used in the transaction. For example, 1 ETH, 100 USDC, 30 UNI, etc.

items.dex_details.token_0_quote_rate

number

items.dex_details.token_0_usd_quote

number

items.dex_details.pretty_token_0_usd_quote

string

items.dex_details.token_0_logo_url

string

items.dex_details.token_1_amount

string

Stores the amount of token 1 used in the transaction. For example, 1 ETH, 100 USDC, 30 UNI, etc.

items.dex_details.token_1_quote_rate

number

items.dex_details.token_1_usd_quote

number

items.dex_details.pretty_token_1_usd_quote

string

items.dex_details.token_1_logo_url

string

items.dex_details.sender

string

Stores the wallet address that initiated the transaction (i.e the wallet paying the gas fee).

items.dex_details.recipient

string

Stores the recipient of the transaction - recipients can be other wallets or smart contracts. For example, if you want to Swap tokens on Uniswap, the Uniswap router would typically be the recipient of the transaction.

items.nft_sale_details

object[]

The details for the NFT sale transaction.

items.nft_sale_details.log_offset

integer

The offset is the position of the log entry within an event log.

items.nft_sale_details.topic0

string

Stores the topic event hash. All events have a unique topic event hash.

items.nft_sale_details.protocol_contract_address

string

Stores the contract address of the protocol that facilitated the event.

items.nft_sale_details.protocol_name

string

Stores the name of the protocol that facilitated the event.

items.nft_sale_details.protocol_logo_url

string

The protocol logo URL.

items.nft_sale_details.to

string

Stores the address of the transaction recipient.

items.nft_sale_details.from

string

Stores the address of the transaction sender.

items.nft_sale_details.maker

string

Stores the address selling the NFT.

items.nft_sale_details.taker

string

Stores the address buying the NFT.

items.nft_sale_details.token_id

string

Stores the NFTs token ID. All NFTs have a token ID. Within a collection, these token IDs are unique. If the NFT is transferred to another owner, the token id remains the same, as this number is its identifier within a collection. For example, if a collection has 10K NFTs then an NFT in that collection can have a token ID from 1-10K.

items.nft_sale_details.collection_address

string

Stores the address of the collection. For example, Bored Ape Yacht Club

items.nft_sale_details.collection_name

string

Stores the name of the collection.

items.nft_sale_details.token_address

string

Stores the address of the token used to purchase the NFT.

items.nft_sale_details.token_name

string

Stores the name of the token used to purchase the NFT.

items.nft_sale_details.ticker_symbol

string

Stores the ticker symbol of the token used to purchase the NFT.

items.nft_sale_details.num_decimals

integer

Stores the number decimal of the token used to purchase the NFT.

items.nft_sale_details.contract_quote_rate

number

items.nft_sale_details.nft_token_price

number

The token amount used to purchase the NFT. For example, if the user purchased an NFT for 1 ETH. The nft_token_price field will hold 1.

items.nft_sale_details.nft_token_price_usd

number

The USD amount used to purchase the NFT.

items.nft_sale_details.pretty_nft_token_price_usd

string

items.nft_sale_details.nft_token_price_native

number

The price of the NFT denominated in the chains native token. Even if a seller sells their NFT for DAI or MANA, this field denominates the price in the native token (e.g. ETH, AVAX, FTM, etc.)

items.nft_sale_details.pretty_nft_token_price_native

string

items.nft_sale_details.token_count

integer

Stores the number of NFTs involved in the sale. It's quick routine to see multiple NFTs involved in a single sale.

items.nft_sale_details.num_token_ids_sold_per_sale

integer

items.nft_sale_details.num_token_ids_sold_per_tx

integer

items.nft_sale_details.num_collections_sold_per_sale

integer

items.nft_sale_details.num_collections_sold_per_tx

integer

items.nft_sale_details.trade_type

string

items.nft_sale_details.trade_group_type

string

items.lending_details

object[]

The details for the lending protocol transaction.

items.lending_details.log_offset

integer

The offset is the position of the log entry within an event log.

items.lending_details.protocol_name

string

Stores the name of the lending protocol that facilitated the event.

items.lending_details.protocol_address

string

Stores the contract address of the lending protocol that facilitated the event.

items.lending_details.protocol_logo_url

string

The protocol logo URL.

items.lending_details.version

string

Lending protocols often have multiple version (e.g. Aave V1, V2 and V3). The version field allows you to look at a specific version of the Lending protocol.

items.lending_details.fork

string

Many lending protocols are a fork of an already established protocol. The fork column allows you to see which lending protocol has been forked.

items.lending_details.fork_version

string

Similarly to the version column, fork_version gives you the version of the forked lending protocol. For example, most lending protocols in the space are a fork of Aave V2; therefore, fork = aave & fork_version = 2

items.lending_details.event

string

Stores the event taking place - e.g borrow, deposit, liquidation, 'repay' and 'withdraw'.

items.lending_details.lp_token_name

string

Stores the name of the LP token issued by the lending protocol. LP tokens can be debt or interest bearing tokens.

items.lending_details.lp_decimals

integer

Stores the number decimal of the LP token.

items.lending_details.lp_ticker_symbol

string

Stores the ticker symbol of the LP token.

items.lending_details.lp_token_address

string

Stores the token address of the LP token.

items.lending_details.lp_token_amount

number

Stores the amount of LP token used in the event (e.g. 1 aETH, 100 cUSDC, etc).

items.lending_details.lp_token_price

number

Stores the total USD amount of all the LP Token used in the event.

items.lending_details.exchange_rate

number

Stores the exchange rate between the LP and underlying token.

items.lending_details.exchange_rate_usd

number

Stores the USD price of the LP Token used in the event.

items.lending_details.token_name_in

string

Stores the name of the token going into the lending protocol (e.g the token getting deposited).

items.lending_details.token_decimal_in

integer

Stores the number decimal of the token going into the lending protocol.

items.lending_details.token_address_in

string

Stores the address of the token going into the lending protocol.

items.lending_details.token_ticker_in

string

Stores the ticker symbol of the token going into the lending protocol.

items.lending_details.token_logo_in

string

Stores the logo URL of the token going into the lending protocol.

items.lending_details.token_amount_in

number

Stores the amount of tokens going into the lending protocol (e.g 1 ETH, 100 USDC, etc).

items.lending_details.amount_in_usd

number

Stores the total USD amount of all tokens going into the lending protocol.

items.lending_details.pretty_amount_in_usd

string

items.lending_details.token_name_out

string

Stores the name of the token going out of the lending protocol (e.g the token getting deposited).

items.lending_details.token_decimals_out

integer

Stores the number decimal of the token going out of the lending protocol.

items.lending_details.token_address_out

string

Stores the address of the token going out of the lending protocol.

items.lending_details.token_ticker_out

string

Stores the ticker symbol of the token going out of the lending protocol.

items.lending_details.token_logo_out

string

Stores the logo URL of the token going out of the lending protocol.

items.lending_details.token_amount_out

number

Stores the amount of tokens going out of the lending protocol (e.g 1 ETH, 100 USDC, etc).

items.lending_details.amount_out_usd

number

Stores the total USD amount of all tokens going out of the lending protocol.

items.lending_details.pretty_amount_out_usd

string

items.lending_details.borrow_rate_mode

number

Stores the type of loan the user is taking out. Lending protocols enable you to take out a stable or variable loan. Only relevant to borrow events.

items.lending_details.borrow_rate

number

Stores the interest rate of the loan. Only relevant to borrow events.

items.lending_details.on_behalf_of

string

items.lending_details.liquidator

string

Stores the wallet address liquidating the loan. Only relevant to liquidation events.

items.lending_details.user

string

Stores the wallet address of the user initiating the event.

items.log_events

object[]

The log events.

items.safe_details

object[]

The details related to the safe transaction.

Get recent transactions for address (v3)Get bulk time bucket transactions for address (v3)

API Reference

Cross Chain

Balances

Transactions

NFT

Security

Bitcoin

Utility

Get paginated transactions for address (v3)

Path Parameters

Query Parameters

Response