Skip to main content

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:
NetworkMainnet IDTestnet ID
Ethereum111155111 (Sepolia)
Optimism1011155420 (Sepolia)
Rootstock3031
BNB Smart Chain5697
Gnosis10010200 (Chiado)
Unichain1301301 (Sepolia)
Polygon13780001 (Mumbai), 80002 (Amoy)
zkSync Era324300 (Sepolia)
Shape36011011 (Sepolia)
World Chain4804801 (Sepolia)
Hyperliquid999998
Story15141315 (Aeneid)
Soneium18681946 (Minato)
Ronin2020202601 (Saigon)
Abstract274111124
ApeChain3313933111 (Curtis)
Arbitrum One42161421614 (Sepolia)
Arbitrum Nova42170—
Celo4222011142220 (Sepolia)
Avalanche4311443113 (Fuji)
Robinhood Chain—46630
Ink57073763373 (Sepolia)
Linea5914459141 (Sepolia)
Berachain8009480069 (Bepolia)
Blast81457168587773 (Sepolia)
Base845384532 (Sepolia)
Scroll534352534351 (Sepolia)
Tempo421742429 (testnet), 42431 (Moderato)
Zora7777777999999999 (Sepolia)
Supported chains and network IDs:
ChainchainNameNetwork IDs
AptosAPTOS1 (mainnet), 2 (testnet), 3 (devnet)
BitcoinBTC1 (mainnet), 2 (testnet)
EVMEVMNumeric chain ID (e.g. 1 for Ethereum, 137 for Polygon) — see EVM table above
SolanaSOL101 (mainnet), 102 (devnet), 103 (testnet)
StellarSTELLAR32-byte hex genesis hash — 7ac33997544e3175d266bd022439b22cdb16508c01163f26e5cb2a3e1045a979 (mainnet), cee0302d59844d32bdca915c8203dd44b33fbb7edc19051ea37abedf28ecd472 (testnet), a3a1c6a78286713e29be0e9785670fa838d13917cd8eaeb4a3579ff1debc7fd5 (futurenet)
SuiSUI501 (mainnet), 502 (testnet), 503 (devnet)
TONTON-239 (mainnet), -3 (testnet)
TronTRON728126428 (mainnet)

​
Parameters

ParameterTypeRequiredDescription
chainNamestringYesThe blockchain type (e.g. SOL, EVM, BTC) — see table above
addressstringYesThe wallet address to fetch transactions for
networkIdstringYesThe network ID for the chain — see table above
limitnumberNoNumber of transactions to return (1-100)
offsetstringNoPagination offset from previous response
tokenAddressstringNoToken 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:
PropertyTypeDescription
transactionsarrayList of transaction objects
nextOffsetstringOffset to fetch the next page of transactions
Each transaction object contains:
PropertyTypeDescription
transactionHashstringThe transaction hash
blockNumbernumberBlock number of the transaction
transactionTimestampstringISO 8601 timestamp of the transaction
blockHashstringHash of the block containing the transaction
blockExplorerUrlsstring[]URLs to view the transaction on block explorers
fromAddressstringSender address
toAddressstringRecipient address
labelsstring[]Transaction type labels: sent, receive, or swap
assetTransfersarrayDetails of assets transferred in the transaction
chainNamestringThe blockchain type
networkIdnumberThe network ID
transactionTypestringEnhanced transaction type (e.g., TRANSFER, SWAP). Only present for Solana transactions.
sourcestringThe program or protocol that originated the transaction (e.g., SYSTEM_PROGRAM, JUPITER). Only present for Solana transactions.
descriptionstringHuman-readable description of the transaction. Only present for Solana transactions.
spambooleanWhether the transaction is likely spam (e.g., dust attacks). Only present for Solana transactions.
Each asset transfer contains:
PropertyTypeDescription
tokenAddressstringContract address of the token (empty for native tokens)
fromAddressstringSender address for this transfer
toAddressstringRecipient address for this transfer
amountnumberAmount 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.
metadataobjectToken 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.
Last modified on July 2, 2026