Token Holder Monitor
Purpose
Monitor token holder distributions, track whale wallets, and generate alerts for centralization risks and large holder activity across multiple blockchain networks.
Specification
Job: Analyze token holder distribution and identify concentration risks.
Inputs:
contract_address - Token contract address to analyzechain - Blockchain network (ethereum, polygon, arbitrum, optimism, base)min_holders - Minimum number of holders to analyze (optional)
Returns:
holder_count - Total number of token holderswhale_wallets[] - List of top holders with balancesconcentration_metrics - Gini coefficient, HHI index, top 10/100 holder percentagescentralization_risk - Risk level: "low", "medium", "high", "critical"alerts[] - Generated alerts for unusual holder patternslarge_transfers[] - Recent significant holder movements
Acceptance Criteria
✅ Monitors token holder distributions across multiple chains
✅ Identifies whale wallets and large holders
✅ Calculates centralization metrics (Gini coefficient, HHI index)
✅ Generates alerts for concentration risks
✅ Tracks large holder movements and transfers
✅ Response time < 5 seconds
✅ Must be deployed on a domain and reachable via X402
Done When
Agent provides accurate holder distribution analysis with whale identification and centralization risk metrics from blockchain data.
Resources
Submission
Submission is a PR into this repo linking the issue - first in first served if the bounty has been completed.
Token Holder Monitor
Purpose
Monitor token holder distributions, track whale wallets, and generate alerts for centralization risks and large holder activity across multiple blockchain networks.
Specification
Job: Analyze token holder distribution and identify concentration risks.
Inputs:
contract_address- Token contract address to analyzechain- Blockchain network (ethereum, polygon, arbitrum, optimism, base)min_holders- Minimum number of holders to analyze (optional)Returns:
holder_count- Total number of token holderswhale_wallets[]- List of top holders with balancesconcentration_metrics- Gini coefficient, HHI index, top 10/100 holder percentagescentralization_risk- Risk level: "low", "medium", "high", "critical"alerts[]- Generated alerts for unusual holder patternslarge_transfers[]- Recent significant holder movementsAcceptance Criteria
✅ Monitors token holder distributions across multiple chains
✅ Identifies whale wallets and large holders
✅ Calculates centralization metrics (Gini coefficient, HHI index)
✅ Generates alerts for concentration risks
✅ Tracks large holder movements and transfers
✅ Response time < 5 seconds
✅ Must be deployed on a domain and reachable via X402
Done When
Agent provides accurate holder distribution analysis with whale identification and centralization risk metrics from blockchain data.
Resources
Submission
Submission is a PR into this repo linking the issue - first in first served if the bounty has been completed.