> For the complete documentation index, see [llms.txt](https://docs.squadswap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.squadswap.com/platform/products/automated-liquidity-manager/automated-liquidity-manager-on-squadswap.md).

# Automated Liquidity Manager on SquadSwap

SquadSwap's Automated Liquidity Manager is a native dashboard in the main app for easily managing automated, hands-off liquidity strategies. It lets users browse, monitor, and join in-house and community (public) strategies with real-time metrics, charts, and one-click actions.

> Current implementation lives at **`/alm`** (beta). The older table-based experience (legacy "ALM V3", `PositionManager`-based, reached via `/earn?type=almv3` or `/almv3`) is being deprecated and points users to `/alm`. If the `ALM_V3_DISABLED` flag is on, all navigation to "Automated Liquidity Manager" goes directly to `/alm`.

**1. Dashboard Overview**

Access the Automated Liquidity Manager in the SquadSwap app (navbar → Apps → Automated Liquidity Manager, or the Earn menu). The dashboard is organized into three areas:

* **In-House Strategies** - a horizontally scrolling slider of SquadSwap's own (verified, `ownerIsLowRisk`) strategies as compact cards.
* **Build Your Own Strategy** - a call-to-action card that launches the strategy builder at `https://alm.squadswap.com`.
* **Public Strategies** - every public strategy is shown as a card (grid view) or a wide row (list view).

The filter bar lets you:

* **Search** by pair (e.g., `DOGE-WBNB`), strategy address, or DEX name
* **Toggle** between Grid and List views
* **Sort** by APR, Total Staked (TVL), or Managed Fee
* **Filter by Time Range** (All Time, 1 Year, 6 Months, 3 Months, 1 Month) when sorting by APR
* **Show only Deposited** strategies (available when connected)
* **Toggle Animations** (live-updating card effects)

Data is fetched per active chain from the SquadSwap backend (`/api/alm/public-strategies/{chainId}` → `application/alm/public-strategies-with-charts`). A separate "Automated Liquidity Manager 24h Volume" widget sums 24h volume across all public strategies.

**2. What Each Strategy Card Shows**

Every strategy card displays:

* **Pair** - token pair icons and name (e.g., `DOGE-WBNB`) with an **APR badge**
* **APR** - estimated annual yield (fees + rewards), shown as a badge and used for sorting
* **Total Staked (TVL)** - current liquidity in USD, plus per-token amounts, with a **TVL sparkline**
* **Inventory P\&L** - a sparkline of the strategy's inventory performance over time
* **Volume (24h)** - trading volume that generates fees (in the details modal)
* **Manager Fee** - the strategy manager's commission (e.g., `1.50%`)
* **Fee Tier** and **DEX** - pool fee tier and the DEX the strategy trades on
* **Duration** - a live counter since the strategy position started
* **Owner** - strategy creator, with profile photo, linking to their account page
* **Deposit / Withdraw** buttons and a **⋯ actions menu** (Creator Profile, View on Scan)

The **details modal (⋯)** adds Inventory P\&L and TVL charts plus the full metric breakdown above.

**3. Joining and Managing a Position**

1. **Browse strategies:** Review APR, TVL, manager fees, volume, and charts.
2. **Deposit:** Open a strategy, enter the amount for one or both tokens (at least one token > 0, the other may be left at 0). Balances, percent shortcuts, and live USD prices are shown. Token approval is handled automatically (native tokens skip approval), then `deposit(amount0, amount1, minShare)` is executed on the strategy contract. Min-share protection is set to zero.
3. **Earn:** Fees and rewards accumulate passively inside the strategy.
4. **Withdraw:** Choose a percentage (0–100%, with 25/50/75/100% shortcuts). The modal estimates your vault share, your current position (in tokens and USD), and the amounts you will receive. Slippage from your settings (default 0.5%) is applied and a 20-minute deadline is used. If the market price deviates too far from the pool price (price-sanity check via the strategy manager, price-feed registry, and lens), a warning blocks the withdrawal until prices converge. Withdrawal calls `withdrawWithFees` on the strategy contract.

**4. Benefits & Notes**

* Perfect for hands-off liquidity provision - ranges and rewards are managed automatically.
* The "Deposited" filter lets you quickly see only strategies you hold shares in.
* Each strategy is transparent about its manager fee, fee tier, DEX, owner, and historical performance.
* Multi-chain: strategies are listed per the active chain.
* Supports public and in-house strategies; the older V3 (`PositionManager`-based) platform is deprecated in favor of this dashboard.
* Monitor performance directly in the dashboard via TVL, Inventory P\&L, APR, and 24h volume.
* Strategy creation is handled on the external builder at `https://alm.squadswap.com` ("Manage").
