About Polskidegen Hl Tracker
Polskidegen Hl Tracker is an MCP server in the Blockchain category: model Context Protocol server for Hyperliquid — read-only public data (positions, fills, funding, PnL) for any wallet address.
Install
claude mcp add polskidegen-hl-tracker -- npx -y polskidegen-hl-trackernpx -y polskidegen-hl-trackerThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (8)
compare_walletsSide-by-side comparison of 2–5 wallets on 30d window (account value, PnL, win rate, avg ROI, top position)
Parameters not published.
get_fillsLast N days of fills (trades): timestamp, coin, side, size, price, direction (open/close), PnL, fee — up to 500 rows
Parameters not published.
get_fundingFunding payments over N days: net, paid, received, per-coin breakdown
Parameters not published.
get_pnl_summaryRealized PnL over `7d` / `30d` / `all`: total PnL, closed trades, win rate, avg ROI, best/worst trade, avg hold time, fees
Parameters not published.
get_positionsOpen perp positions: size, entry, mark, unrealized PnL, ROE, leverage, liquidation price + account value / margin / withdrawable
Parameters not published.
get_priceCurrent market data for any HL perp: mid, mark, oracle, 24h change, funding rate, open interest, 24h volume
Parameters not published.
get_spot_balancesHyperliquid spot balances: free, locked, total (USD value when available)
Parameters not published.
get_top_tradersTop N traders on Hyperliquid by PnL / ROI / volume over 24h / 7d / 30d / all-time. Covers all 30k+ accounts — no API key, uses HL's own public leaderboard source. Returns addresses you can pipe back into the other tools for deep-dive.
Parameters not published.
Ask AI
Ask AI about Polskidegen Hl Tracker
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
polskidegen-hl-tracker
Model Context Protocol (MCP) server for Hyperliquid — read-only, on-chain wallet analytics for any public address. Plug it into Claude Desktop (or any MCP client) and ask natural-language questions about positions, fills, funding, and realized PnL on Hyperliquid perps & spot.
No keys. No login. Public wallet address in → structured analytics out.
Features
| Tool | What it returns |
|---|---|
get_positions |
Open perp positions: size, entry, mark, unrealized PnL, ROE, leverage, liquidation price + account value / margin / withdrawable |
get_spot_balances |
Hyperliquid spot balances: free, locked, total (USD value when available) |
get_fills |
Last N days of fills (trades): timestamp, coin, side, size, price, direction (open/close), PnL, fee — up to 500 rows |
get_pnl_summary |
Realized PnL over 7d / 30d / all: total PnL, closed trades, win rate, avg ROI, best/worst trade, avg hold time, fees |
get_funding |
Funding payments over N days: net, paid, received, per-coin breakdown |
compare_wallets |
Side-by-side comparison of 2–5 wallets on 30d window (account value, PnL, win rate, avg ROI, top position) |
get_price |
Current market data for any HL perp: mid, mark, oracle, 24h change, funding rate, open interest, 24h volume |
get_top_traders |
Top N traders on Hyperliquid by PnL / ROI / volume over 24h / 7d / 30d / all-time. Covers all 30k+ accounts — no API key, uses HL's own public leaderboard source. Returns addresses you can pipe back into the other tools for deep-dive. |
Installation
Claude Desktop
Edit your claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add to mcpServers:
{
"mcpServers": {
"polskidegen-hl-tracker": {
"command": "npx",
"args": ["-y", "polskidegen-hl-tracker@0.2.0"]
}
}
}
Restart Claude Desktop. The 7 tools appear in the tool picker.
Other MCP clients
Any stdio-capable MCP client works. Run the binary directly:
npx -y polskidegen-hl-tracker@0.2.0
Example prompts
Try these in Claude Desktop once installed:
- Positions: "Show the open Hyperliquid positions for
0xea0027b6ea9b6d7d401b5266979cc3b3ca87a918." - Spot: "What spot tokens does
0x...hold on Hyperliquid?" - Fills: "List the last 7 days of Hyperliquid trades for wallet
0x...." - PnL: "Summarize 30-day realized PnL, win rate, and avg ROI for
0x...on Hyperliquid." - Funding: "How much did wallet
0x...pay or receive in Hyperliquid funding over the last week?" - Compare: "Compare Hyperliquid performance for these 3 wallets:
0x...,0x...,0x...." - Price: "What's the current Hyperliquid mark price and funding for HYPE?"
- Leaderboard: "Who are the top 5 most profitable Hyperliquid traders in the last 24 hours?"
- Leaderboard + deep-dive: "Pull the top 10 HL traders by 30d PnL, then show the current positions of the top 3."
Security
This MCP is 100% read-only. It does not require any private keys, seeds, mnemonics, or logins. Only a public wallet address (0x + 40 hex chars) is needed as input.
- All data comes from Hyperliquid's public info endpoint (
https://api.hyperliquid.xyz/info). - No external services, no telemetry, no analytics, no tracking.
- The
exchangeendpoint (which would require signing) is never called. - No network calls are made to any host other than
api.hyperliquid.xyz.
Notes & limits
userFillsByTime/userFundingreturn up to ~500–2000 events per request.get_pnl_summarycovers up to 365 days but the underlying fills endpoint caps the result set — for extremely active traders, numbers over long windows reflect the capped sample.avg hold timeinget_pnl_summaryis approximate — it pairs closes with nearest prior opens on the same coin; if the matching open falls outside the fetched window, it's skipped.- USD values for spot balances depend on whether the token has an active mark on
allMids.
Maintainer
Built by @polskidegen — Polish crypto/AI trader, building tools for the degen stack.
Issues / PRs: https://github.com/polskidegen/polskidegen-hl-tracker
License
MIT — see LICENSE.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.