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

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](https://copy.top/docs/tools/get-leaderboard.md) | Trader leaderboard (fomo and pumpfun) |
| GET /v1/traders/{handle} | [get_trader](https://copy.top/docs/tools/get-trader.md) | One trader: pnl, win rate, positions, trades |
| GET /v1/search | [search](https://copy.top/docs/tools/search.md) | Find traders and coins by name, handle, ticker or address |
| GET /v1/coins/hot | [get_hot_coins](https://copy.top/docs/tools/get-hot-coins.md) | Coins tracked traders are buying now |
| GET /v1/coins/index | [get_hot_index](https://copy.top/docs/tools/get-hot-index.md) | Coins ranked 0 to 100 by attention |
| GET /v1/coins/flow | [get_money_flow](https://copy.top/docs/tools/get-money-flow.md) | Coins ranked by dollars bought or sold |
| GET /v1/coins/dex-paid | [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 |
| GET /v1/coins/{chain}/{address} | [get_token](https://copy.top/docs/tools/get-token.md) | One coin: price, market cap, which tracked traders hold it |
| GET /v1/trades | [get_live_trades](https://copy.top/docs/tools/get-live-trades.md) | Latest buys and sells by tracked traders |
| GET /v1/alerts | [get_alerts](https://copy.top/docs/tools/get-alerts.md) | Events since a cursor: several top traders on one coin, big trades, theses |
| GET /v1/theses | [get_theses](https://copy.top/docs/tools/get-theses.md) | Theses posted by tracked traders |
| GET /v1/hyperliquid/traders | [hl_get_traders](https://copy.top/docs/tools/hl-get-traders.md) | Hyperliquid traders ranked by pnl or roi |
| GET /v1/hyperliquid/traders/{address} | [hl_get_trader](https://copy.top/docs/tools/hl-get-trader.md) | One Hyperliquid trader: metrics, positions, fills |
| GET /v1/hyperliquid/markets | [hl_get_markets](https://copy.top/docs/tools/hl-get-markets.md) | Live Hyperliquid markets |
| GET /v1/hyperliquid/markets/{coin} | [hl_get_market_read](https://copy.top/docs/tools/hl-get-market-read.md) | One Hyperliquid market read |
| GET /v1/hyperliquid/markets/{coin}/calls | [hl_get_calls](https://copy.top/docs/tools/hl-get-calls.md) | 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).

---
html: https://copy.top/docs/rest-api · 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.
