trackdefi
Live at trackdefi.app — free, no login, no wallet connection.
Paste any wallet address (EVM 0x… or Solana) and see all of its liquidity-pool positions on
Aerodrome, Velodrome, Uniswap, PancakeSwap, SushiSwap, Ramses and Orca, across every network in the
coverage table — including the gauge-staked (and MasterChef-staked)
ones that most trackers miss. Read-only: trackdefi never asks for private keys or seed
phrases, and cannot move funds. No token, no presale, no airdrop.
Why it exists
Three things were missing from the trackers we tried:
- Staked positions disappear. Once you stake an LP position in a gauge, the
NFT leaves your wallet and most trackers stop seeing it. trackdefi reads the
gauge too, so a staked position looks exactly like an unstaked one.
- APR is usually a lie for your position. Pool APR is an average. What a
concentrated position actually earns depends on its range — and a position
sitting out of range earns nothing in fees, no matter what the pool's number
says. trackdefi computes the APR of the position, and shows
0% when that is
the truth.
- You shouldn't have to connect a wallet to look at public data. LP
positions are on-chain and public. Reading them needs an address, not a
signature.
When a token has no reliable price, trackdefi shows — instead of guessing.
Coverage
| Exchange | Networks |
|---|
| Aerodrome | Base |
| Velodrome | Optimism, Unichain, Ink, Mode, Soneium, Fraxtal, Lisk, Swell, Metal L2, Superseed, Celo |
| Uniswap v2 | Base, Optimism, Ethereum, Arbitrum, Robinhood Chain, Unichain, BNB Chain |
| Uniswap v3 | Base, Optimism, Ethereum, Arbitrum, Robinhood Chain, Unichain, BNB Chain |
| Uniswap v4 | Base, Optimism, Ethereum, Arbitrum, BNB Chain, Robinhood Chain |
| PancakeSwap v2 | BNB Chain, Ethereum, Base |
| PancakeSwap v3 | BNB Chain, Ethereum, Base, Arbitrum |
| SushiSwap v2 | Ethereum, Optimism, BNB Chain, Base, Arbitrum |
| SushiSwap v3 | Ethereum, Optimism, BNB Chain, Base, Arbitrum |
| Ramses | Robinhood Chain, HyperEVM |
| Orca | Solana |
Classic (v2-style) and concentrated positions, staked or not, with pending fees
and emissions, plus veAERO / veVELO governance locks. For each position it also
shows what that position itself is earning now — 0% in fees when it is out of
range.
It also has an APR simulator: pick a
pool, an amount and a price range to see what it would earn while in range (fees
measured on the pool itself, plus emissions) and how much of the last 7 days the
price spent inside the range. The pair finder
filters pools on the same exchanges by APR (the pool average, from DefiLlama),
24-hour volume, TVL and the market cap of the smaller token.
What it doesn't do: no profit and loss or impermanent loss since a position was
opened, no alerts, and no transactions of any kind. The roadmap tracks what's next;
how it works explains where every number
comes from.
Stack
- Next.js (App Router) + TypeScript — site + API
- viem — read-only on-chain access (Sugar contracts for the Aerodrome/
Velodrome family; the NonfungiblePositionManager for Uniswap v3; the
PositionManager and StateView for Uniswap v4; the same NonfungiblePositionManager
plus the MasterChef v3 for PancakeSwap v3; SushiSwap v3's own
NonfungiblePositionManager, which has the Uniswap v3 layout; Ramses' own position manager and
its gauges, which pay emissions without staking; for the classic v2 pools of
Uniswap, PancakeSwap and SushiSwap, the pair contracts, found through the
token list of Alchemy's Token API since an LP token has no NFT to enumerate)
- @solana/kit + Orca's official Whirlpools SDK — read-only access to
Solana, which sits outside the Ethereum family
- DefiLlama, then DexScreener — USD prices (free, no key); when neither
covers a token, its price is read from a pool on the same network. DefiLlama
also provides pool yield data
- Languages — English (default, no URL prefix) and Brazilian Portuguese
(
/pt-br); adding one is a dictionary folder plus a line in
app/i18n/config.ts
- Vercel — hosting; Vercel Analytics — cookieless usage stats
Architecture
Protocol-specific code lives behind one interface (core/types.ts →
ProtocolAdapter). Adding a network or exchange means writing an adapter and
registering it in core/adapters/registry.ts — the API, the price layer and the
UI don't change.
Money is handled as BigInt throughout the core; floats appear only at the
display edge.
core/ pure engine, testable without a UI
types.ts LpPosition + ProtocolAdapter interface
chain.ts per-network viem readers (RPC from env or public endpoints)
service.ts adapters + prices -> JSON DTO (USD computed server-side)
guards.ts TTL cache, rate limiter, concurrency semaphore
math/ Q96 concentrated-liquidity math (BigInt)
prices/ price clients (DefiLlama, DexScreener)
yields/ position-level APR ("what is this position earning now")
adapters/ aerodrome/ (Sugar family) · uniswap-v3/ · registry.ts
app/ Next.js site + /api/positions
[lang]/ every page, once per language (w/[address] wallet results,
how-it-works, glossary, roadmap, changelog, feedback)
i18n/ languages, dictionaries (messages/<lang>/) and SEO helpers
ui/ components, number/date formatting
proxy.ts language routing: English has no URL prefix, others do (/pt-br)
tests/ unit tests with frozen real-wallet fixtures
poc/ CLI + validation scripts (see below)
Develop
npm install
npm run dev
Dev mode is slow for full scans — use a production build to measure real speed:
npm run build && npm run start
Scripts:
| Command | What it does |
|---|
npm test | unit tests (Vitest) |
npm run typecheck | tsc --noEmit |
npm run poc -- 0x… | print a wallet's positions from the terminal |
npm run check-api | hit the API handler against the live chain |
npx tsx poc/validate-batch.ts | full validation battery (run before releases) |
npx tsx poc/validate-live.ts https://trackdefi.app | validate a deployed site over HTTP |
npx tsx poc/find-wallets.ts | find active LP wallets from recent events |
npx tsx poc/check-outage.ts | verify a dead RPC returns a clean 502 |
Environment
Copy .env.example. All variables are optional:
NEXT_PUBLIC_SITE_URL — canonical origin used for metadata, canonicals and
the sitemap. Defaults to https://trackdefi.app.BASE_RPC_URLS — comma-separated RPC URLs (e.g. an Alchemy key) to speed up
scans. Server-side only, never exposed to the browser. Falls back to public
RPCs. Every network has its own (OPTIMISM_RPC_URLS, BSC_RPC_URLS, …; the
full list is rpcEnv in core/chains.ts). The "earning now" fee window
needs an RPC that serves historical state, which most public RPCs don't.TRACKDEFI_FIXTURE — dev only; serve a frozen DTO instead of reading the
chain. Ignored on Vercel.
Deploy
See DEPLOY.md for the step-by-step (GitHub + Vercel, free tier).
Notes
- Pin TypeScript to 5.x — TS 7 (the native port) breaks Next 16's TS integration.
- Not financial advice. Verify data on-chain before acting. Data can lag the
chain by up to a minute.
