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.
17 min read

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
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.localOpen .env.local and set at least:
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 ownTo start with wallets you already know, set WALLETS instead, for example WALLETS=whale=<wallet address>,someusername. Then start it:
npm run devOpen 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
someoneor@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:
# 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:
time, wallet, address, side, chain, token, token_address, amount_usd, market_cap_usd, txThe 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
- At start, the app checks your key with
GET /v1/ping(free). If the wallet list is empty, it addsWALLETSand theTRACK_TOPleaderboard. - Each wallet you add is looked up once: a single wallet with
GET /v1/pump/users/{wallet}, a list 50 at a time withPOST /v1/pump/users/batch, a username withGET /v1/pump/search/users. A profile's other wallet joins the list. - With backfill on, its last 12 trades come from
GET /v1/pump/users/{wallet}/trades. - It opens one stream and subscribes the
tradeschannel with every address on the list. When the list or the settings change, it sends a new subscription, which replaces the old one. - 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. - On a schedule, the app refreshes values with
POST /v1/pump/wallets/overview(20 wallets a call) and the 7-day PnL withGET /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. - A wallet's card calls the balance, holdings, trading stats and chart endpoints when you open it, and keeps the answers for 10 minutes.
- 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:
npm run build
npm startTo keep it running and bring it back after a reboot, use a process manager. With pm2:
npm install -g pm2
pm2 start npm --name pumpfun-wallet-tracker -- start
pm2 save
pm2 startupOr with systemd, in /etc/systemd/system/pumpfun-wallet-tracker.service:
[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.targetThen 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:
ssh -L 3003:127.0.0.1:3003 you@your-serverThen 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:
{ "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:
{
"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

Copy fomo.family's best traders
A ready-made fomo.family copy trading bot. It follows the traders you pick, copies their Solana buys and sells within your limits, and shows everything on a live dashboard. Open source, with a live demo.

Copy pump.fun's top traders
A ready-made pump.fun copy trading bot. Follow traders by username or wallet, copy their Solana buys and sells within your limits, and watch their PnL and trades on a live dashboard. Open source, with a demo.

Your traders, in your Telegram
A ready-made Telegram bot that alerts you the moment the traders you follow buy or sell on pump.fun or fomo.family, plus big trades, callouts and new coins. Commands in the chat, a live dashboard, open source, with a demo.

Catch new pump.fun coins as they take off
A ready-made pump.fun new coin scanner. It sees every coin the second it launches, watches its first trades live, scores its momentum and alerts you to the ones taking off. Open source, with a live demo.