get_token_dump_risk
Assess token unlock and vesting schedules by calculating D-Day, unlock supply ratio, and sell-pressure score against real-time volume, identifying VC/team dump risk before taking positions.
Instructions
Calculate a token's vesting/unlock D-Day, unlock ratio relative to
circulating supply, and a sell-pressure score against real-time volume,
returned as a concise summary report.
Use this to evaluate token unlock schedules, vesting cliffs, and upcoming
VC/team dump pressure relative to circulating supply before taking mid-to-
long term positions. Do NOT use it for intra-day slippage or real-time
transaction simulation - use dex.liquidity_slippage for that instead. This
tool is free (no payment) as an onboarding check; every other tool here is
a normal read-only call against app/logic.py.
Args:
symbol: Token ticker symbol (e.g. "ATH", "AO", "CPOOL"). Case-insensitive.
Returns:
Success & data available: {"success": true, "available": true, "symbol",
"unlock_date_utc", "days_until_unlock", "unlock_supply_pct",
"volume_impact_pct", "sell_pressure_risk_level", ...}
Success but not yet available:
{"success": true, "available": false, "reason", "message"}
(e.g. the paid data source isn't connected yet, by business decision)
Failure: {"success": false, "error": {"type", "message"}}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes |