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
Name | Required | Description | Default |
---|---|---|---|
chain | No | The chain to query | eth |
cursor | No | The cursor returned in the previous response (used for getting the next page) | |
fromDate | Yes | The starting date (format in seconds or datestring accepted by momentjs) | |
limit | No | The number of results to return | |
timeFrame | Yes | The time frame to group the data by | 1min |
toDate | Yes | The ending date (format in seconds or datestring accepted by momentjs) | |
tokenAddress | Yes | The token address |