Skip to main content

​
Transaction Activity

Returns transaction history with decoded function calls, balance changes, and contract creations.

​
Returns

  • Function names and decoded parameters
  • Balance changes per transaction
  • Contract creations
  • Paginated history (10 per page)

​
Example Queries

Show me the recent transactions from 0x...

What has this wallet been doing lately?

Get the transaction history for vitalik.eth

​
Parameters

ParameterRequiredDescription
fromAddressYesThe address to get activity for
toAddressNoFilter to specific destination
blockchainNoethereum (default) or base
pageNoPage number (default: 1, 10 txs per page)

​
Example Output

Transaction Activity for 0xUser...
Page 1 of 15 (10 transactions per page)

1. 2024-01-15 14:32:00
   Function: swap(...)
   To: Uniswap V3 Router
   Balance Changes:
     - Sent: 1,000 USDC
     - Received: 0.35 WETH
   Gas: $4.52

2. 2024-01-15 10:15:00
   Function: approve(...)
   To: USDC Contract
   Balance Changes: None
   Gas: $2.11

3. 2024-01-14 22:45:00
   Function: deposit(...)
   To: Aave V3 Pool
   Balance Changes:
     - Sent: 5,000 USDC
     - Received: 5,000 aUSDC
   Gas: $6.78

...

​
Filtering by Destination

To see only interactions with a specific contract: You: “Show me all transactions from 0xUser to Uniswap” This uses the toAddress parameter to filter results.

​
Use Cases

Wallet investigation: 
What has this wallet been doing in the last week?
Protocol usage: 
How does this user interact with Aave?
Trading analysis: 
Show me the trading activity of this MEV bot

​
Pagination

For addresses with many transactions: You: “Show me page 3 of transactions for 0x…” 
Transaction Activity for 0xUser...
Page 3 of 15

21. 2024-01-10 ...
22. 2024-01-10 ...
...
30. 2024-01-09 ...

Showing transactions 21-30 of ~150

​
Balance Changes Explained

Each transaction shows what moved: 
Balance Changes:
  - Sent: 1,000 USDC (to 0xPool)
  - Received: 0.35 WETH (from 0xPool)
  - Received: 50 UNI (airdrop claim)
Only shows balance changes where the queried address is the holder. For complete transaction breakdown, use queryTransactionTool.

​
Contract Creations

When an address deploys contracts: 
Transaction: 0xabc...
Type: Contract Creation
Created: 0xNewContract (MyToken)
Verified: Yes

​
Common Use Cases

“Give me an overview of this wallet’s activity over the past month”
“When did this wallet last interact with Compound?”
“What DEXs does this wallet use most?”
“What contracts has this deployer wallet created?”

​
Combining with Other Tools

For comprehensive analysis:
  1. Get wallet overview → getWalletOverviewTool
  2. Check transaction history → getTransactionActivityTool
  3. Deep dive specific tx → queryTransactionTool
  4. Check token holdings → getTokenActivityTool

​
Tips

Filter when possible—use toAddress to focus on specific protocols.
Ask for summaries: “Summarize this wallet’s DeFi activity”

​
Limitations

10 transactions per page. Use pagination for full history.
Only shows outgoing context. Balance changes are relative to the fromAddress. Use queryTransactionTool for complete transaction details.

​
Next Steps

Query Transaction

Get full details on any transaction

Wallet Overview

Get complete wallet profile