get_token_dump_risk
Evaluate token unlock and vesting supply overhang risk before taking positions, with unlock date, supply ratio, and sell-pressure score vs. real-time volume.
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/vesting supply overhang risk before
taking mid-to-long term positions. Default data source (on-chain Sablier
vesting, the current configuration - no DropsTab key set) does NOT classify
VC/team vs. other holders and does NOT provide exact unlock timing
(days_until_unlock stays null) - it only reports the currently-locked
supply ratio; treat a null value as "unknown," never as "no risk." On this
on-chain path it also reports vesting_deposit_amount/vesting_withdrawn_amount
(Sablier's own depositAmount/withdrawnAmount, aggregated across streams) and
vesting_progress_pct (withdrawn/deposit * 100) showing how far along the
vesting schedule already is - null when deposit data wasn't available. 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",
"vesting_progress_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 |