Fetch wallet transactions

Recommended: JavaScript SDK with React Hooks

For new React apps, we recommend the JavaScript SDK with React Hooks (@dynamic-labs-sdk/react-hooks) instead of the legacy React SDK documented here. The JS SDK comes with many benefits such as a much smaller bundle size and other optimizations. Use the React quickstart (JavaScript SDK) to get started.

Retrieve the transaction history for a wallet address. This endpoint returns a paginated list of transactions including transfers, swaps, and other on-chain activity.

Using the JavaScript SDK? See getTransactionHistory for a simpler approach.

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	—
Celo	42220	11142220 (Sepolia)
Avalanche	43114	43113 (Fuji)
Robinhood Chain	—	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	chainName	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)

Parameters

Parameter	Type	Required	Description
chainName	string	Yes	The blockchain type (e.g. SOL, EVM, BTC) — see table above
address	string	Yes	The wallet address to fetch transactions for
networkId	string	Yes	The network ID for the chain — see table above
limit	number	No	Number of transactions to return (1-100)
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 response includes an array of transactions and a nextOffset for pagination:

Property	Type	Description
transactions	array	List of transaction objects
nextOffset	string	Offset to fetch the next page of transactions

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.

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)

import { useDynamicContext } from "@dynamic-labs/sdk-react-core";
import { useEffect, useState } from "react";

interface Transaction {
  transactionHash: string;
  blockNumber: number;
  transactionTimestamp: string;
  fromAddress: string;
  toAddress: string;
  labels: string[];
  blockExplorerUrls: string[];
  assetTransfers: {
    tokenAddress?: string;
    fromAddress: string;
    toAddress: string;
    amount: number;
    metadata?: {
      name?: string;
      symbol?: string;
      decimals?: number;
      imageUri?: string;
    };
  }[];
}

const WalletTransactions = () => {
  const { primaryWallet, authToken } = useDynamicContext();
  const [transactions, setTransactions] = useState<Transaction[]>([]);
  const [loading, setLoading] = useState(false);

  useEffect(() => {
    const fetchTransactions = async () => {
      if (!primaryWallet || !authToken) return;

      setLoading(true);
      try {
        const response = await fetch(
          `https://app.dynamic.xyz/api/v0/sdk/${process.env.NEXT_PUBLIC_DYNAMIC_ENVIRONMENT_ID}/chains/SOL/transactions/${primaryWallet.address}?networkId=101&limit=10`,
          {
            headers: {
              Authorization: `Bearer ${authToken}`,
            },
          }
        );

        const data = await response.json();
        setTransactions(data.transactions);
      } catch (error) {
        console.error("Failed to fetch transactions:", error);
      } finally {
        setLoading(false);
      }
    };

    fetchTransactions();
  }, [primaryWallet, authToken]);

  if (loading) return <div>Loading transactions...</div>;

  return (
    <div>
      <h2>Transaction History</h2>
      {transactions.map((tx) => (
        <div key={tx.transactionHash}>
          <p>Hash: {tx.transactionHash}</p>
          <p>Type: {tx.labels.join(", ")}</p>
          <p>Date: {new Date(tx.transactionTimestamp).toLocaleString()}</p>
          {tx.assetTransfers.map((transfer, i) => (
            <p key={i}>
              {transfer.metadata?.symbol}: {transfer.amount}
            </p>
          ))}
          <a href={tx.blockExplorerUrls[0]} target="_blank" rel="noopener noreferrer">
            View on Explorer
          </a>
        </div>
      ))}
    </div>
  );
};

Using the JavaScript SDK? See getTransactionHistory for a simpler approach.