Concepts
Liquidity shapes.
Spot, curve and bid-ask liquidity shapes: how Obol spreads your deposit across bins of a Uniswap V3 or V4 price range, with live examples.
A shape is a set of weights: how much of your deposit each bin receives. It is the difference between a flat grid of orders and one that leans toward the middle or the edges of your range.
Curve. Most liquidity in the middle of your range (around the current price with the default range), thinning toward the edges.
Shapes in the app
| Shape | On-chain ID | Weights | Good for |
|---|---|---|---|
| Spot | 1 · Uniform | Equal in every bin | Steady accumulation or distribution, wide ranges |
| Curve | 2 · Bell | Highest in the middle bin, decreasing with 1 / (1 + d²) | Ranging markets, fee maximisation |
| Bid-Ask | 5 · Barbell | Lowest in the middle, increasing toward both edges | Volatile tokens: buy deep dips, sell strong pumps |
d is the distance, in bins, from the middle bin. Weights are normalised so they always add up to 100% of the deposit.
Extra shapes via the contracts
The contracts also accept 3 · Ascending (weight grows linearly toward the upper tick) and 4 · Descending (grows toward the lower tick). They are available to integrators calling openLadder directly. Note that “upper tick” means a higher price of token1 in token0, which is the opposite direction of the token's price when the token is token1.
Shapes with one-sided deposits
Weights are applied to the bins that can actually hold your token. With ETH only, only the bins below the price are funded, and the shape is re-normalised over them. See single-sided deposits.
