Transaction History

Get the transaction history for the agent session. These are reflected in in/out asset changes. A swap would result in 2 records being returned in this method.

List Transactions

Get transaction history with asset changes.

TypeScript

async transactions(): Promise<TransactionsResponse>

Python

Response:

• success (boolean): Whether the operation succeeded

• data (array): Array of asset changes

  • network (string): Network identifier

  • transactionHash (string): Transaction hash

  • from / from_ (string): Sender address

  • to (string): Recipient address

  • amount (string): Amount transferred (string to preserve precision)

  • token (string | null): Token contract address (null for native tokens)

  • tokenId (string | null): Token ID for NFTs (null for fungible tokens)

  • tokenType (string): Token type ("native", "ERC20", "ERC721", etc.)

  • tokenUsdPrice (string | null): Token price in USD at transaction time

  • timestamp (string): Transaction timestamp

• error (string | null): Error message (on failure)

Example:

TypeScript

const result = await agent.transactions();
if (result.success && result.data) {
  await agent.log(`Found ${result.data.length} asset changes`);
  
  const outgoing = result.data.filter(
    change => change.from === agent.sessionWalletAddress
  );
  await agent.log(`Outgoing transfers: ${outgoing.length}`);
}

Python

Notes

• Indexing speed varies by chain and may have a delay, so new transactions may not appear here immediately.

• Amounts are strings to preserve precision for large numbers.

• Network format: "ethereum:chainId" for EVM chains, "solana" for Solana, "hypercore:perp" and "hypercore:spot" for Hyperliquid