# Elyearn

> Elyearn compares concentrated-liquidity pools on Elysium, plans a price range with exact tick math, and tracks a position's fees, value change and costs separately, each figure with its source and read time. Read-only: it never moves funds and shows no single yield figure.

## Pages
- https://elyearn.xyz/pools: Explore. Volume, liquidity and fee tier, read from chain, with the block range behind every number.
- https://elyearn.xyz/plan: Plan. Narrow, medium or wide: see what each range does before you open it.
- https://elyearn.xyz/positions: Monitor. Your v4 positions: in range or out, and the fees waiting to be collected.
- https://elyearn.xyz/positions: Break down. Fees earned, value change against holding, and gas: three numbers, never one.
- https://elyearn.xyz/alerts: Alert. Know when the price nears or leaves your range, while the page is open.
- https://elyearn.xyz/book: Range plan book (ElyearnRangeBook contract)
- https://elyearn.xyz/method: Method, sources and limits

## Read-only JSON
- GET https://elyearn.xyz/api/pools
- GET https://elyearn.xyz/api/pool?id=<v4 pool id>
- GET https://elyearn.xyz/api/positions?owner=<0x address>

## Limits
- Fees are not guaranteed. A range earns only while the price is inside it, and a price move can cost more than the fees earned.
- No yield headline. Every estimate is a scenario with its assumptions shown next to it; the last hour's activity is not a forecast.
- Volume and fees in the explorer cover the last window of blocks shown on the page, summed from Swap events. Pools with no swap in that window are not listed.
- Dollar values use HYPE and KNTQ prices from Montra's public API and USDC at $1. Other tokens get a dollar price only from a pool against one of those with enough depth near the price; otherwise no dollar value is shown.
- Token names and symbols come from the token contracts themselves. Only HYPE, WHYPE, USDC and KNTQ are on the checked list; any other symbol is shown with its address, and a symbol that copies a listed one is flagged.
- Depth within 2% assumes the active liquidity stays the same across that band.
- The position breakdown compares the state at the mint block with now. If liquidity was added or removed since, fees since mint are not shown.
- Elyearn reads the chain and never moves funds. Automated rebalancing is planned, after implementation and security testing.
- Holding $ELYEARN gives no income from any liquidity position, and the tools work without it.

## Planned
- Automated rebalancing (moving funds when a range is left), only after the code is written, tested and reviewed for security.
- Advanced analytics subscription.
- More alerts: push or email, larger quota.
- API credits.
- $ELYEARN as the way to pay for those, once they exist. Unproven until then.

Network: Elysium (chain id 99901, gas HYPE).