Retrieve the transaction history for a wallet address. This endpoint returns a paginated list of transactions including transfers, swaps, and other on-chain activity.
Transaction history is currently only supported for embedded wallets on Solana mainnet (network ID 101). Responses are cached for 5 seconds.
Parameters
| Parameter | Type | Required | Description |
|---|
| chainName | string | Yes | The blockchain type (SOL for Solana) |
| address | string | Yes | The wallet address to fetch transactions for |
| networkId | number | Yes | The network ID (101 for Solana 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 |
| 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 |
| 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 |
| metadata | object | Token metadata (name, symbol, decimals, imageUri) |
React
React Native
JavaScript SDK
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>
);
};
import { dynamicClient } from "./dynamic";
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;
};
}[];
}
interface TransactionsResponse {
transactions: Transaction[];
nextOffset?: string;
}
export async function getWalletTransactions(
address: string,
networkId: number,
limit?: number,
offset?: string
): Promise<TransactionsResponse> {
const token = dynamicClient.auth.token;
if (!token) {
throw new Error("User not authenticated");
}
const params = new URLSearchParams({
networkId: networkId.toString(),
});
if (limit) params.append("limit", limit.toString());
if (offset) params.append("offset", offset);
const response = await fetch(
`https://app.dynamic.xyz/api/v0/sdk/${process.env.DYNAMIC_ENVIRONMENT_ID}/chains/SOL/transactions/${address}?${params}`,
{
headers: {
Authorization: `Bearer ${token}`,
},
}
);
if (!response.ok) {
throw new Error(`Failed to fetch transactions: ${response.statusText}`);
}
return response.json();
}
// Usage example
async function fetchMyTransactions() {
const wallet = dynamicClient.wallets.primary;
if (!wallet) return;
const { transactions, nextOffset } = await getWalletTransactions(
wallet.address,
101, // Solana mainnet
10
);
console.log("Transactions:", transactions);
// Fetch next page if available
if (nextOffset) {
const nextPage = await getWalletTransactions(
wallet.address,
101,
10,
nextOffset
);
console.log("Next page:", nextPage.transactions);
}
}
import { getAuthToken } from "@dynamic-labs/sdk-react-core";
interface Transaction {
transactionHash: string;
blockNumber: number;
transactionTimestamp: string;
fromAddress: string;
toAddress: string;
labels: ("sent" | "receive" | "swap")[];
blockExplorerUrls: string[];
assetTransfers: {
tokenAddress?: string;
fromAddress: string;
toAddress: string;
amount: number;
metadata?: {
name?: string;
symbol?: string;
decimals?: number;
imageUri?: string;
};
}[];
chainName: string;
networkId: number;
}
interface GetWalletTransactionsParams {
environmentId: string;
address: string;
networkId: number;
limit?: number;
offset?: string;
authToken: string;
}
interface TransactionsResponse {
transactions: Transaction[];
nextOffset?: string;
}
export async function getWalletTransactions({
environmentId,
address,
networkId,
limit,
offset,
authToken,
}: GetWalletTransactionsParams): Promise<TransactionsResponse> {
const params = new URLSearchParams({
networkId: networkId.toString(),
});
if (limit) params.append("limit", limit.toString());
if (offset) params.append("offset", offset);
const response = await fetch(
`https://app.dynamic.xyz/api/v0/sdk/${environmentId}/chains/SOL/transactions/${address}?${params}`,
{
headers: {
Authorization: `Bearer ${authToken}`,
},
}
);
if (!response.ok) {
throw new Error(`Failed to fetch transactions: ${response.statusText}`);
}
return response.json();
}
// Example: Fetch all transactions with pagination
export async function getAllTransactions(
environmentId: string,
address: string,
networkId: number,
authToken: string
): Promise<Transaction[]> {
const allTransactions: Transaction[] = [];
let offset: string | undefined;
do {
const response = await getWalletTransactions({
environmentId,
address,
networkId,
limit: 100,
offset,
authToken,
});
allTransactions.push(...response.transactions);
offset = response.nextOffset;
} while (offset);
return allTransactions;
}
