Skip to main content
Glama

Blockscout MCP Server

Official

get_token_transfers_by_address

Track ERC-20 token transfers for a specific address within defined time ranges. Filter by token contract and paginate results using start and end timestamps for efficient data retrieval.

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 Manipulating `age_from` and `age_to` allows you to paginate through results by time ranges. For example, after getting transfers up to a certain timestamp, you can use that timestamp as `age_to` in the next query to get the next page of older transfers.

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
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" }, "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