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 server | https://copy.top/mcp (streamable http, JSON-RPC 2.0) |
|---|---|
| REST API | https://copy.top/v1 (GET, JSON) |
| OpenAPI | https://copy.top/v1/openapi.json |
| version | 0.2.2 |
| pricing | free. a free key raises the limits. there is no paid plan. |
start here
tools
| tool | what it returns | access | REST |
|---|---|---|---|
| search | find traders and coins on copy.top by name, handle, @x, $ticker or address | no key | GET /v1/search |
| get_trader | a 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 key | GET /v1/traders/{handle} |
| get_leaderboard | the pnl leaderboard of top traders (fomo and pump.fun wallets), ranked like copy.top's discover page | no key | GET /v1/traders |
| get_token | a 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 key | GET /v1/coins/{chain}/{address} |
| get_theses | the 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 key | GET /v1/theses |
| get_hot_coins | the signal feed: coins tracked traders are buying now | no key | GET /v1/coins/hot |
| get_live_trades | the live tape: the latest buys and sells by tracked traders (fomo and pump.fun), newest first | no key | GET /v1/trades |
| get_alerts | events 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 key | GET /v1/alerts |
| get_hot_index | copy.top's hot index: coins ranked 0-100 by attention right now, mixing tracked traders buying, callers and x activity (voices, views) | no key | GET /v1/coins/index |
| get_money_flow | where 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 key | GET /v1/coins/flow |
| get_dex_paid | coins 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 key | GET /v1/coins/dex-paid |
| hl_get_traders | rank hyperliquid perps traders tracked by copy.top | no key | GET /v1/hyperliquid/traders |
| hl_get_trader | a 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 key | GET /v1/hyperliquid/traders/{address} |
| hl_get_markets | live hyperliquid markets (crypto perps and hip-3: stocks, indices, commodities, fx): mark price, 24h change, 24h volume, open interest, hourly funding, max leverage | no key | GET /v1/hyperliquid/markets |
| hl_get_market_read | copy.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 key | GET /v1/hyperliquid/markets/{coin} |
| hl_get_calls | x analysts ranked by the track record of their calls on one hyperliquid market, and their recent calls. | no key | GET /v1/hyperliquid/markets/{coin}/calls |
| create_alert_webhook | push alerts to your server: copy.top will POST new events (confluence, big_trade, thesis) to an https url, checked once a minute, with your thresholds | key | MCP only |
| list_alert_webhooks | your alert webhooks: url, thresholds, whether each is active, last delivery, events sent, and the last error if it is failing. | key | MCP only |
| delete_alert_webhook | stop and delete one of your alert webhooks, by the id list_alert_webhooks returned. | key | MCP 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.
copy.top