Blockscout MCP

get_token_transfers_by_address

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.

Remote blockscout/mcp-server

Other tools also called get_token_transfers_by_address? See providers with this name

Input Schema


            {
  "type": "object",
  "properties": {
    "token": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Token",
      "default": null,
      "description": "An ERC-20 token contract address to filter transfers by a specific token. If omitted, returns transfers of all tokens."
    },
    "age_to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Age To",
      "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."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cursor",
      "default": null,
      "description": "The pagination cursor from a previous response to get the next page of results."
    },
    "address": {
      "type": "string",
      "title": "Address",
      "description": "Address which either transfer initiator or transfer receiver"
    },
    "age_from": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Age From",
      "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."
    },
    "chain_id": {
      "type": "string",
      "title": "Chain Id",
      "description": "The ID of the blockchain"
    }
  }
}