get_history
Get transaction history for a wallet from block explorer APIs.
Tier: Free
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Wallet address (0x…) |
chainId | number | No | Chain ID (default: 1) |
type | string | No | Filter: “all”, “swap”, “transfer”, “approval”, “bridge” |
limit | number | No | Max results (default: 20, max: 100) |
Example
"Show me the last 10 swap transactions for 0xd8dA... on Ethereum"Response
Returns chronological list of transactions with:
- Timestamp
- Direction (IN/OUT)
- Transaction type (swap/transfer/approval/bridge)
- Value in native token
- Function name
- Transaction hash
Implementation
Uses Etherscan/BSCScan/Arbiscan/Basescan/Polygonscan APIs. Classifies transactions by function name (swap, approve, bridge, transfer). Results cached for 1 minute.
Notes
- Requires explorer API key for the target chain
- Etherscan API key works for Arbiscan and Basescan too