Docs

How a checkup works

Range Rounds reads Uniswap v3 and v4 liquidity positions on Robinhood Chain (chain id 4663) and answers four questions: is the price still inside your range, how far is the nearest edge, how much is waiting in fees, and did providing liquidity beat simply holding the tokens. It also prices a re-center before you do it.

Read-only. Range Rounds never asks you to connect a wallet or sign anything. Re-center plans are simulations; you do the steps yourself in Uniswap.

Use it

  1. Paste a wallet address, a Uniswap position link, or an id like v4 #632257 / v3 #1517857. A bare number is looked up in both v3 and v4.
  2. Every open position shows its range as a bar: the dot is today's price, the coloured band is your range. Blue means in range, yellow means the price has left it.
  3. Pick a position to see its lap score (loss or gain against holding, with fees) and a re-center plan at ±2, 5, 10, 20 or 50 %.

Where every number comes from

WhatSource
v3 positions of a walletNonfungiblePositionManager 0x73991a25c818bf1f1128deaab1492d45638de0d3 (balanceOf, tokenOfOwnerByIndex, positions)
v4 positions of a walletPositionManager 0x58daec3116aae6d93017baaea7749052e8a04fa7: every Transfer to the wallet, then ownerOf to keep the ids still held
Price, tick, fee growthv3 pool slot0, ticks, feeGrowthGlobal; v4 StateView 0xf3334192d15450cdd385c8b70e03f9a6bd9e673b
Fees waiting(fee growth inside now − at last checkpoint) × liquidity, plus tokens already owed: the same math the pool uses when it pays you
Deposits and withdrawalsv3: IncreaseLiquidity, DecreaseLiquidity, Collect events. v4: ModifyLiquidity events, amounts rebuilt from liquidity at the pool price of the last swap before each event
Re-center quotev3 QuoterV2 0x33e885ed0ec9bf04ecfb19341582aadcb4c8a9e7, v4 Quoter 0x8dc178efb8111bb0973dd9d722ebeff267c98f94, simulated with eth_call
USD pricesUSDG = $1; ETH from the WETH/USDG v3 pool 0x52e65B17fB6E5BA00Ed806f37Afcd2DaA50271Ca; other tokens from DexScreener (pairs ≥ $1k liquidity) or their deepest v3 pool against USDG or WETH

The lap score

Hold value = everything you deposited, priced today. LP value = what sits in the range now plus what you already withdrew, priced today. Loss vs hold (impermanent loss) = LP value − hold value. Lap score = loss vs hold + fees. A positive score means providing liquidity beat holding.

The re-center plan

The plan takes your principal plus fees waiting, sets a new range at ±width around today's price (rounded to the pool's tick spacing), works out the token mix the new range needs, and quotes the swap that gets you there in the same pool. Cost = pool fee on that swap + price impact (expected out at mid price − quoted out) + gas for remove, swap and mint at the current gas price.

Lap Board (on chain)

The Lap Board is our own contract, 0x083C620290dC60D2f50292D7FfC7805bdc6c9f0A on Robinhood Chain, verified on Sourcify (exact match). Once per UTC day the owner of a position calls checkIn(protocol, id) with protocol 3 (v3) or 4 (v4). The contract reads Uniswap itself and records the lap only if the caller owns the position NFT, it has liquidity, the range is at most 20,000 ticks wide (full-range positions do not count), and the pool's current tick is inside the range. Consecutive days build a streak; a missed day or a new owner starts it over.

API

JSON over HTTPS, no key. Please keep it under 120 requests a minute.

EndpointReturns
GET /api/wallet/{address} (?closed=1)counts, totals, every open (or all) position
GET /api/position/{v3|v4}/{id}live state of one position
GET /api/position/{v3|v4}/{id}/ledgerevents, deposits, withdrawals, hold vs LP, fees, lap score
GET /api/position/{v3|v4}/{id}/rebalance?width=10re-center plan at ±width % (0.5 – 90)
GET /api/examplesa few public positions in range right now
GET /api/boardLap Board: live streaks from CheckIn events

MCP server

Streamable HTTP at https://rangerounds.xyz/mcp, stateless, no key. Tools: wallet_positions, position, position_ledger, simulate_rebalance. All read-only.

claude mcp add --transport http range-rounds https://rangerounds.xyz/mcp

Limits