Getting started How it works

Getting started

How it works.

Ladders, bins and shapes: one deposit becomes a set of Uniswap positions spread across a price range.

A ladder splits your deposit into several bins: small Uniswap positions side by side across a price range. As the price moves through a bin, that bin swaps one token for the other and earns the pool's trading fee.

Three ideas

IdeaWhat it means
RangeThe prices your ladder covers. In the app you set it as a market-cap range around the current price.
BinsThe range is cut into 1 to 20 equal slices. Each slice is its own Uniswap position.
ShapeHow much of your deposit goes to each bin: evenly (Spot), mostly near the price (Curve) or at the edges (Bid-Ask).

A ladder in motion

Say you deposit ETH only. Every bin below the current price holds ETH, waiting to buy the token. When the price drops into a bin, traders swap into your liquidity: the bin converts ETH to the token, and you earn the swap fee. If the price comes back up, the bin converts back to ETH, earning fees again.

ETH waiting to buyTOKEN bought
Filled 0%
price
range lowrange high
Each bar is a bin. Green is ETH waiting to buy, amber is the token already bought. Fees accrue every time the price crosses a funded bin.

Like limit orders, but earning

A ladder behaves like a grid of limit orders that also earn fees and reverse when the price comes back. Unlike a limit order, a bin that is only partly crossed is only partly converted.

What happens on-chain

  1. You call openLadder

    The app sends your tokens (or native ETH) to the ladder manager with the pool, the tick range, the shape, the number of bins and a price guard.

  2. The manager sizes each bin

    It reads the pool price, splits the range into bins aligned to the pool's tick spacing and computes the exact liquidity each bin can take with its share of your deposit.

  3. Positions are created on Uniswap

    V3: one position NFT per funded bin via the NonfungiblePositionManager. V4: one position per bin inside the PoolManager, keyed by a unique salt.

  4. Leftovers come back

    Anything that could not be placed (rounding, bins that need the other token) is refunded in the same transaction.

Next

Ready to try it? Follow the quickstart, or dive into shapes and bins & ranges.