Fetch wallet transactions

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 Solana and EVM 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)
Zora	7777777	999999999 (Sepolia)

Parameters

Parameter	Type	Required	Description
chainName	string	Yes	The blockchain type (SOL for Solana, EVM for EVM networks)
address	string	Yes	The wallet address to fetch transactions for
networkId	number	Yes	The network ID (e.g., 101 for Solana mainnet, 1 for Ethereum mainnet)
limit	number	No	Number of transactions to return (1-100)
offset	string	No	Pagination offset from previous response

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[]	Transaction type labels: sent, receive, or swap
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.