Learn to provide liquidity

What a liquidity pool is

New to LPing? Eight short lessons explain how it works, with moving pictures. About ten minutes.

A pool holds two tokens, say HELIOS and HYPE. Traders swap one for the other through it, and every swap pays a small fee. Liquidity providers (LPs) are the people who put the tokens in, and the fees go to them.

You add both tokens; each swap through the pool pays you a share of its fee.

Pick where your liquidity works

On Helios you choose a price range. Your liquidity only trades, and only earns, while the price is inside it. A tighter range puts all your money to work right around the price, so it earns much more per dollar, but the price leaves it sooner.

The price moves around. While it stays between your min and max, you earn.

Bins: how a DLMM holds your liquidity

A DLMM pool splits prices into small steps called bins. Bins below the current price hold HYPE, ready to buy the token if it falls. Bins above hold the token, ready to sell it if it rises. The bin the price is in holds both. As the price moves through your bins, it swaps one token for the other and you earn the fee.

Each bar is a bin. Below the price it waits to buy; above it, it waits to sell.

Shape: how much goes in each bin

The shape decides how your deposit spreads across your bins.

The same range, spread three ways.

Spot: Even liquidity across the whole range. A good default.
Curve: Concentrated around the current price. Earns most when the price stays near where it is.
Bid-Ask: Weighted toward the edges of the range. Built to catch swings in either direction.

In range and out of range

While the price is inside your range, you earn fees. If it leaves, your position stops earning and sits entirely in one token: all HYPE if the price fell below it, all the token if it rose above it. It earns again when the price comes back, or you can withdraw and open a new range around the new price.

Out of range isn't a loss by itself, but it earns nothing until the price returns.

What you earn, and what can go against you

You earn a share of the fee on every swap that trades through your range, paid in both tokens. Fees build up in the position; collect them whenever you like from Portfolio or the pool page.

The risk is impermanent loss. As the price moves, the pool sells the token that's rising and buys the one that's falling, so you end up with more of the weaker token than if you'd just held. A good position earns more in fees than it loses this way. That's the trade every LP makes.

Which pool type?

Type	How it works	Good for
DLMM	Liquidity in bins you pick around the price, spread by a shape. The fee rises when the market is volatile.	Active LPs who want the most fees per dollar.
DAMM	One position across every price, on Uniswap v4 with the Helios fee hook. Never out of range.	A token's main pool and launches, and LPs who don't want to manage anything.
Uniswap v3	Helios' first pools: a range and a shape built from several v3 positions.	Existing Helios v3 pools. New pools are DLMM or DAMM.

Your first position, step by step

Start small. Your first position is for learning how a range behaves; size up once you've watched one through a few price moves.

Reference

Getting started

Get HYPE on Elysium. Elysium is Kinetiq's L2 that settles to HyperEVM, and HYPE pays for gas. See Elysium's documentation for bridging.
Connect a wallet. Use Connect wallet in the header. Helios asks your wallet to add or switch to Elysium (chain 99901) if it isn't there already.
Open a pool. Pick one from Pools to see its chart, depth, safety report and the liquidity panel.

Finding pools

The pools table shows liquidity, volume, fees and fee APR for every pool, over the timeframe you pick. Sort by any column, narrow the list to one venue, or set filters on the numbers that matter to you. Every pool page reports on its base token's holders, measured from chain data. Each line is marked fine, caution or concern.

Check	What it measures	Caution	Concern
Top 10 holders	Share of supply held by the ten largest wallets	30%	60%
Deployer	Supply still held by the wallet that deployed the token. “Sold all” means none.	3%	8%
Bundled buys	Bought in the launch block by linked wallets	10%	25%
Snipers	Bought within the first blocks after liquidity was added	3%	10%

Creating a pool

Anyone can create a pool for any Elysium token. Press New pool on the Pools page, or on a pool's page to open another pool for the same token.

DAMM: One position across every price, on Uniswap v4. It never goes out of range and needs no managing: the simple choice for a token's main pool. Fees of 0.3%, 1%, 2% or 4%, or a custom fee up to 10%.
DLMM: Liquidity in bins around the price, up to 75 on each side, spread by a shape. Its fee starts from the bin step (0.1%, 0.25%, 0.5% or 1%) and rises with volatility.

New pools are made on Uniswap v4 with the Helios fee hook: a launch fee that starts high and steps down to stop snipers, a fee that rises with volatility, and Helios' 0.1% swap fee.

Swapping

The Swap tab on a pool page, and the Swap page, compare quotes from every source Helios reaches (Helios pools, KyberSwap, Matcha, Uniswap and Enso) and use the best one, or the one you pick. HYPE trades as the native coin, slippage is set in the panel, and the quote shows the route before you confirm.

Managing positions

Portfolio shows your balances, trades and PnL, and every Helios position in the connected wallet with its range, whether it's in range, its fees and its PnL.

Staking and locks

Lock $HELIOS on Staking to earn HYPE. Stakers share part of the HYPE Helios earns, paid out continuously, and the longer you lock, the bigger your share. Claim any time and unstake once your lock ends. The Staking page shows the current lock options.

Lock liquidity positions or tokens for a set time, or forever, so anyone can check them on chain. Locked positions keep earning fees. Locks show on the token's page and on Analytics.

Fees and $HELIOS

Every pool has an LP fee, charged on each trade and paid to the liquidity providers whose range the trade crosses. Fees build up in your position until you collect them. DLMM and DAMM pools can add a launch fee and a volatility fee on top, set when the pool is created.

100% of protocol fees go to buying back and burning $HELIOS: the 0.1% swap fee on DLMM and DAMM pools, and the fee router on v3 (0.05% of deposits, 0.05% of withdrawals and 0.5% of the LP fees you collect). Every buyback and burn shows on Analytics.

$HELIOS has a fixed supply of 1,000,000,000 tokens on Elysium. Every fee Helios earns flows back to it. Token contract: 0x792aa7771e4e1bd58f84631c915ae98aef45277e

50% · Buyback & burn: Used to buy $HELIOS back from the market and burn it.
50% · Treasury: Funds audits, servers, partnerships and growth. 10% of it is paid to $HELIOS stakers in HYPE.

Fee router: 0x1dE31F83169Ddd068a9bc718393719f28ac51061

Risks

Impermanent loss. As the price moves, a position ends up holding more of the token that fell. If fees don't cover the difference, you'd have done better holding.
Out of range. When the price leaves your range, the position stops earning and sits entirely in one token until the price returns or you move it.
Token risk. New tokens can be abandoned, dumped or malicious. Read the safety report, and remember it only covers what the chain shows.
New chain, new software. Elysium and Helios are both young. Provide liquidity only with funds you can afford to lose.

Developers

Create pools and add liquidity from your own app, bot or script, the same way the Helios app does: with the TypeScript SDK, or the HTTP API from any language. Both read the chain and return the transactions to sign. Helios never holds your keys or funds.

npm install @heliosliq/sdk viem

import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { createHeliosClient, elysium } from "@heliosliq/sdk";

const helios = createHeliosClient();
const wallet = createWalletClient({ chain: elysium, account: privateKeyToAccount(KEY), transport: http() });

// DLMM pool for TOKEN/HYPE at 0.05%, from 0.00012 HYPE per TOKEN, with 50 HYPE.
const plan = await helios.planCreatePool({
  base: TOKEN, quote: "HYPE", type: "dlmm", fee: 500,
  price: 0.00012, amount: { quote: 50 },
});
const { pool, tokenIds } = await helios.execute(plan, wallet);

Every endpoint is read-only and open to any origin. Amounts are strings in each token's smallest unit. https://heliosliq.com/api/v1

Method	Endpoint	Returns
`GET`	`/pools?base=…&quote=…`	The pair's pool at every fee tier: whether it exists, its address and its price.
`POST`	`/pools`	A plan for a new DAMM or DLMM pool, plus its transactions when the body has an account.
`POST`	`/positions`	A plan for new positions in an existing pool, plus its transactions when the body has an account.

Contracts

Helios on Elysium mainnet (chain 99901):

DLMM and DAMM (Uniswap v4)

Pool manager: 0xE2e105d3F7209A9DA11f83cCf3E7398a753823F1
Position manager: 0x1d1C51b9d07fD27d36412A2b66CC23D19Eb3E518
Helios fee hook: 0xa129c69D439f30e6FfACC435a1627b7f4F9d30c4
DAMM launcher: 0xEcA89f891B2Fb358c1f6e6BC922E48690a7C617b
DLMM bin manager: 0xd3bDE60fF5a3851f04B0083Cf27C0be828c611F2
Position locker: 0x22eB45d664DC84dA9dcf5D4C9E5F6531075E9288

Uniswap v3 pools

Pool factory: 0x626005cA43F45568AD5f084087e5ae7cbba04e06
Position manager: 0x3cc4F6963304852b2DceBBB2755defdBfaB33FBf
Swap router: 0xbD8855A665Fcd99493f7324A6959ED7BD1ADb7A8
Quoter: 0x023b424F62b6aC2BFc2F3818eE8720d4ab78Ac7e
Helios Wrapped HYPE: 0xcaD918f7B420b684f6e80B0E38ea5e1Ae24F6310
Fee router: 0x1dE31F83169Ddd068a9bc718393719f28ac51061

Staking and locks

Staking: 0x8cef6b7b09Da069a49d3f44b774d2106Ed1a912C
Token locker: 0x68137424Aa8915Ba886cEC956c2615C374012e38
Liquidity locker: 0x9553139bE722C36AAcDFC1039B50A45Ab1F52512