pumpfun top traders
rank pumpfun accounts by realized pnl, total pnl, roi, win rate or number of copiers, over 1, 7 or 30 days.
curl -s https://copy.top/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_leaderboard","arguments":{"window":"30d","sort":"realized","platform":"pumpfun","limit":20}}}'
- each row: handle, name, pnl, realized, unrealized, roi, winRate, closed positions, followers, copiers, median hold time and a link to the trader's page.
- a handle that starts with pf_ is a pumpfun account. pass it to get_trader for the full profile, open positions and recent trades.
what top traders are buying now
curl -s https://copy.top/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_hot_coins","arguments":{"window":"1h"}}}'
- each coin: how many tracked traders bought it, how many top traders, how many still hold, dollars bought and sold, minutes since the first and the last buy, and the buyers' handles.
live trades and alerts
get_live_trades is the tape: the latest buys and sells, newest first. get_alerts turns it into events: several top traders on the same coin, or one large trade. both return a cursor: pass it back as since on the next call. once a minute is enough.
curl -s https://copy.top/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_alerts","arguments":{"min_top_traders":3,"kinds":["confluence"]}}}'
all the tools
| search | query | traders and coins by name, @handle, $ticker or address |
|---|---|---|
| get_leaderboard | window, sort, platform | ranked traders |
| get_trader | handle | profile, pnl over 30 days, win rate, positions, trades |
| get_token | chain, address | a coin: price, market cap, liquidity, which tracked traders hold it or sold |
| get_hot_coins | window | coins tracked traders are buying now |
| get_live_trades | since, side, min_usd | the live tape |
| get_alerts | since, min_top_traders, kinds | confluence, big trades and theses as events |
| get_money_flow | side, window | coins ranked by dollars bought or sold |
| get_hot_index | window, chain | coins ranked 0 to 100 by attention |
| get_dex_paid | none | coins whose team paid for a dexscreener profile in the last 24 h |
how the API works
- one endpoint: POST https://copy.top/mcp, JSON-RPC 2.0. use copy.top without www.
- the answer is in result.content[0].text, as a JSON string. the body can arrive as an event stream: read the first line that starts with "data: ".
- no key is needed for the public tools. the limit is about 20 calls a minute per address.
- a free key raises the limits and opens the Hyperliquid tools. create it at copy.top/account#api and send it as Authorization: Bearer <key>.
- the same tools work as an MCP server in Claude, ChatGPT, Cursor and other agents, and from the terminal with npm i -g copytop.
faq
is there a free pumpfun API for top traders?
yes. copy.top's API returns pumpfun traders ranked by realized pnl, with win rate, hold time, positions and recent trades. it is open without a key, at about 20 calls a minute.
is this the official pump.fun API?
no. it is copy.top's API about pumpfun traders. copy.top is independent and not affiliated with pump.fun.
do I need a pumpfun scraper?
not for trader data. one request returns the leaderboard or the live trades as JSON, and it does not break when a website changes.
can I get alerts when several top traders buy the same coin?
yes: get_alerts with kinds set to confluence and min_top_traders set to the number you want. keep the cursor it returns and poll once a minute.
can I use it from Python, Zapier or an AI agent?
yes. it is plain HTTP, so any language works. it is also an MCP server for agents, and a command line tool: npm i -g copytop.