{"id":51732990,"url":"https://github.com/mgalihpp/hyperliquid-tracker","last_synced_at":"2026-07-18T03:43:39.741Z","repository":{"id":345682838,"uuid":"1186924902","full_name":"mgalihpp/hyperliquid-tracker","owner":"mgalihpp","description":"Real-time Hyperliquid wallet tracker with multi-wallet support, PnL alerts, liquidation monitoring, and MCP server for AI client integration.","archived":false,"fork":false,"pushed_at":"2026-03-20T16:21:34.000Z","size":238,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-18T03:43:17.734Z","etag":null,"topics":["crypto","dex","hyperliquid","mcp","model-context-protocol","perptuals","trading","typescript","wallet-tracker"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/hyperliquid-tracker-mcp","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mgalihpp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-20T06:19:01.000Z","updated_at":"2026-06-30T12:12:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mgalihpp/hyperliquid-tracker","commit_stats":null,"previous_names":["mgalihpp/hyperliquid-tracker"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/mgalihpp/hyperliquid-tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgalihpp%2Fhyperliquid-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgalihpp%2Fhyperliquid-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgalihpp%2Fhyperliquid-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgalihpp%2Fhyperliquid-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mgalihpp","download_url":"https://codeload.github.com/mgalihpp/hyperliquid-tracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgalihpp%2Fhyperliquid-tracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35603954,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-18T02:00:07.223Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crypto","dex","hyperliquid","mcp","model-context-protocol","perptuals","trading","typescript","wallet-tracker"],"created_at":"2026-07-18T03:43:39.135Z","updated_at":"2026-07-18T03:43:39.730Z","avatar_url":"https://github.com/mgalihpp.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hyperliquid Wallet Tracker\n\nA modern, real-time wallet tracker dashboard for Hyperliquid perpetuals. Built with Next.js 15, TypeScript, and the [@nktkas/hyperliquid](https://github.com/nktkas/hyperliquid) SDK.\n\n![Dashboard Preview](docs/dashboard-preview.png)\n\n## Features\n\n- **Multi-wallet tracking** - Track multiple public wallet addresses simultaneously\n- **Real-time polling** - Configurable polling interval (default: 10 seconds)\n- **Account summary** - View account value, unrealized PnL, margin used, withdrawable\n- **Position tracking** - See all open positions with entry/mark price, leverage, PnL\n- **Liquidation monitoring** - Distance to liquidation with color-coded warnings\n- **Change detection** - Toast notifications for new/closed positions and PnL swings\n- **Network toggle** - Switch between mainnet and testnet\n- **Dark mode** - Beautiful dark theme by default\n- **Responsive design** - Works on desktop, tablet, and mobile\n- **MCP Server** - Available as npm package for AI assistants\n\n## Tech Stack\n\n- [Next.js 15+](https://nextjs.org/) (App Router, React 19)\n- [TypeScript](https://www.typescriptlang.org/) (strict mode)\n- [@nktkas/hyperliquid](https://github.com/nktkas/hyperliquid) SDK\n- [Tailwind CSS v4](https://tailwindcss.com/)\n- [shadcn/ui](https://ui.shadcn.com/) components\n- [Sonner](https://sonner.emilkowal.ski/) for toast notifications\n- [Lucide React](https://lucide.dev/) for icons\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js 18.18 or later\n- npm, pnpm, yarn, or bun\n\n### Installation\n\n1. **Clone the repository**\n\n```bash\ngit clone \u003cyour-repo-url\u003e\ncd hyperliquid-wallet-tracker\n```\n\n2. **Install dependencies**\n\n```bash\nnpm install\n```\n\n3. **Run the development server**\n\n```bash\nnpm run dev\n```\n\n4. **Open your browser**\n\nNavigate to [http://localhost:3000](http://localhost:3000)\n\n## Configuration\n\n### Configuration Storage\n\n- **Source of truth:** Browser `localStorage`\n- **Default fallback:** `data/config.json`\n- **Import/Export:** JSON file from the sidebar\n\n### Adding Wallets\n\nYou can manage wallets in three ways:\n\n1. **Via UI** - Add/remove wallets from the sidebar\n2. **Import JSON** - Import wallet list from file\n3. **Export JSON** - Export current wallet list for backup/share\n\n## MCP Server\n\nThis project includes an MCP server published as [`hyperliquid-tracker-mcp`](https://www.npmjs.com/package/hyperliquid-tracker-mcp) on npm.\n\n### Use via npm (recommended)\n\n```bash\nnpx hyperliquid-tracker-mcp\n```\n\n### MCP client config\n\nAdd to your MCP config (Claude Desktop, Cursor, Windsurf, opencode):\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperliquid-tracker\": {\n      \"command\": \"npx\",\n      \"args\": [\"hyperliquid-tracker-mcp\"]\n    }\n  }\n}\n```\n\n### Available MCP tools\n\n| Tool | Description |\n|------|-------------|\n| `list_tracked_wallets` | List configured wallet addresses |\n| `add_wallet` | Add a wallet address to track |\n| `remove_wallet` | Remove a wallet address |\n| `clear_wallets` | Clear all tracked wallets |\n| `get_all_mids` | Get mid prices for all perp coins |\n| `get_account_summary` | Get account summary for a wallet |\n| `get_wallet_positions` | Get detailed positions for a wallet |\n| `get_multi_wallet_summary` | Aggregate summary across multiple wallets |\n\n### MCP package source\n\nThe MCP server source lives in [`mcp/`](./mcp/) and can be developed locally:\n\n```bash\ncd mcp\nnpm install\nnpm run dev\n```\n\nSee [`mcp/README.md`](./mcp/README.md) for full MCP package documentation.\n\n## Project Structure\n\n```\nhyperliquid-wallet-tracker/\n├── mcp/                           # MCP server (npm package)\n│   ├── src/\n│   │   ├── server.ts              # MCP stdio server\n│   │   ├── hyperliquid.ts         # Hyperliquid API client\n│   │   ├── config-store.ts        # JSON config read/write\n│   │   ├── types.ts               # TypeScript types\n│   │   └── utils.ts               # Utility functions\n│   ├── package.json               # npm package config\n│   ├── tsconfig.json\n│   └── README.md\n├── app/\n│   ├── globals.css                # Global styles + Tailwind\n│   ├── layout.tsx                 # Root layout\n│   └── page.tsx                   # Dashboard page\n├── components/\n│   ├── dashboard/\n│   │   ├── AccountSkeleton.tsx\n│   │   ├── PositionTable.tsx\n│   │   ├── SummaryCards.tsx\n│   │   ├── WalletDashboard.tsx\n│   │   └── WalletSelector.tsx\n│   ├── providers/\n│   │   └── ToastProvider.tsx\n│   └── ui/                        # shadcn/ui components\n├── hooks/\n│   └── useWalletPolling.ts        # Polling hook with change detection\n├── lib/\n│   ├── hyperliquid.ts             # SDK client + data fetching\n│   ├── types.ts                   # TypeScript type definitions\n│   └── utils.ts                   # Utility functions\n├── data/\n│   └── config.json                # Default config\n├── mcp.json                       # MCP client config example\n├── package.json\n└── tsconfig.json\n```\n\n## API Reference\n\nThis project uses the public Info API endpoints from Hyperliquid:\n\n- `POST /info` with `type: \"clearinghouseState\"` - Get account summary and positions\n- `POST /info` with `type: \"allMids\"` - Get current mid prices for all coins\n\nSee [@nktkas/hyperliquid documentation](https://nktkas.gitbook.io/hyperliquid/) for more details.\n\n## Building for Production\n\n```bash\nnpm run build\nnpm start\n```\n\n## Type Checking\n\n```bash\nnpm run typecheck\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nMIT License - feel free to use this project for any purpose.\n\n## Acknowledgments\n\n- [Hyperliquid](https://hyperliquid.xyz/) - The perpetuals DEX\n- [@nktkas/hyperliquid](https://github.com/nktkas/hyperliquid) - Community TypeScript SDK\n- [shadcn/ui](https://ui.shadcn.com/) - Beautiful UI components\n- [Vercel](https://vercel.com/) - Next.js framework\n\n---\n\n**Note:** This is a read-only tracker. It does not require any private keys or signing capabilities. All data is fetched from public API endpoints.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmgalihpp%2Fhyperliquid-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmgalihpp%2Fhyperliquid-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmgalihpp%2Fhyperliquid-tracker/lists"}