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.
| route | tool | what it returns |
|---|---|---|
| GET /v1/traders | get_leaderboard | Trader leaderboard (fomo and pumpfun) |
| GET /v1/traders/{handle} | get_trader | One trader: pnl, win rate, positions, trades |
| GET /v1/search | search | Find traders and coins by name, handle, ticker or address |
| GET /v1/coins/hot | get_hot_coins | Coins tracked traders are buying now |
| GET /v1/coins/index | get_hot_index | Coins ranked 0 to 100 by attention |
| GET /v1/coins/flow | get_money_flow | Coins ranked by dollars bought or sold |
| GET /v1/coins/dex-paid | get_dex_paid | Coins whose team paid for a dexscreener profile in the last 24 h |
| GET /v1/coins/{chain}/{address} | get_token | One coin: price, market cap, which tracked traders hold it |
| GET /v1/trades | get_live_trades | Latest buys and sells by tracked traders |
| GET /v1/alerts | get_alerts | Events since a cursor: several top traders on one coin, big trades, theses |
| GET /v1/theses | get_theses | Theses posted by tracked traders |
| GET /v1/hyperliquid/traders | hl_get_traders | Hyperliquid traders ranked by pnl or roi |
| GET /v1/hyperliquid/traders/{address} | hl_get_trader | One Hyperliquid trader: metrics, positions, fills |
| GET /v1/hyperliquid/markets | hl_get_markets | Live Hyperliquid markets |
| GET /v1/hyperliquid/markets/{coin} | hl_get_market_read | One Hyperliquid market read |
| GET /v1/hyperliquid/markets/{coin}/calls | hl_get_calls | Analyst 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).
copy.top