Token liquidity stress tests: unlocks and LP withdrawals
An unlock schedule describes when tokens become available. A liquidity stress test asks what happens if some of those tokens are sold while market depth is reduced. Keeping those questions together helps teams find fragile assumptions before they commit to an incentive programme or launch plan.
In this article
Start with executable liquidity
Collect the venues a holder could actually use, the available depth, trading fees and any relevant withdrawal or transfer constraints. Date the snapshot. Market capitalisation and yesterday's trading volume do not tell you what a sale can obtain from the market now.
For a pool, record the reserves or active liquidity needed by its pricing model. For an order book, record executable bids at several trade sizes. Keep venues separate until the routing assumptions are explicit. Adding all quoted depth together can overstate what is accessible during a disruption.
Use a small example to expose the mechanics
The Uniswap explanation of automated market makers describes constant-product pricing. In a simplified full-range pool with token reserve x, quote reserve y and a sale of s tokens, the quote amount received is y × s / (x + s). This example excludes fees, arbitrage and other trades.
That is a controlled comparison of two pool states. It is not a forecast of holder behaviour or the wider market. It shows how the same sale produces a different result when less liquidity is available.
Combine an unlock with a liquidity change
Take the balances becoming transferable from your vesting and emissions model. Define several hypothetical fractions sold and the period over which they arrive. An unlock is not itself a sale, so keep the assumed sale fraction visible in every chart and result.
- Selling only: vary the amount sold while holding the initial liquidity snapshot fixed.
- Liquidity withdrawal: repeat each sale after a specified share of liquidity is removed.
- Venue disruption: remove a venue or route and test what remains accessible.
- Combined stress: put the larger sale and thinner liquidity in the same scenario, with assumptions written down.
Run enough combinations to see which assumption changes the conclusion. If the result depends on a single provider keeping liquidity available, document that dependency and the evidence behind it. A stated intention to provide liquidity and an enforceable commitment are different inputs.
Match the model to the actual market
A simple reserve model cannot represent every pool. In concentrated-liquidity pools, positions contribute liquidity within selected price ranges. A position stops being active when the price leaves its range. Stress tests therefore need the distribution of liquidity across the ranges the trade crosses, rather than just the total value deposited.
For an initial review, a simple model can identify the questions that need deeper work. Before using results to support a launch decision, include the actual fee rules, routing, token behaviour and relevant market conditions. Keep unavailable data labelled as a gap instead of replacing it with a favourable assumption.
Turn the result into an operational decision
Report the amount sold, average execution price, price after the trade, liquidity remaining and all scenario assumptions. Distinguish the price movement caused by the modelled trade from uncertainty about the price at execution. The team can then compare scenarios against limits it has explicitly agreed.
Assign an owner to refresh the snapshot before material unlocks or incentive changes. Record what would trigger a review of the programme, who can approve a change and how holders would be informed. Use the tokenomics simulator to explore supported scenarios and token ecosystem engineering to connect the modelling to the broader design.
Frequently asked questions
- Does a large token unlock automatically cause a price fall?
- An unlock makes tokens transferable under the relevant schedule; it does not establish how much will be sold. A stress test explores explicit selling assumptions against available liquidity rather than predicting every holder's behaviour.
- Can total value locked stand in for usable trading depth?
- No. The amount available around the current and subsequent trade prices depends on the pool design, liquidity ranges and accessible routes. Use the data required by the actual pricing model.
- How often should a project rerun its liquidity scenarios?
- Set the review frequency based on how quickly the market changes, and rerun before material unlocks, incentive changes or changes in liquidity arrangements. Preserve the snapshot date so readers know which market state the result describes.
Related reading
Let's build something durable.
Tell us about your project. We reply within two business days.

