polskidegen-hl-tracker
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@polskidegen-hl-tracker List top 5 traders by 7d ROI"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Open perp positions: size, entry, mark, unrealized PnL, ROE, leverage, liquidation price + account value / margin / withdrawable |
| Hyperliquid spot balances: free, locked, total (USD value when available) |
| Last N days of fills (trades): timestamp, coin, side, size, price, direction (open/close), PnL, fee — up to 500 rows |
| Realized PnL over |
| Funding payments over N days: net, paid, received, per-coin breakdown |
| Side-by-side comparison of 2–5 wallets on 30d window (account value, PnL, win rate, avg ROI, top position) |
| Current market data for any HL perp: mid, mark, oracle, 24h change, funding rate, open interest, 24h volume |
| 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. |
Related MCP server: hyperliquid-mcp
Installation
Claude Desktop
Edit your claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%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.0Example 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.
Available Tools
8 toolscompare_walletsA
Compare 2–5 Hyperliquid wallets side-by-side: account value, 30d PnL, win rate, avg ROI, top position.
Inputs: addresses (required).
get_fillsA
Get recent fills (trades) for a Hyperliquid wallet. Returns up to 500 fills from the last N days (default 7).
Inputs: address (required), days.
get_fundingA
Get funding payments/receipts for a Hyperliquid wallet over the last N days (default 7). Returns net funding, paid, received, and per-coin breakdown.
Inputs: address (required), days.
get_pnl_summaryB
Compute realized PnL summary for a Hyperliquid wallet: total PnL, closed trades, win rate, avg ROI, best/worst trade, avg hold time.
Inputs: address (required), window.
get_positionsA
Get open perpetual positions for a Hyperliquid wallet (size, entry, mark, uPnL, ROE, leverage, liquidation price) plus account value, margin used, withdrawable.
Inputs: address (required).
get_priceA
Get current market price for a Hyperliquid perp (mid, mark, oracle, 24h change, funding rate, OI, 24h volume).
Inputs: symbol (required).
get_spot_balancesA
Get spot token balances for a Hyperliquid wallet (free, locked, total; USD value where available).
Inputs: address (required).
get_top_tradersA
Return the top N Hyperliquid traders by PnL / ROI / volume over a time window (24h, 7d, 30d, or all-time). Uses Hyperliquid's own public leaderboard endpoint — no API key, covers all 30k+ accounts. Returns addresses you can feed into get_positions / get_pnl_summary / get_fills for deeper analysis.
Inputs: window, limit, sort_by, min_account_value, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool targets a distinct aspect of Hyperliquid wallet analysis (positions, fills, funding, PnL, prices, spot balances, comparison, top traders), with no overlapping purposes.
All tools follow a consistent verb_noun snake_case pattern (e.g., get_fills, get_positions, compare_wallets), making the set predictable.
8 tools is well-scoped for a Hyperliquid tracker, covering core wallet metrics without being excessive or sparse.
Covers positions, trades, funding, PnL, prices, spot balances, wallet comparison, and top traders. Minor gaps like historical PnL over custom periods are acceptable for a tracker.
Maintenance
Related MCP Connectors
Hyperliquid market data, wallet analytics and liquidation alerts for AI agents.
Read-only Hyperliquid analytics: orderflow, liquidation levels, whale positioning, funding.
Hyperliquid MCP — read-only market data from Hyperliquid's public info API.
Live Hyperliquid wallet positions, recent trades with PnL, and fill alerts to Discord/Telegram.
Related MCP Servers
- AlicenseBqualityBmaintenanceMCP server for querying historical and real-time crypto market data across Hyperliquid, Hyperliquid HIP-3, and Lighter.xyz - orderbooks, trades, candles, funding, open interest, liquidations, and data quality metrics.10064 npm13MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server for the Hyperliquid decentralized exchange, enabling AI assistants to perform trading operations, manage accounts, and retrieve market data.38 PyPI3MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that allows querying Hyperliquid open positions and unrealized PnL for any wallet address.MIT
- AlicenseNot gradedqualityDmaintenanceA read-only MCP server for Hyperliquid that provides public market data (prices, order books, funding) and any wallet's positions, orders, and fills via MCP tools, without requiring a private key.MIT