git404hub

what is whale-tracker fr?

retrogtx/whale-tracker — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 3/5Setup · moderate

tl;dr

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.

vibe map

mindmap
  root((Whale Tracker))
    What it does
      Detect BTC whales
      Verify via explorer
      Copy-trade on Whop
    Tech stack
      TypeScript
      Next.js
      pnpm
      Whop SDK
    Use cases
      Monitor mempool
      Get swap quotes
      Run terminal bot
      Run web dashboard
    Audience
      Developers
      Crypto traders
    Safety
      Live trading off by default
      Server-side API key

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Monitor the live Bitcoin mempool for transactions above a configurable dollar threshold.

VIBE 2

Verify a detected whale transaction independently using its transaction ID and a block explorer link.

VIBE 3

Get a read-only swap quote on Whop for a whale sized trade without moving any funds.

VIBE 4

Enable live copy-trading on Whop once you are ready to execute real swaps.

what's the stack?

TypeScriptNext.jsNode.jspnpmWhop SDK

how it stacks up fr

retrogtx/whale-tracker0xradioac7iv/tempfs7vignesh/pgpulse
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

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.

No license is stated in the README, so usage rights are unclear.

in plain english

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.

prompts (copy fr)

prompt 1
Walk me through setting up this whale tracker with pnpm and the .env file.
prompt 2
Explain how the whale detection threshold works and how to change it.
prompt 3
Show me how to safely test this in dry-run mode before enabling live copy-trading.
prompt 4
Explain what the three packages, core, cli, and web, each do in this project.

Frequently asked questions

what is whale-tracker fr?

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.

What language is whale-tracker written in?

Mainly TypeScript. The stack also includes TypeScript, Next.js, Node.js.

What license does whale-tracker use?

No license is stated in the README, so usage rights are unclear.

How hard is whale-tracker to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is whale-tracker for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.