Transaction History

​

List Transactions

def transactions() -> TransactionsResponse

async transactions(): Promise<TransactionsResponse>

• success (boolean): Whether the operation succeeded
• data (array): Array of asset changes
  • network (string): Network identifier
  • transactionHash (string): Transaction hash
  • fromAddress (string): Sender address
  • toAddress (string): Recipient address
  • amount (string): Amount transferred (string to preserve precision)
  • tokenAddress (string): Token contract address (canonical native address 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)

result = agent.transactions()
if result.success and result.data:
    agent.log(f"Found {len(result.data)} asset changes")

    outgoing = [c for c in result.data if c.from_address == agent.session_wallet_address]
    agent.log(f"Outgoing transfers: {len(outgoing)}")

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.fromAddress === agent.sessionWalletAddress
  );
  await agent.log(`Outgoing transfers: ${outgoing.length}`);
}

​

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.
• The ledger covers onchain asset changes only: "ethereum:{chainId}" for EVM chains and "solana" for Solana. Hyperliquid trades are not onchain transfers and do not appear here - read live state via agent.platforms.hyperliquid instead.
• Field names above are the TypeScript spellings; Python attributes are snake_case - the sender is fromAddress / from_address, the recipient is toAddress / to_address, and the token contract is tokenAddress / token_address.
• tokenType values: "native", "ERC20", "ERC721", "ERC1155", "SPL".
• tokenUsdPrice may be null if the price was not available at indexing time.

​

See Also

• Positions - Check current balances instead of inferring from history
• Swap - Execute swaps that generate transaction records
• Error Handling - Handle failures in transacting methods that generate history