Sourcerepo

Whales

See how Hyperliquid's best traders are positioned: the top wallets' open perp positions added up by coin, long against short, at what entry and leverage; every large trade as it happens; and each wallet's positions and record. Public data, no key, MIT, no dependencies.

Status
Open source
Language
TypeScript
License
MIT
Updated
Oct 2026
GitHub
A MacBook and an iPhone running the tracker in Safari: Positions lists the coins the month's top thirty traders hold, HYPE opens to show who is long and who is short with their value, entry, liquidation price and leverage, a holder's wallet opens in a card in the middle of the screen with its account, leverage, monthly profit and open positions, the tape fills with trades of $10K and up and narrows to traders on the board, and the board ranks the month's top traders

A tracker for Hyperliquid's smart money. Its main view, Positions, reads the open perp positions of the top traders on a board and adds them up by coin: how many are long and how many short, how much sits on each side, their average entry and leverage, and how much they are up. The tape shows every large trade on the busiest coins as it happens, straight from Hyperliquid's websocket, starred when it comes from a trader on the board. Any wallet opens to its account, its profit over the month, its open positions with liquidation prices, its record and its fills. Trackers like this keep where the big accounts sit and the alerts behind a monthly plan; this one is MIT licensed, plain TypeScript, with no dependencies, and runs live on drk.vc as an engine.

Install

Clone
git clone https://github.com/drkxbt/whales
Install
npm install github:drkxbt/whales
Use
whales(element, { board: "/api/board" })

Features

  • Positions: the top traders' open perp positions added up by coin, long against short, with average entries, leverage and open profit
  • The tape: trades of $10K to $1M and up on the thirty busiest coins, live from the websocket, starred when a trader on the board made it
  • Any wallet's account, leverage, monthly profit, open positions with liquidation prices, record and fills
  • Hyperliquid's board by profit for any window, without the spot holders who never trade
  • Public data with no key; a small server function condenses the forty-megabyte leaderboard

How it works

  • Hyperliquid publishes its leaderboard as one forty-megabyte file without CORS headers, so a small server function condenses it to the top 1000 of each window and the edge caches that for five minutes.
  • Accounts that trade less than $100K a month are left off the board: they mostly hold spot, and their profit is the price of what they hold.
  • Positions reads the accounts of the board's top 200 traders, keeps positions worth $1,000 or more, and adds them up by coin and side, with the entry weighted by size and the leverage by value.
  • The tape subscribes to the trades of the thirty busiest coins; every trade names its buyer and seller, so it shows under whichever of them is on the board.
  • A wallet's record counts the fills among its latest 2000 that realized a profit or a loss.

Where it shows here

Live, as an engine on drk.vc. The board comes from drk.vc's own function; the visitor's browser reads everything else from Hyperliquid directly, within Hyperliquid's own per-visitor limits.

Screenshots

  • Positions on the MacBook and the iPhone: HYPE, the coin the most top traders hold, opens to list each holder, long or short, with their value, entry, liquidation price and leverage
    PositionsWho is long, who is short, and where
  • A holder's wallet opens in a card in the middle of the screen with its account value, leverage, a chart of the month's profit and its open positions, while on the iPhone another holder's sheet rises from the bottom
    WalletA holder's account and positions
  • The tape of trades of $10K and up on Hyperliquid's busiest coins, narrowed to traders in the top 300 of this month's board, each with a star
    TapeLarge trades by top traders

Stack

  • TypeScript
  • Hyperliquid info API
  • WebSocket
  • Vercel Functions
  • Node test runner

Run it locally

git clone https://github.com/drkxbt/whalescd whalesnpm installnpm run demo