copy open copy.top
copy.top / developers / fomo api

fomo traders api: the leaderboard, their trades and what they are buying now

this is copy.top's API on traders who have a public profile on the fomo app: who makes money, what they hold, what they are buying right now. it is free and open without a key. it is not an API of the fomo app, and copy.top is independent.

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}}}'

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"}}}'

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"}}}'

how the API works

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.

other guides

examples tested on November 16, 2026. copy.top is independent: it is not affiliated with fomo, pump.fun, Hyperliquid or Polymarket. the copy.top 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.