omni_token_vesting_inflation
Calculate monthly token unlocks, circulating supply inflation, annualized dilution, and market-cap-to-FDV ratio from supply, unlock, and price inputs to assess dilution pressure.
Instructions
Token Vesting Cliff, Unlock Schedule & Circulating Inflation Model. Calculate monthly unlock volume, circulating supply inflation rate, and impending token unlock price pressure for venture-backed Web3 tokens. Discipline: CRYPTO. Governing mathematical model / formula: Monthly Unlock = Total Allocation × (1 - TGE Unlock %) / Vesting Linear Months.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of monthly_supply_inflation_pct (Monthly Supply Inflation Rate), monthly_sell_pressure_usd (Monthly New Dilution Inflow ($)), annualized_inflation_pct (Annualized Supply Dilution), market_cap_to_fdv_ratio (Circulating Mcap / FDV Ratio) using total_token_supply (Total Token Max Supply in Tokens), current_circulating_supply (Current Circulating Supply in Tokens (18%)), monthly_unlock_tokens (Upcoming Monthly Unlock Volume in Tokens/mo), token_price_usd (Current Token Market Price ($)). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Token Vesting Cliff, Unlock Schedule & Circulating Inflation Model' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "token-vesting-inflation"
category (string): "crypto"
name (string): "Token Vesting Cliff, Unlock Schedule & Circulating Inflation Model"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.monthly_supply_inflation_pct (Monthly Supply Inflation Rate): Formatted display string (e.g. '+12.5% / month')
metrics.monthly_sell_pressure_usd (Monthly New Dilution Inflow ($)): Formatted display string (e.g. '$28,125,000 / mo')
metrics.annualized_inflation_pct (Annualized Supply Dilution): Formatted display string (e.g. '150.0% / year')
metrics.market_cap_to_fdv_ratio (Circulating Mcap / FDV Ratio): Formatted display string (e.g. '18.0% (Low Float / High FDV)')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_token_vesting_inflation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token_price_usd | No | Current Token Market Price ($). Token exchange price. Default: 1.25. Min: 0.01. Max: 500. | |
| total_token_supply | No | Total Token Max Supply (Tokens). Total supply cap (e.g. 1 Billion tokens). Default: 1000000000. Min: 1000000. Max: 100000000000. | |
| monthly_unlock_tokens | No | Upcoming Monthly Unlock Volume (Tokens/mo). Team, investor, and ecosystem unlocks per month. Default: 22500000. Min: 10000. Max: 500000000. | |
| current_circulating_supply | No | Current Circulating Supply (Tokens (18%)). Tokens currently liquid and trading. Default: 180000000. Min: 100000. Max: 50000000000. |