get_erc20_transfers
Retrieve ERC-20 token transfer history for an Ethereum address, including direction and amount, with optional filtering by token contract.
Instructions
List ERC-20 token transfer events for an address. Returns token name, symbol, amount (human-readable), direction (IN/OUT), date, and contract address for each transfer. Filter by contract address to track a specific token. Use get_token_balances for current holdings instead.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"address": "<address>"
},
"name": "get_erc20_transfers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | Ethereum address (0x...) to fetch ERC-20 transfers for | |
| contractaddress | No | Optional: filter by a specific ERC-20 token contract address | |
| startblock | No | Starting block number (default 0) | 0 |
| endblock | No | Ending block number (default latest) | 99999999 |
| page | No | Page number (default 1) | 1 |
| offset | No | Number of results per page (default 20, max 10000) | 20 |
| sort | No | Sort order (default desc — newest first) | desc |