copy.top open the terminal

copy.top docs

docs for copy.top's free API and MCP server: top traders' pnl leaderboard, wallet profiles, live trades, smart money signals and alerts on fomo, pump.fun and Hyperliquid. no key needed.

this page in Markdown · llms.txt · openapi

copy.top tracks what top traders buy and sell on the fomo app, pump.fun and Hyperliquid. the same data is open to developers and AI agents in two ways: an MCP server and a REST API. both are free, read-only, and work without a key.

MCP serverhttps://copy.top/mcp (streamable http, JSON-RPC 2.0)
REST APIhttps://copy.top/v1 (GET, JSON)
OpenAPIhttps://copy.top/v1/openapi.json
version0.2.2
pricingfree. a free key raises the limits. there is no paid plan.

start here

tools

toolwhat it returnsaccessREST
searchfind traders and coins on copy.top by name, handle, @x, $ticker or addressno keyGET /v1/search
get_tradera trader's copy.top profile, like a wallet tracker (fomo or pump.fun): pnl 30d (realized, unrealized, total), roi, win rate, fair play verdict and badges, followers, copiers, platforms, largest open positions, latest trades and theses.no keyGET /v1/traders/{handle}
get_leaderboardthe pnl leaderboard of top traders (fomo and pump.fun wallets), ranked like copy.top's discover pageno keyGET /v1/traders
get_tokena coin's copy.top page: price, market cap, 1h and 24h moves, liquidity, which tracked traders hold it or sold it and their pnl on it, and their theses.no keyGET /v1/coins/{chain}/{address}
get_thesesthe latest or most popular theses (a trader's written reason for holding a coin) posted by tracked traders in the last 24 h at most, with the coin and their pnl at post.no keyGET /v1/theses
get_hot_coinsthe signal feed: coins tracked traders are buying nowno keyGET /v1/coins/hot
get_live_tradesthe live tape: the latest buys and sells by tracked traders (fomo and pump.fun), newest firstno keyGET /v1/trades
get_alertsevents since a cursor, for alert bots: confluence (several top traders bought the same coin recently), big_trade (one tracked trader bought or sold a large amount) and thesis (a tracked trader posted a thesis)no keyGET /v1/alerts
get_hot_indexcopy.top's hot index: coins ranked 0-100 by attention right now, mixing tracked traders buying, callers and x activity (voices, views)no keyGET /v1/coins/index
get_money_flowwhere tracked traders' dollars go: coins ranked by dollars bought (side buy) or sold (side sell) over 1h, 6h, 24h or 7d, with the number of traders.no keyGET /v1/coins/flow
get_dex_paidcoins whose team paid for a dexscreener profile in the last 24 h (a sign the team is spending), with price, market cap, liquidity, volume and moves.no keyGET /v1/coins/dex-paid
hl_get_tradersrank hyperliquid perps traders tracked by copy.topno keyGET /v1/hyperliquid/traders
hl_get_tradera hyperliquid trader by address: profile and metrics (win rate, profit factor, drawdown, usual leverage, score), pnl per window, open positions with entry, size, leverage and liquidation price, and latest fills.no keyGET /v1/hyperliquid/traders/{address}
hl_get_marketslive hyperliquid markets (crypto perps and hip-3: stocks, indices, commodities, fx): mark price, 24h change, 24h volume, open interest, hourly funding, max leverageno keyGET /v1/hyperliquid/markets
hl_get_market_readcopy.top's read of one major hyperliquid market: technicals (rsi, emas, trend), funding vs its history and other venues, premium, open interest changes, what the top 300 traders hold and their latest moves, nearby liquidations, fear and greed.no keyGET /v1/hyperliquid/markets/{coin}
hl_get_callsx analysts ranked by the track record of their calls on one hyperliquid market, and their recent calls.no keyGET /v1/hyperliquid/markets/{coin}/calls
create_alert_webhookpush alerts to your server: copy.top will POST new events (confluence, big_trade, thesis) to an https url, checked once a minute, with your thresholdskeyMCP only
list_alert_webhooksyour alert webhooks: url, thresholds, whether each is active, last delivery, events sent, and the last error if it is failing.keyMCP only
delete_alert_webhookstop and delete one of your alert webhooks, by the id list_alert_webhooks returned.keyMCP only

guides

every page of these docs is also available as Markdown: add .md to its address (this page: /docs.md). the full list is in /llms.txt.

docs generated from the server's own tool definitions, version 0.2.2. copy.top is independent: it is not affiliated with fomo, pump.fun or Hyperliquid. the API is read-only: nothing here places an order. figures are data, not advice. trading crypto is risky and past performance does not predict results.

copy the top.

see who wins, what they buy, and copy them from your own wallet.

find a trader