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.
Use it
- 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. - 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.
- 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
| What | Source |
|---|---|
| v3 positions of a wallet | NonfungiblePositionManager 0x73991a25c818bf1f1128deaab1492d45638de0d3 (balanceOf, tokenOfOwnerByIndex, positions) |
| v4 positions of a wallet | PositionManager 0x58daec3116aae6d93017baaea7749052e8a04fa7: every Transfer to the wallet, then ownerOf to keep the ids still held |
| Price, tick, fee growth | v3 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 withdrawals | v3: IncreaseLiquidity, DecreaseLiquidity, Collect events. v4: ModifyLiquidity events, amounts rebuilt from liquidity at the pool price of the last swap before each event |
| Re-center quote | v3 QuoterV2 0x33e885ed0ec9bf04ecfb19341582aadcb4c8a9e7, v4 Quoter 0x8dc178efb8111bb0973dd9d722ebeff267c98f94, simulated with eth_call |
| USD prices | USDG = $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.
- Holds no funds. No proxy, no upgrade, no admin except one call:
setToken, once, by the deployer, right after $RANGER exists. - After that call, checking in needs 100,000 $RANGER in the calling wallet. Before it, anyone can check in.
canCheckIn(protocol, id, wallet)is a free view that says why a check-in would fail.- Not audited. An independent review found no critical or high issue; its fixes were applied before deploy.
API
JSON over HTTPS, no key. Please keep it under 120 requests a minute.
| Endpoint | Returns |
|---|---|
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}/ledger | events, deposits, withdrawals, hold vs LP, fees, lap score |
GET /api/position/{v3|v4}/{id}/rebalance?width=10 | re-center plan at ±width % (0.5 – 90) |
GET /api/examples | a few public positions in range right now |
GET /api/board | Lap 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
- Robinhood Chain only, Uniswap v3 and v4 only.
- v4 fees collected in the past are not counted (v4 pays fees out on every modify without a separate event); fees waiting now are exact.
- Values use today's prices. Thin tokens can be priced wrong; when no price is found the USD fields show "—".
- A wallet with more than 200 v3 positions shows the first 200.
- Not audited. The checkup only reads public contracts; the optional Lap Board is our own contract (see above).
- Not financial advice.