copy.top open the terminal
copy.top / developers / gmgn api

gmgn api: GMGN's own API, and a free alternative for trader data

GMGN offers an official API through its command line tool, gmgn-cli, with an API key and free, Plus and Pro tiers; access to the key may be gated. this page sums up what that API covers, then shows a free, read-only alternative for trader data that needs no key: copy.top's api, which is also an MCP server for AI agents. copy.top is independent and not affiliated with GMGN.

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.

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.

copy the top.

see who wins, what they buy, and copy them from your own wallet.

find a trader