retrogtx/whale-tracker — explained in plain English
Analysis updated 2026-05-18
Monitor the live Bitcoin mempool for transactions above a configurable dollar threshold.
Verify a detected whale transaction independently using its transaction ID and a block explorer link.
Get a read-only swap quote on Whop for a whale sized trade without moving any funds.
Enable live copy-trading on Whop once you are ready to execute real swaps.
| retrogtx/whale-tracker | 0xradioac7iv/tempfs | 7vignesh/pgpulse | |
|---|---|---|---|
| Stars | 0 | 0 | 0 |
| Language | TypeScript | TypeScript | TypeScript |
| Setup difficulty | moderate | moderate | moderate |
| Complexity | 3/5 | 3/5 | 4/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires Node 20+ and pnpm, a Whop API key is needed to enable copy-trading, and real trading requires deliberately turning on a live-trade setting.
Whale Tracker watches the Bitcoin network for very large transactions, often called whales, and can optionally copy those trades on a platform called Whop. It comes with both a terminal bot and a web dashboard, and it was inspired by another project called bitcoin_trading_bot, built using the official Whop SDK. The tool works in three steps. First it detects whales by polling a live feed of unconfirmed transactions from blockchain.info and valuing each one at the current Bitcoin price. Any transaction worth at least a set threshold, one million dollars by default, counts as a whale. Second, it verifies each whale by keeping the transaction's real ID along with a link to a block explorer called mempool.space, so anyone can check the transaction independently. Third, for each new whale it can request a real swap quote on Whop to convert USDT into cbBTC at a size you configure. It only actually places a trade when a setting called COPY_TRADE_LIVE is turned on. Otherwise it only fetches a quote and moves no money, which the README calls a dry run. The project is organized into three packages: a core package handling configuration, the Bitcoin data feed, whale detection, and the copy trading logic, a command line package for the terminal bot, and a Next.js web package for the dashboard. To set it up you need Node version 20 or newer and the pnpm package manager, then you install dependencies and copy an example environment file. Whale tracking alone works without any changes to that file, but adding a Whop API key enables the copy trade feature. Several settings are optional and have defaults, including the whale dollar threshold and the trade budget. You start the terminal bot or the web dashboard with separate pnpm commands. The README stresses that live trading is off unless you deliberately enable it, that quotes alone move no funds, and that the Whop API key is only ever used on the server, never sent to the browser.
A tool that detects large Bitcoin transactions on the live mempool and can optionally copy-trade them on Whop, with a terminal bot and web dashboard.
Mainly TypeScript. The stack also includes TypeScript, Next.js, Node.js.
No license is stated in the README, so usage rights are unclear.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.