Skip to main content
Glama

Moralis MCP Server

Official
by MoralisWeb3

evm_gethistoricaltokenholders

Analyze historical ERC20 token holder dynamics by tracking total holders, distribution changes, and acquisition trends over specified timeframes. Use this tool to retrieve timeseries data for actionable insights on token holder behavior.

Instructions

Track changes in the holder base of an ERC20 token over time. Supports timeseries data for total holders as well as change metrics such as holder distribution and holder acquisition.

Input Schema

NameRequiredDescriptionDefault
chainNoThe chain to queryeth
cursorNoThe cursor returned in the previous response (used for getting the next page)
fromDateYesThe starting date (format in seconds or datestring accepted by momentjs)
limitNoThe number of results to return
timeFrameYesThe time frame to group the data by1min
toDateYesThe ending date (format in seconds or datestring accepted by momentjs)
tokenAddressYesThe token address

Input Schema (JSON Schema)

{ "properties": { "chain": { "default": "eth", "description": "The chain to query", "enum": [ "eth", "0x1", "sepolia", "0xaa36a7", "polygon", "0x89", "bsc", "0x38", "bsc testnet", "0x61", "avalanche", "0xa86a", "fantom", "0xfa", "cronos", "0x19", "arbitrum", "0xa4b1", "chiliz", "0x15b38", "chiliz testnet", "0x15b32", "gnosis", "0x64", "gnosis testnet", "0x27d8", "base", "0x2105", "base sepolia", "0x14a34", "optimism", "0xa", "holesky", "0x4268", "polygon amoy", "0x13882", "linea", "0xe708", "moonbeam", "0x504", "moonriver", "0x505", "moonbase", "0x507", "linea sepolia", "0xe705", "flow", "0x2eb", "flow-testnet", "0x221", "ronin", "0x7e4", "ronin-testnet", "0x7e5", "lisk", "0x46f", "lisk-sepolia", "0x106a", "pulse", "0x171" ], "type": "string" }, "cursor": { "description": "The cursor returned in the previous response (used for getting the next page)", "type": "string" }, "fromDate": { "description": "The starting date (format in seconds or datestring accepted by momentjs)\n", "type": "string" }, "limit": { "description": "The number of results to return", "minimum": 0, "type": "number" }, "timeFrame": { "default": "1min", "description": "The time frame to group the data by", "enum": [ "1min", "5min", "10min", "30min", "1h", "4h", "12h", "1d", "1w", "1m" ], "type": "string" }, "toDate": { "description": "The ending date (format in seconds or datestring accepted by momentjs)\n", "type": "string" }, "tokenAddress": { "description": "The token address", "type": "string" } }, "required": [ "tokenAddress", "fromDate", "toDate", "timeFrame" ], "type": "object" }

Other Tools from Moralis MCP Server

Related Tools

    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/MoralisWeb3/moralis-mcp-server'

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