fomo leaderboard
rank fomo traders by realized pnl, total pnl, roi, win rate or number of copiers, over 1, 7 or 30 days. filter by chain or by fair play verdict.
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":"fomo","limit":20}}}'
- each row: handle, name, pnl, realized, unrealized, roi, winRate, closed positions, fairPlay, followers, copiers, median hold time, chains and a link to the trader's page.
one trader
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_trader","arguments":{"handle":"HANDLE"}}}'
- the profile: pnl over 30 days (realized, unrealized, total), roi, win rate, fair play verdict, badges, followers, copiers, open positions and recent trades.
- not sure of the handle? call search with a name, an @handle or an address first.
theses, live trades and alerts
get_theses returns the written reasons traders post for holding a coin, newest or most popular. get_live_trades is the tape. get_alerts turns both into events and returns a cursor to pass back as since.
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_theses","arguments":{"sort":"popular","hours":24}}}'
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"}}}'
- coins that several tracked traders bought in the last hour, with dollars in and out and how many still hold.
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 an API for fomo traders?
copy.top has one: leaderboard, trader profiles, live trades, theses and alerts on traders with a public fomo profile. it is free and open without a key.
is this the official fomo API?
no. it is copy.top's API. copy.top is independent and not affiliated with, endorsed by or operated by fomo.
what is the fair play verdict?
a verdict read from a trader's own trades: clean, watch (many trades sold within ten minutes, or sells into their copiers) or flagged.
can I copy a fomo trader from the API?
no. the API is read-only: nothing here places an order. to copy a trader, open their page on copy.top.
how often can I call it?
about 20 calls a minute without a key, a little less on search and on single trader or coin lookups. a free key raises the limits.