What you can ask
How it works
get_transaction_history returns transactions in reverse chronological order (newest first) for your Base Account or an in-session agent wallet. Third-party wallet addresses are rejected.
| Parameter | What it does |
|---|---|
address | Optional wallet address to query — must be your Base Account or one of your agent wallets |
chain | Required network to query, e.g. base, arbitrum, ethereum, optimism, polygon, bsc, or avalanche |
asset | Filter to a specific token (e.g. USDC, ETH) |
limit | Number of transactions per page (1–200, default 50) |
cursor | Pagination cursor from the previous response’s nextCursor |
Date range filtering is not supported — paginate through results to find transactions from a specific period.
Pagination
WhenhasMore is true in the response, more transactions exist. Ask your assistant to load more:
nextCursor value from the previous response automatically.
Related guides
Check balance
View current balances alongside history.
Send tokens
Send tokens from your connected wallet.