Price Scenarios
Price Scenarios primitives project an LP position’s value at a hypothetical price change from the current pool state. Three primitives, one per protocol family.
These are paper projections — no settlement-swap impact, no fee modeling. Use them to answer “if ETH drops 30% from here, what’s my position worth?”
Primitives in this category
Section titled “Primitives in this category”SimulatePriceMove— Uniswap V2/V3.SimulateBalancerPriceMove— 2-asset Balancer; weight-aware IL.SimulateStableswapPriceMove— 2-asset Stableswap; unreachable-α returns OptionalNone.
Protocol coverage
Section titled “Protocol coverage”Hypothetical price-move projection is supported across all four AMM families via sibling primitives, mirroring Position Analysis. Each primitive uses its protocol’s natural IL formula — closed-form for V2/V3, weight-aware for Balancer, invariant-aware for Stableswap.
| Protocol | Coverage | Notes |
|---|---|---|
| Uniswap V2 | Full | SimulatePriceMove, V2 path — closed-form IL. |
| Uniswap V3 | Full | SimulatePriceMove, V3 path with lwr_tick/upr_tick for range-aware IL. |
| Balancer | Full | SimulateBalancerPriceMove, weight-aware IL formula. |
| Stableswap | Full | SimulateStableswapPriceMove; unreachable-alpha returns Optional None value fields with metadata still populated. |
MCP tool exposure
Section titled “MCP tool exposure”All three primitives are surfaced as MCP tools in the curated v2.0 set. Price-scenario questions (“what if ETH drops?”) are highest-traffic agent queries, so all three protocol variants are exposed directly rather than left to the LLM to compose.