Getting Transaction History

You can retrieve the transaction history for a wallet address by calling the getTransactionHistory function.

This function fetches the transaction history for a specified wallet address and chain, returning a list of transactions along with a nextOffset for pagination.

Transaction history is supported for embedded wallets on Aptos, Bitcoin, EVM, Solana, Stellar, Sui, TON, and Tron networks. Responses are cached for 5 seconds.

Solana: mainnet (network ID 101) and devnet (network ID 103). For devnet, we only retain 2 weeks of transaction history.

EVM supported networks:

Network	Mainnet ID	Testnet ID
Ethereum	1	11155111 (Sepolia)
Optimism	10	11155420 (Sepolia)
Rootstock	30	31
BNB Smart Chain	56	97
Gnosis	100	10200 (Chiado)
Unichain	130	1301 (Sepolia)
Polygon	137	80001 (Mumbai), 80002 (Amoy)
zkSync Era	324	300 (Sepolia)
Shape	360	11011 (Sepolia)
World Chain	480	4801 (Sepolia)
Hyperliquid	999	998
Story	1514	1315 (Aeneid)
Soneium	1868	1946 (Minato)
Ronin	2020	202601 (Saigon)
Abstract	2741	11124
ApeChain	33139	33111 (Curtis)
Arbitrum One	42161	421614 (Sepolia)
Arbitrum Nova	42170	None
Celo	42220	11142220 (Sepolia)
Avalanche	43114	43113 (Fuji)
Robinhood Chain	None	46630
Ink	57073	763373 (Sepolia)
Linea	59144	59141 (Sepolia)
Berachain	80094	80069 (Bepolia)
Blast	81457	168587773 (Sepolia)
Base	8453	84532 (Sepolia)
Scroll	534352	534351 (Sepolia)
Tempo	4217	42429 (testnet), 42431 (Moderato)
Zora	7777777	999999999 (Sepolia)

Supported chains and network IDs:

Chain	chain	Network IDs
Aptos	APTOS	1 (mainnet), 2 (testnet), 3 (devnet)
Bitcoin	BTC	1 (mainnet), 2 (testnet)
EVM	EVM	Numeric chain ID (e.g. 1 for Ethereum, 137 for Polygon), see EVM table above
Solana	SOL	101 (mainnet), 102 (devnet), 103 (testnet)
Stellar	STELLAR	32-byte hex genesis hash: 7ac33997544e3175d266bd022439b22cdb16508c01163f26e5cb2a3e1045a979 (mainnet), cee0302d59844d32bdca915c8203dd44b33fbb7edc19051ea37abedf28ecd472 (testnet), a3a1c6a78286713e29be0e9785670fa838d13917cd8eaeb4a3579ff1debc7fd5 (futurenet)
Sui	SUI	501 (mainnet), 502 (testnet), 503 (devnet)
TON	TON	-239 (mainnet), -3 (testnet)
Tron	TRON	728126428 (mainnet)

Usage

import { getTransactionHistory } from '@dynamic-labs-sdk/client';

const { transactions, nextOffset } = await getTransactionHistory({
  address: 'CKEAuq1E7hUcrjDcu1xP6nax3YBvEhhq7qaCzDUkPNer',
  chain: 'SOL',
  networkId: 101, // Solana mainnet
  limit: 10,
});

console.log(transactions);

// Fetch next page if available
if (nextOffset) {
  const nextPage = await getTransactionHistory({
    address: 'CKEAuq1E7hUcrjDcu1xP6nax3YBvEhhq7qaCzDUkPNer',
    chain: 'SOL',
    networkId: 101,
    limit: 10,
    offset: nextOffset,
  });
}

Filtering by token

Pass tokenAddress to limit results to a single token. Use the EVM contract address for ERC-20 tokens or the SPL mint address for Solana tokens. For native assets, use 0x0000000000000000000000000000000000000000 on EVM or the wrapped SOL mint So11111111111111111111111111111111111111112 for native SOL transfers.

import { getTransactionHistory } from '@dynamic-labs-sdk/client';

// EVM: filter by USDC contract on Ethereum mainnet
const usdcHistory = await getTransactionHistory({
  address: '0x5C260969b90152a46D52BC476C94524C8E796b3d',
  chain: 'EVM',
  networkId: 1,
  tokenAddress: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
});

// Solana: filter by USDC SPL mint on mainnet
const splHistory = await getTransactionHistory({
  address: 'CKEAuq1E7hUcrjDcu1xP6nax3YBvEhhq7qaCzDUkPNer',
  chain: 'SOL',
  networkId: 101,
  tokenAddress: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
});

React

useGetTransactionHistory loads the first page reactively. Because it’s keyed on the request, load additional pages on demand by calling getTransactionHistory directly in the handler:

import { getTransactionHistory } from '@dynamic-labs-sdk/client';
import { useGetTransactionHistory } from '@dynamic-labs-sdk/react-hooks';
import { useState } from 'react';

function TransactionHistory({ address }) {
  const { data: history } = useGetTransactionHistory({
    address,
    chain: 'SOL',
    networkId: 101,
    limit: 10,
  });

  const [extraPages, setExtraPages] = useState([]);
  const [nextOffset, setNextOffset] = useState(null);

  const firstPage = history?.transactions ?? [];
  const transactions = [...firstPage, ...extraPages];

  const loadMore = async () => {
    const offset = nextOffset ?? history?.nextOffset;
    if (!offset) return;
    const page = await getTransactionHistory({
      address,
      chain: 'SOL',
      networkId: 101,
      limit: 10,
      offset,
    });
    setExtraPages((prev) => [...prev, ...page.transactions]);
    setNextOffset(page.nextOffset);
  };

  return (
    <div>
      <ul>
        {transactions.map((tx) => (
          <li key={tx.transactionHash}>{tx.transactionHash}</li>
        ))}
      </ul>
      {(nextOffset ?? data?.nextOffset) && (
        <button onClick={loadMore}>Load more</button>
      )}
    </div>
  );
}

Parameters

Parameter	Type	Required	Description
address	String	Yes	The wallet address to fetch transactions for
chain	Chain	Yes	The chain to query transactions for (see table above)
networkId	String | Number	Yes	The network ID for the chain (see table above)
limit	Number	No	Maximum number of transactions to return
offset	String	No	Pagination offset from previous response
tokenAddress	String	No	Token contract address to filter by. Only supported for EVM and Solana. Use 0x0000000000000000000000000000000000000000 for EVM native tokens or So11111111111111111111111111111111111111112 for native SOL.

Response

The function returns a Promise that resolves to an object containing:

Property	Type	Description
transactions	Array	List of transaction objects
nextOffset	String	Offset to fetch the next page of transactions

Transaction object

Each transaction object contains:

Property	Type	Description
transactionHash	String	The transaction hash
blockNumber	Number	Block number of the transaction
transactionTimestamp	String	ISO 8601 timestamp of the transaction
blockHash	String	Hash of the block containing the transaction
blockExplorerUrls	String[]	URLs to view the transaction on block explorers
fromAddress	String	Sender address
toAddress	String	Recipient address
labels	String[]	Direction of the transaction: sent, received, or swap. EVM events may also include an asset-category label (e.g. token) alongside the direction
assetTransfers	Array	Details of assets transferred in the transaction
chainName	String	The blockchain type
networkId	Number	The network ID
transactionType	String	Enhanced transaction type (e.g., TRANSFER, SWAP). Only present for Solana transactions.
source	String	The program or protocol that originated the transaction (e.g., SYSTEM_PROGRAM, JUPITER). Only present for Solana transactions.
description	String	Human-readable description of the transaction. Only present for Solana transactions.
spam	Boolean	Whether the transaction is likely spam (e.g., dust attacks). Only present for Solana transactions.

Asset transfer object

Each asset transfer contains:

Property	Type	Description
tokenAddress	String	Contract address of the token (empty for native tokens)
fromAddress	String	Sender address for this transfer
toAddress	String	Recipient address for this transfer
amount	Number	Amount transferred in the token’s smallest unit (e.g., lamports for SOL, raw units for SPL tokens). Use metadata.decimals to convert to a human-readable value.
metadata	Object	Token metadata (name, symbol, decimals, imageUri)

Related functions

• Getting Native Balance
• Getting Multichain Token Balances
• Getting Wallet Accounts