what GMGN's API covers
according to GMGN's own documentation (its gmgn-skills repository, read on November 22, 2026), the CLI reads a token's top traders and holders, a wallet's stats, profits, holdings and activity, and tracks KOL and smart money wallets.
it needs an API key created on gmgn.ai, and each tier has its own rate limit. we found no official GMGN MCP server.
top traders ranked by realized pnl
the pnl leaderboard of fomo and pumpfun traders, over 1, 7 or 30 days, as JSON. no key.
curl -s 'https://copy.top/v1/traders?platform=pumpfun&window=30d&sort=realized&limit=10'
- each row: handle, name, pnl, realized, unrealized, roi, win rate, closed positions, copiers, median hold time and a link to the trader's page.
- GET /v1/traders/{handle} returns one trader: pnl over 30 days, win rate, open positions and recent trades.
smart money: what top traders are buying now
curl -s 'https://copy.top/v1/coins/hot?window=1h'
- each coin: how many tracked traders and top traders bought it, how many still hold, dollars bought and sold, and the buyers.
alerts when several top traders buy the same coin
curl -s 'https://copy.top/v1/alerts?min_top_traders=3'
- events: confluence (several top traders on one coin), big trades and new theses. keep the cursor and pass it back as since a minute later.
pricing
copy.top's api is free. without a key: about 20 calls a minute per address. a free key from copy.top/account#api raises the limits. there is no paid plan.
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. 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
does GMGN have an API?
yes. GMGN offers a key-based API through its official CLI, gmgn-cli, with free, Plus and Pro tiers. the key is created on gmgn.ai, and access may be gated.
is there a free alternative to the GMGN API for wallet and trader data?
yes: copy.top's api returns top traders ranked by realized pnl, their positions and live trades, and alerts when several top traders buy the same coin. it is free and open without a key.
does copy.top cover the same wallets as GMGN?
no. copy.top covers ranked traders with a public profile on the fomo app and on pumpfun, plus Hyperliquid traders by address.
is there a GMGN MCP server?
we found no official one. copy.top is an MCP server: add https://copy.top/mcp to Claude, Cursor or any MCP client.
is copy.top affiliated with GMGN?
no. copy.top is independent and not affiliated with GMGN.
copy.top