Token Unlock Alert System Development
Token unlock — one of the most predictable sources of price pressure in crypto. When team, investors or advisors see large cliff coming to their wallet — it's a known event in advance. Problem: most market participants learn about it after the fact, from news, when price already fell.
Token unlock alert system solves simple task: give subscriber information before event, not after.
What We Monitor and Where Data Comes From
Three main sources: on-chain data from vesting contracts, off-chain schedules from databases (TokenUnlocks, Vesting.vc, CryptoRank) and analytics from original documents (whitepaper, tokenomics sheets).
On-chain monitoring — most reliable way for projects with transparent vesting contracts. Standard patterns: OpenZeppelin VestingWallet, TokenVesting from Gnosis, custom implementations with release() function.
// Example tracking VestingWallet events via ethers.js
const vestingABI = [
"event ERC20Released(address indexed token, uint256 amount)",
"function releasable(address token) view returns (uint256)",
"function end() view returns (uint256)"
];
async function checkUpcomingUnlocks(vestingAddresses, tokenAddress, provider) {
const alerts = [];
const now = Math.floor(Date.now() / 1000);
const sevenDaysFromNow = now + 7 * 24 * 3600;
for (const addr of vestingAddresses) {
const contract = new ethers.Contract(addr, vestingABI, provider);
try {
const endTime = await contract.end();
const releasable = await contract.releasable(tokenAddress);
// If there's releasable volume and it's coming soon
if (releasable > 0n && Number(endTime) <= sevenDaysFromNow) {
alerts.push({
vestingContract: addr,
unlockAmount: ethers.formatUnits(releasable, 18),
unlockTimestamp: Number(endTime),
daysUntilUnlock: (Number(endTime) - now) / 86400
});
}
} catch (e) {
// Contract doesn't implement interface — skip
}
}
return alerts;
}
Alert Structure and Delivery Channels
Alert contains minimally necessary context: project, unlock volume in tokens and dollars (at current price), recipient category (team/investors/ecosystem), date and time in UTC, link to on-chain source.
Delivery channels: Telegram bot (most popular), Email, Discord webhook, REST API for integration into third-party dashboards. Priority channel selected by user at subscription.
Significance thresholds worth tuning by % of circulating supply, not absolute volume — 1M token unlock for project with 10B circulating supply insignificant, same volume at 50M circulating supply — 2%, serious event.
Development Timeline
MVP with monitoring top-100 projects by market cap, Telegram + Email alerts and web interface for subscription management takes 6–8 weeks. Full platform with API, support for custom vesting contracts and price impact analytics — 3–4 months.