An open-source pump.fun wallet tracker with live trades

A ready-made pump.fun wallet tracker. Watch any Solana or EVM wallets, see every trade they make within a second, with each wallet's value, 7-day PnL and holdings. Open source, with a live demo.

pump.funNext.jsshadcn/uiSolanaEVM

17 min read

Credits
about 464,000 a month with 20 wallets
Runs on
Node.js 22 on any always-on machine
License
MIT, open source
The pump.fun wallet tracker's dashboard, with each watched wallet's value and 7-day PnL, and their trades coming in live

Some wallets are worth watching: a trader who keeps topping the leaderboard, a whale, a dev, or your own. This app watches them for you. Every time one of them buys or sells on pump.fun, the trade shows up on your dashboard within a second, with the coin, the size and the market cap. Next to each wallet you see what it's worth, how its week went and what it holds.

It's a complete Next.js app, open source under MIT. It only reads, so there's no wallet to connect and no key to sign with. Open the live demo to see it watch pump.fun's top traders right now, or download the code (it's also on GitHub).

What it does

  • Watches any wallets you give it. You can add:
    • a Solana or EVM address;
    • a pump.fun username or profile link;
    • a Solscan, Basescan, BscScan or Etherscan address link;
    • a whole list, pasted in, one per line, with your own labels;
    • anyone from pump.fun's daily, weekly or monthly PnL leaderboard, in one click.
  • Shows their trades live. One connection to the pumpfomo stream carries the trades of up to 1,000 addresses, on Solana and on pump.fun's EVM chains, with no polling. Each trade shows its size, the coin's logo, name and market cap, the chain and a link to the transaction.
  • Brings a wallet's owner along. When a wallet belongs to a pump.fun profile, you get the name, picture and follower count, and the profile's other wallet (Solana or EVM) is watched too.
  • Fills in the recent past. A wallet you add comes with its last trades, so the feed isn't empty while you wait.
  • Keeps each wallet's numbers. The list shows every wallet's total value and its PnL over the last 7 days, refreshed on a schedule you set.
  • Opens a card for any wallet with:
    • its value on each chain, with the addresses;
    • a 7-day chart of the portfolio;
    • trades and volume over a day, a week, a month and all time, and its biggest trade;
    • what it holds, by value, with the PnL on each coin;
    • its recent trades, and links to Solscan, DeBank and pump.fun.
  • Tells you when a wallet trades. Turn on notifications for a wallet and you get a sound, a toast and a browser notification each time it trades.
  • Filters and exports. Narrow the feed by wallet, by buys or sells and by size, and download what you see as CSV.
  • Shows what a month costs. The Settings panel works out the month's credits for your own list as you change the schedule.

Try the live demo

The demo runs the same app in a read-only mode:

  • It watches the day's top 20 pump.fun traders and a few of pump.fun's busiest wallets, so trades come in within minutes.
  • Click any wallet for its card: value, chart, stats and holdings all load.
  • Notifications work, because they're kept in your browser.
  • Nobody can add, remove or rename wallets or change the settings, and the credit balance is hidden.
  • Wallets, coins and leaderboard rows with slurs or hate terms in their names are left out.

Your own copy watches whatever you give it.

What you need

What Why
Node.js 22 or newer The app uses Node's built-in WebSocket and fetch.
A pumpfomo API key with the stream scope Streams come with the Builder plan and up: $149 a month, or $1,249.90 a year. Free and Starter keys can't open a stream. See pricing.
A machine that stays on A VPS, a home server or a container, to watch around the clock.

No wallet and no private key: the app never signs anything.

Each running app holds one stream. To run this tracker and, say, the pump.fun copy trader at the same time, you need two streams, which is the Growth plan.

Create the key at pumpfomo.com/dashboard. New keys have every scope unless you limit them.

Quick start

bash
curl -LO https://pumpfomo.com/downloads/pumpfun-wallet-tracker.zip
unzip pumpfun-wallet-tracker.zip
cd pumpfun-wallet-tracker
npm install
cp .env.example .env.local

Open .env.local and set at least:

ini
PUMPFOMO_API_KEY=pf_live_...   # with the stream scope
TRACK_TOP=20                   # start with the week's top 20, or leave 0 and add your own

To start with wallets you already know, set WALLETS instead, for example WALLETS=whale=<wallet address>,someusername. Then start it:

bash
npm run dev

Open http://127.0.0.1:3003. The header should say stream live. Within a minute the wallets fill in with their pictures, values and PnL, and their last trades appear in the feed. New trades come in as they happen.

For a production build, use npm run build && npm start on the same address.

Configuration

The key and the first-run wallet list are set in .env.local. The rest starts from .env.local too, and can be changed any time in the dashboard. Open Settings (the sliders icon), edit and save. The change applies at once, with no restart, and is saved in data/settings.json, which wins over .env.local from then on. Delete that file to go back to .env.local.

Key and first run

Variable Default What it does
PUMPFOMO_API_KEY – Your pumpfomo key. It needs the stream scope.
WALLETS – Wallets to watch on the first run: addresses, usernames or links, comma separated. label=wallet gives one a label. After that, the list is kept in data/wallets.json.
TRACK_TOP 0 On the first run, also watch the top N wallets of pump.fun's PnL leaderboard (0 to 100).
TOP_WINDOW weekly The leaderboard window for TRACK_TOP: daily, weekly or monthly.

What the stream sends

Variable Default What it does
MIN_TRADE_USD 0 Leave out trades smaller than this, in USD. The stream doesn't send them at all. 0: every trade.
SOLANA_ONLY false true leaves out the wallets' trades on Base, BNB Chain and pump.fun's other EVM chains.

How often the numbers are looked up

Variable Default What it does
VALUE_REFRESH_MIN 60 How often total values and SOL balances are looked up again, in minutes, from 15 to 1,440. 5 credits per 20 wallets.
PNL_REFRESH_MIN 360 How often the 7-day PnL is looked up again, in minutes: 60 or more, or 0 to turn it off. 5 credits a wallet.
REFRESH_AFTER_TRADE true Look again at the value of wallets that just traded, at most every 15 minutes.
BACKFILL true Fill the feed with a wallet's last trades when it's added, for 2 credits.

Storage and modes

Variable Default What it does
HIDE_OFFENSIVE false true leaves out trades, wallets, holdings and leaderboard rows whose coin or user name has a slur or hate term in it.
DATA_DIR data Where the wallet list, the feed, coin names and settings are kept.
DEMO_MODE false true makes a read-only public demo. See Running it for real.

The Settings panel

Settings has the same fields as the last three groups, in two parts:

  • Live trades: the smallest trade to show, Solana only, and whether new wallets come with their last trades.
  • Wallet numbers: how often values and PnL are refreshed, and the refresh after a trade.

Under the fields, a table shows what a month will cost with your list and these settings, line by line, before you save.

Using the dashboard

Adding wallets

There are four ways, and you can mix them.

One wallet. Press Add wallets in the header. The One wallet tab takes any of these, with an optional label of up to 40 characters:

  • a Solana address, or an EVM address (0x…);
  • a pump.fun username, as someone or @someone;
  • a pump.fun profile link (https://pump.fun/profile/…);
  • a Solscan, Basescan, BscScan or Etherscan address link.

The app looks the wallet up once, for 1 credit, and fills in its last trades for 2. A toast says whether it found a pump.fun profile or watches the wallet by its address.

Paste a list. The Paste a list tab takes one wallet per line, up to 1,000 lines:

text
# one per line: a wallet, a pump.fun username or a profile link
# add a label before or after it, with a comma
whale one, 9tH2…amAp
0x5894…e9f1, base wallet
someusername
  • A label can go before or after the wallet, separated by a comma. =, ; or a tab work too, and so does a space after an address.
  • Lines starting with # are skipped, and so are blank lines.
  • Profiles are looked up 50 at a time, for 5 credits per 50.
  • When it's done, a toast says how many it added, how many you were already watching, and how many lines it didn't understand.

From the leaderboard. In Who you watch, open the Leaderboard tab. Load pump.fun's top 100 by PnL for a day, a week or a month, for 1 credit, and press Watch next to anyone.

On the first run, from .env.local. WALLETS takes a comma-separated list of any of the above, and TRACK_TOP adds the top N of the TOP_WINDOW leaderboard.

Profiles and EVM wallets

How a wallet is watched depends on what pump.fun knows about it:

  • It belongs to a pump.fun profile. You get the name, picture and followers, and the profile's other wallet is watched too. A profile has one Solana and one EVM wallet, and trades from either show under the same name.
  • It has no profile. It's watched by its address, under your label.

Value, holdings and trading stats are read for Solana wallets. An EVM wallet gets them through its profile's Solana wallet, which covers both. An EVM wallet with no profile still shows its trades, its 7-day PnL and its chart, but no value or holdings.

The wallet list

Who you watch has two tabs. Watching lists your wallets with their picture or label, value, 7-day PnL and when each last traded. Search by name or address, and sort by value, 7-day PnL, last trade or name.

The stream watches up to 1,000 addresses on one connection, and the list is saved in data/wallets.json.

The wallet card

Click a wallet to open its card:

  • value on each chain, with the addresses and copy buttons;
  • a 7-day chart of the portfolio;
  • trades and volume over a day, a week, a month and all time, and the biggest trade;
  • holdings by value, with the PnL on each coin;
  • recent trades;
  • links to Solscan, DeBank (for EVM wallets) and the pump.fun profile.

A card costs 9 credits the first time and is kept for 10 minutes, so opening it again is free. Rename a wallet with the pencil next to its name, or remove it, from the card.

Notifications

In a wallet's card, turn on Notify me when it trades. From then on, each new trade of that wallet plays a short sound and shows a toast. If the tab is in the background, you also get a browser notification. The browser asks for permission once.

Which wallets notify you is kept in this browser, not on the server. That's why it works on the demo too, and why each browser keeps its own choice.

The live feed and CSV

Their trades shows every trade of your wallets, newest first, up to the last 500. Each row has the wallet, buy or sell, the size, the coin with its logo and market cap, the chain and a link to the transaction.

Filter by wallet, by buys or sells, and by a smallest size. The download button saves exactly what you see as a CSV file, with these columns:

text
time, wallet, address, side, chain, token, token_address, amount_usd, market_cap_usd, tx

The rest of the dashboard

Section What it shows
Header The stream's state, credits left, a light/dark switch, Settings and Add wallets.
Stats How many wallets you watch and how many have a profile, their total value, today's trades (buys, sells, volume) and today's biggest trade.

How it works

  1. At start, the app checks your key with GET /v1/ping (free). If the wallet list is empty, it adds WALLETS and the TRACK_TOP leaderboard.
  2. Each wallet you add is looked up once: a single wallet with GET /v1/pump/users/{wallet}, a list 50 at a time with POST /v1/pump/users/batch, a username with GET /v1/pump/search/users. A profile's other wallet joins the list.
  3. With backfill on, its last 12 trades come from GET /v1/pump/users/{wallet}/trades.
  4. It opens one stream and subscribes the trades channel with every address on the list. When the list or the settings change, it sends a new subscription, which replaces the old one.
  5. Each trade is matched to its wallet. New coins are named with POST /v1/pump/coins/batch, up to 50 at a time, and the answers are kept on disk.
  6. On a schedule, the app refreshes values with POST /v1/pump/wallets/overview (20 wallets a call) and the 7-day PnL with GET /v1/pump/users/{wallet}/pnl. With refresh after trade on, a wallet that just traded gets its value looked up again, at most every 15 minutes.
  7. A wallet's card calls the balance, holdings, trading stats and chart endpoints when you open it, and keeps the answers for 10 minutes.
  8. The dashboard follows all of this live through server-sent events from /api/events.

If the stream drops, the app reconnects with a growing wait and subscribes again.

Project layout

Path What's in it
app/page.js The dashboard, live through /api/events, with the notification sound and browser notifications.
app/api/…/route.js State, events, wallets, list import, wallet cards, settings and the leaderboard.
components/dashboard/ Header, stats, wallet list, live trades, wallet card, add dialog, settings and setup.
components/ui/, components/icon.jsx shadcn/ui components and the icons.
instrumentation.js Starts the tracker once when the Next.js server starts.
lib/runtime.js The one tracker per server: the stream, the store and the refresh schedule.
lib/wallets.js Everything pump.fun-specific: parsing what you type, the subscription, trades, values, PnL and holdings.
lib/budget.js What a month costs, for the Settings panel.
lib/settings.js, lib/config.js The settings the dashboard can change, and .env.local.
lib/store.js The JSON files in DATA_DIR.
lib/app.js Chains, explorers and links the page shows.
lib/clean.js The slur and hate-term filter.
lib/guard.js The localhost-only check for the API routes.
lib/pumpfomo/ A small pumpfomo client for REST and the live stream, with no dependencies.

What it costs to run

An open stream costs 10 credits a minute. Watching 1 wallet or 1,000 costs the same, and there's no charge per message. Here is a month left on day and night, with 20 Solana wallets and the default settings:

What When Credits a month
The live stream always, 10 a minute 432,000
Total value and SOL balance every hour, 20 wallets a call, 5 a call 3,600
PnL over the last 7 days every 6 hours, 5 a wallet 12,000
Value again after a wallet trades at most every 15 minutes, 5 per 20 wallets that traded up to 14,400
Coin names, logos and market caps new coins, 50 a lookup, 5 a lookup about 1,000
Wallet cards you open 9 a card, kept 10 minutes about 900 for 100 cards
Adding a wallet its profile (1, or 5 per 50 in a list) and last trades (2) a few
Total about 464,000

That fits in Builder's 500,000.

More wallets. What grows with the list is the 7-day PnL, at 5 credits per wallet each time, and, much less, the values, at 5 credits per 20 wallets. With a big list, refresh PnL less often or turn it off, and turn off the refresh after trades:

Wallets Settings Credits a month
20 the defaults about 464,000
100 PnL daily, no refresh after trades about 467,000
200 values every 2 hours, no PnL about 452,000
1,000 values daily, no PnL about 441,000

A wallet's card always shows its PnL and holdings when you open it, whatever the schedule.

Running it for real

On an always-on machine

The tracker lives inside the Next.js server process, so it needs a machine that stays up: a VPS, a home server or a container. Build once and start it:

bash
npm run build
npm start

To keep it running and bring it back after a reboot, use a process manager. With pm2:

bash
npm install -g pm2
pm2 start npm --name pumpfun-wallet-tracker -- start
pm2 save
pm2 startup

Or with systemd, in /etc/systemd/system/pumpfun-wallet-tracker.service:

ini
[Unit]
Description=pump.fun wallet tracker
After=network-online.target

[Service]
User=you
WorkingDirectory=/home/you/pumpfun-wallet-tracker
ExecStart=/usr/bin/npm start
Restart=always
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target

Then run sudo systemctl enable --now pumpfun-wallet-tracker. Check where npm lives with which npm, and make sure it's Node 22 or newer.

Reaching the dashboard

The dashboard only answers to 127.0.0.1. To see it from another machine, use an SSH tunnel instead of opening the port:

bash
ssh -L 3003:127.0.0.1:3003 you@your-server

Then open http://127.0.0.1:3003 on your own computer.

Serverless hosts

On Vercel functions and similar hosts, the stream only stays open while someone has the page open, so you'd miss the trades in between. They only suit the read-only demo.

A public, read-only demo

DEMO_MODE=true turns a copy into a showcase anyone can open:

  • the dashboard answers on any address;
  • adding, removing and renaming wallets, and changing settings, are refused;
  • the credit balance is hidden;
  • names with slurs or hate terms are left out.

Unless you set WALLETS, TRACK_TOP or TOP_WINDOW, it watches the day's top 20 and a few busy wallets listed in lib/demo.js. Wallet cards and the leaderboard are kept for a few minutes, so many visitors cost about as much as one. On a host whose files don't last, set DATA_DIR=/tmp/data.

In your own copy, set HIDE_OFFENSIVE=true to leave out the same names.

The pumpfomo API behind it

Call What for Credits
wss://api.pumpfomo.com/v1/stream, channel trades (reference) the wallets' trades, live 10 a minute
GET /v1/pump/users/{wallet} a wallet's profile, when you add it 1
POST /v1/pump/users/batch profiles of a pasted list or of leaderboard wallets, 50 at a time 5
GET /v1/pump/search/users adding someone by username 1
GET /v1/pump/users/{id}/trades a new wallet's last trades 2
POST /v1/pump/wallets/overview total value and SOL balance, 20 wallets at a time 5
GET /v1/pump/users/{wallet}/pnl the last 7 days' PnL 5
GET /v1/pump/users/{wallet}/balance the value on each chain, on a wallet's card 1
GET /v1/pump/users/{wallet}/balances what it holds, on its card 2
GET /v1/pump/users/{wallet}/trader-stats trades, volume and biggest trade, on its card 1
GET /v1/pump/users/{wallet}/pnl/chart the 7-day chart, on its card 5
POST /v1/pump/coins/batch coin names, logos and market caps, 50 at a time 5
GET /v1/pump/leaderboard the leaderboard tab, and TRACK_TOP 1
GET /v1/ping checking the key and its scopes at start free

The subscription it sends:

json
{ "op": "subscribe", "channel": "trades", "wallets": ["<solana address>", "<evm address>"] }

With MIN_TRADE_USD it adds "minUsd": 100, and with SOLANA_ONLY, "chains": ["solana"]. A trade it receives looks like this, trimmed:

json
{
  "type": "trade",
  "platform": "pump",
  "chain": "solana",
  "mint": "7ttf…pump",
  "side": "buy",
  "wallet": "9tH2…amAp",
  "amountUsd": 412.5,
  "marketCapUsd": 98200,
  "trader": { "userId": "379becb2-…", "handle": "someone" },
  "ts": 1792969931000
}

The pump.fun API guide and the WebSocket guide cover the rest.

Troubleshooting

"Setup: PUMPFOMO_API_KEY is not set"

Copy .env.example to .env.local, add your key, and restart the app.

"pumpfomo refused the key"

The key is wrong, revoked or expired, so pumpfomo answers 401 or 403. Copy it again from your dashboard, whole, or create a new one.

"this pumpfomo key has no stream scope"

Edit the key's scopes in the pumpfomo dashboard to include stream, or create a new key with every scope.

The stream stopped with close code 4003

Your plan has no stream, or all of its streams are open somewhere else. Streams start at Builder, and Builder allows one at a time. Stop the other app, or move to Growth for five.

The stream stopped with close code 4002

The account is out of credits. Add credits or a credit pack in the dashboard, then restart.

The stream keeps reconnecting with code 4008

The app fell behind reading messages, usually on a very slow machine or connection. Set MIN_TRADE_USD to leave out small trades, or run it somewhere faster.

The feed is quiet

Some wallets trade a few times a day, and many top traders mostly hold. Check "traded … ago" in the list, or add a busier wallet from the daily leaderboard. A high MIN_TRADE_USD or SOLANA_ONLY also hide trades.

A username can't be added

Check the spelling on pump.fun, or add the wallet address instead.

A wallet shows "–" for its value

pump.fun has nothing priced for it yet, or the next refresh hasn't run. Open its card to look it up now. An EVM wallet with no pump.fun profile never shows a value or holdings; see Profiles and EVM wallets.

Notifications don't appear

Your browser blocked them. Allow notifications for the dashboard's address in the browser's site settings. The sound and the toast work without permission.

Port 3003 is already in use

Another program, or a second copy of the app, has the port. Stop it, or start this one on another port with npx next start -H 127.0.0.1 -p 3013.

Make it your own

The tracker lives in lib/runtime.js, everything pump.fun-specific in lib/wallets.js, and the API client in lib/pumpfomo, which you can copy into any project. Some ideas:

  • Alerts elsewhere. Post each trade of a wallet to Telegram or Discord, like the Telegram alert bot does.
  • A smart-money list. Re-pick the daily leaderboard's top wallets every morning, and drop the ones that stopped winning.
  • Copy a wallet. Put its trades through a swap, as the pump.fun copy trader does.

If you build with an AI assistant, the pumpfomo Claude skill and llms.txt give it the whole API.

Frequently asked questions

Is the app free?

The code is free and MIT licensed. The live data needs a pumpfomo plan with streams, Builder or higher.

Does it need my private key?

No. It only reads public data about the wallets you give it, so there's nothing to sign.

Can it track EVM wallets?

Yes. pump.fun trades on Base, BNB Chain and other EVM chains too, and the stream sends those trades. Value, holdings and stats come through the wallet's pump.fun profile. An EVM wallet without a profile shows its trades, its PnL and its chart, but no value or holdings.

How many wallets can it watch?

Up to 1,000 addresses on one stream connection, for the same 10 credits a minute. What grows with the list is the PnL refresh, which you can slow down or turn off.

What format does the list import take?

One wallet, username or profile link per line, with an optional label before or after it, separated by a comma. Lines starting with # are skipped.

Can I run it on Vercel?

Only as a read-only demo. On serverless hosting the stream only stays open while someone has the page open, so for a tracker that never misses a trade, run it on a VPS, a home server or a container.

Try it on real data, free.

2,500 credits a month, wallet or Telegram sign-in, no card. Every endpoint in these guides works on the Free plan; streams start at Builder.

More apps