Token Unlock Explorer

Model token vesting (cliff, linear, monthly, tranches, TGE) or audit a VestingWallet.

Try an example: 10 % TGE, 12-month cliff, monthly over 36 months · Custom tranches

How it works

Builds a token unlock schedule from its parameters — total, start, cliff, duration, linear / monthly / custom tranches and TGE percentage — and shows unlocked vs. locked amounts on any date and the next unlock. On-chain mode reads an OpenZeppelin VestingWallet (start, duration, released, releasable) and compares the schedule with what was actually released.

Unlocked(t) = TGE % of total at the start date, plus the remaining amount vesting from the start date to start + duration. Before the cliff only the TGE amount is unlocked; at the cliff everything accrued since the start unlocks at once (OpenZeppelin VestingWalletCliff semantics).
Linear: continuous pro-rata by time. Monthly: equal steps on each monthly anniversary of the start date (day clamped to month end). Tranches: the listed percentages of the total on the listed dates (plus TGE).
All dates are UTC. Amounts are computed per date; the sample table shows month-end points.
On-chain mode reads an OpenZeppelin VestingWallet with eth_call: start(), duration(), cliff() (if present), released() / released(token), releasable() / releasable(token), owner() as beneficiary, plus the wallet's balance. Allocation = balance + released; scheduled vested = allocation × (now − start) / duration (0 before the cliff, full after the end), which equals released + releasable for an unmodified wallet.

For scripts and AI agents

JSON API: POST https://tokenunlockexplorer.usefulweb.site/api/v1/calculate (same calculation as this page)
Interface description: OpenAPI 3.1 · AI guide: llms.txt
MCP server (Streamable HTTP): https://tokenunlockexplorer.usefulweb.site/mcp · tool name token_unlock_explorer

Example request

curl -s -X POST https://tokenunlockexplorer.usefulweb.site/api/v1/calculate \
  -H 'content-type: application/json' \
  -d '{"mode":"schedule","totalTokens":1000000,"symbol":"ABC","startDate":"2026-01-01","cliffMonths":12,"durationMonths":36,"schedule":"monthly","tgePercent":10,"asOf":"2027-03-15"}'

Related tools

DAO Governance Explorer – Snapshot proposals, vote concentration, Governor state and treasury balances in one view.
Stablecoin Flow Explorer – USDC/USDT supply per chain, recent mints, burns and whale transfers, cross-chain totals.