copy.top open the terminal
copy.top / docs / REST API

REST API

the copy.top REST API: plain GET requests that return JSON. top traders, wallet profiles, hot coins, live trades and alerts. free, no key needed, OpenAPI file included.

this page in Markdown · llms.txt · openapi

base address: https://copy.top/v1. plain GET requests, JSON answers. each route is one tool of the MCP server, with the same parameters as query strings.

routetoolwhat it returns
GET /v1/tradersget_leaderboardTrader leaderboard (fomo and pumpfun)
GET /v1/traders/{handle}get_traderOne trader: pnl, win rate, positions, trades
GET /v1/searchsearchFind traders and coins by name, handle, ticker or address
GET /v1/coins/hotget_hot_coinsCoins tracked traders are buying now
GET /v1/coins/indexget_hot_indexCoins ranked 0 to 100 by attention
GET /v1/coins/flowget_money_flowCoins ranked by dollars bought or sold
GET /v1/coins/dex-paidget_dex_paidCoins whose team paid for a dexscreener profile in the last 24 h
GET /v1/coins/{chain}/{address}get_tokenOne coin: price, market cap, which tracked traders hold it
GET /v1/tradesget_live_tradesLatest buys and sells by tracked traders
GET /v1/alertsget_alertsEvents since a cursor: several top traders on one coin, big trades, theses
GET /v1/thesesget_thesesTheses posted by tracked traders
GET /v1/hyperliquid/tradershl_get_tradersHyperliquid traders ranked by pnl or roi
GET /v1/hyperliquid/traders/{address}hl_get_traderOne Hyperliquid trader: metrics, positions, fills
GET /v1/hyperliquid/marketshl_get_marketsLive Hyperliquid markets
GET /v1/hyperliquid/markets/{coin}hl_get_market_readOne Hyperliquid market read
GET /v1/hyperliquid/markets/{coin}/callshl_get_callsAnalyst calls on one Hyperliquid market

the full description is an OpenAPI file: https://copy.top/v1/openapi.json. import it in Postman, a GPT action or any API catalog.

answers without a key can be cached for up to 30 seconds. with a key, send it as Authorization: Bearer YOUR_KEY (or x-api-key).

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