# 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.

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

- [quickstart: your first call in one minute](https://copy.top/docs/quickstart.md)
- [add the MCP server to Claude, Cursor, VS Code or ChatGPT](https://copy.top/docs/mcp-setup.md)
- [the REST API](https://copy.top/docs/rest-api.md)
- [keys, limits and pricing](https://copy.top/docs/keys-limits-pricing.md)

## tools

| tool | what it returns | access | REST |
| --- | --- | --- | --- |
| [search](https://copy.top/docs/tools/search.md) | find traders and coins on copy.top by name, handle, @x, $ticker or address | no key | GET /v1/search |
| [get_trader](https://copy.top/docs/tools/get-trader.md) | 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](https://copy.top/docs/tools/get-leaderboard.md) | 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](https://copy.top/docs/tools/get-token.md) | 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](https://copy.top/docs/tools/get-theses.md) | 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](https://copy.top/docs/tools/get-hot-coins.md) | the signal feed: coins tracked traders are buying now | no key | GET /v1/coins/hot |
| [get_live_trades](https://copy.top/docs/tools/get-live-trades.md) | the live tape: the latest buys and sells by tracked traders (fomo and pump.fun), newest first | no key | GET /v1/trades |
| [get_alerts](https://copy.top/docs/tools/get-alerts.md) | 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](https://copy.top/docs/tools/get-hot-index.md) | 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](https://copy.top/docs/tools/get-money-flow.md) | 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](https://copy.top/docs/tools/get-dex-paid.md) | 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](https://copy.top/docs/tools/hl-get-traders.md) | rank hyperliquid perps traders tracked by copy.top | no key | GET /v1/hyperliquid/traders |
| [hl_get_trader](https://copy.top/docs/tools/hl-get-trader.md) | 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](https://copy.top/docs/tools/hl-get-markets.md) | 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](https://copy.top/docs/tools/hl-get-market-read.md) | 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](https://copy.top/docs/tools/hl-get-calls.md) | 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](https://copy.top/docs/tools/create-alert-webhook.md) | 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](https://copy.top/docs/tools/list-alert-webhooks.md) | 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](https://copy.top/docs/tools/delete-alert-webhook.md) | stop and delete one of your alert webhooks, by the id list_alert_webhooks returned. | key | MCP only |

## guides

- [alerts: polling with a cursor, or webhooks](https://copy.top/docs/alerts.md)
- [what the numbers mean: pnl, roi, fair play](https://copy.top/docs/data.md)
- [errors and limits](https://copy.top/docs/errors.md)
- [ready-made prompts](https://copy.top/docs/prompts.md)
- [changelog](https://copy.top/docs/changelog.md)

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.

---
html: https://copy.top/docs · all docs: https://copy.top/docs.md · copy.top is independent: 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.
