Skip to main content
Glama

Blockscout MCP Server

Official

get_token_transfers_by_address

Retrieve ERC-20 token transfers for a specific address within a defined time range. Filter by token or paginate results for large datasets to analyze blockchain transaction history efficiently.

Instructions

Get ERC-20 token transfers for an address within a specific time range. Use cases: - `get_token_transfers_by_address(address, age_from)` - get all transfers of any ERC-20 token to/from the address since the given date up to the current time - `get_token_transfers_by_address(address, age_from, age_to)` - get all transfers of any ERC-20 token to/from the address between the given dates - `get_token_transfers_by_address(address, age_from, age_to, token)` - get all transfers of the given ERC-20 token to/from the address between the given dates **SUPPORTS PAGINATION**: If response includes 'pagination' field, use the provided next_call to get additional pages.

Input Schema

NameRequiredDescriptionDefault
addressYesAddress which either transfer initiator or transfer receiver
age_fromNoStart date and time (e.g 2025-05-22T23:00:00.00Z). This parameter should be provided in most cases to limit transfers and avoid heavy database queries. Omit only if you absolutely need the full history.
age_toNoEnd date and time (e.g 2025-05-22T22:30:00.00Z). Can be omitted to get all transfers up to the current time.
chain_idYesThe ID of the blockchain
cursorNoThe pagination cursor from a previous response to get the next page of results.
tokenNoAn ERC-20 token contract address to filter transfers by a specific token. If omitted, returns transfers of all tokens.

Input Schema (JSON Schema)

{ "properties": { "address": { "description": "Address which either transfer initiator or transfer receiver", "title": "Address", "type": "string" }, "age_from": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Start date and time (e.g 2025-05-22T23:00:00.00Z). This parameter should be provided in most cases to limit transfers and avoid heavy database queries. Omit only if you absolutely need the full history.", "title": "Age From" }, "age_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "End date and time (e.g 2025-05-22T22:30:00.00Z). Can be omitted to get all transfers up to the current time.", "title": "Age To" }, "chain_id": { "description": "The ID of the blockchain", "title": "Chain Id", "type": "string" }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "The pagination cursor from a previous response to get the next page of results.", "title": "Cursor" }, "token": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "An ERC-20 token contract address to filter transfers by a specific token. If omitted, returns transfers of all tokens.", "title": "Token" } }, "required": [ "chain_id", "address" ], "title": "get_token_transfers_by_addressArguments", "type": "object" }

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/blockscout/mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server