gmgn-market Skill for Claude Code: Meme Token Charts

Lets your agent pull token price charts, trending and newly launched meme coins, signals, hot searches and token or wallet lookups through the GMGN API.

Installs: 18.6K; on skills.sh
Stars: 636; on GitHub
Updated: Oct 2026; last repo commit

The skill makes your agent call the gmgn-cli market commands. They return candlestick charts, trending token rankings, newly launched launchpad tokens, a real-time signal feed, the most-searched tokens, and name or address lookups for tokens and wallets. It covers ten chains for most commands, including Solana, BSC, Base and Ethereum.

You need a free or paid GMGN API key and the gmgn-cli tool. SKILL.md tells the agent to use that CLI and not web search or the gmgn.ai site. Rate limits depend on your plan (Free 5/5, Plus 20/20, Pro 50/50), and one-second candles are Pro only. SKILL.md says all its commands use API-key auth only, with no signature. Trading lives in the separate gmgn-swap and gmgn-cooking skills, per the README. Its filter criteria and lifecycle guide use entry-signal wording (pass, watch, skip, strong buy signal); read that as the skill's own heuristics, not advice.

Good for

Meme coin traders who want a live ranking of what is trending on Solana, BSC, Base or Ethereum
Researchers scanning launchpads such as pump.fun for new tokens
Anyone who wants candlestick (OHLCV) data for a token in the chat

Install gmgn-market

Claude Code

Copy this prompt.

Install the gmgn-market skill in Claude Code. Run this command:

npm install -g gmgn-cli
npx skills add GMGNAI/gmgn-skills --skill gmgn-market -a claude-code

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The skill only works with the gmgn-cli program installed and an API key set, so run the npm line first. The README's own command, npx skills add GMGNAI/gmgn-skills, installs every skill in the repo, including the swap and order skills; the --skill flag limits it to this one. Update the CLI with npm install -g gmgn-cli.

From the vendor's docs. Source.

What's in the skill

When it loads

Get crypto and meme token price charts (K-line, candlestick, OHLCV), trending meme coin rankings by volume, newly launched tokens on launchpads (pump.fun, fourmeme, letsbonk, Raydium, etc.), the hot-search ranking (most-searched tokens), and search for a specific token or wallet by name, symbol, contract address, wallet address, or ENS via GMGN API on Solana, BSC, Base, or Ethereum. Use when user asks for price chart, trending tokens, what's pumping, hot coins, most searched tokens, new launches, token signals, wants to look up / find / search a specific token or wallet by name or address, or wants to discover early-stage opportunities.

Sections in SKILL.md

Core Concepts
Sub-commands
Supported Chains
Prerequisites
Rate Limit Handling
market kline Parameters
market kline Response Fields
market trending Options
market trending Range Filters
Usage Examples
Kline
Trending — General
Trending — SOL by Launchpad Platform
Trending — BSC by Launchpad Platform
Trending — ETH by Launchpad Platform
Trending — Numeric Range Filters

Key facts

Author: gmgnai
Repo: gmgnai/gmgn-skills, folder skills/gmgn-market
Installs on skills.sh: 18,596 as of 2026-11-02
GitHub stars: 636 for the whole gmgnai/gmgn-skills repo
License: MIT (as detected by GitHub)
Last repo commit: 2026-10-29
What is inside: 1 file including SKILL.md
skills.sh audits: Gen Agent Trust Hub: pass; Socket: pass; Snyk: fail
Needs: gmgn-cli (npm, global) and GMGN_API_KEY in ~/.config/gmgn/.env

What it includes

Candlestick (OHLCV) data for one token
Returns candles for a token address over a time range, from 1-second (Pro only) up to 1-day resolution. Output is oldest first.
Try: “Show hourly candles for this Solana token for the last 24 hours.”
Network · market kline
Trending tokens ranked by swap activity
Ranks tokens for a chosen window from 1 minute to 24 hours. You can filter by launchpad, safety flags, liquidity, market cap and smart-money count.
Try: “What is trending on Solana in the last hour, sorted by volume?”
Network · market trending
New launchpad tokens in three stages
Lists tokens just created, near completion of the bonding curve, or already graduated to open markets. It has safe and strict filter presets.
Network · market trenches
Real-time token signal feed
A feed of price spikes, smart money buys, large buys, CTO events and similar triggers, newest first, up to 50 results per group.
Network · market signal
Most-searched tokens
Ranks tokens by search heat across one or several chains, with the same metric filters as trending.
Network · market hot-searches
Look up a token or wallet by name or address
Finds tokens and wallets by name, symbol, contract address, wallet address or ENS. Leave the chain out to search all of them.
Try: “Search for PEPE on Ethereum.”
Network · market search
Pass, watch or skip criteria
Written guidance on screening a token and on its four lifecycle stages: early, breakout, distribution and decline. It includes entry-signal wording such as a strong buy signal combination; these are the skill author's rules of thumb.
Read · Token quality filter and lifecycle guide

From the official docs

Permissions

Medium risk

It sends your queries to the GMGN API with your API key, and its setup flow can have the agent handle that key in chat. Put the key in ~/.config/gmgn/.env yourself and keep it out of the conversation.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Your API key can end up in the chat
If no key is set, SKILL.md has the agent ask you to send the key in the conversation and then apply it with a gmgn-cli command. Create ~/.config/gmgn/.env yourself instead, as the README describes.
Repeated requests can get you banned for minutes
After a rate-limit hit, more requests during the cooldown extend the ban by 5 seconds each, up to 5 minutes. Let the agent wait for the reset time.
IPv6 networks fail with 401 or 403
The CLI only works over IPv4. If a correct key gives 401 or 403, turn IPv6 off on your network interface.
Trading is a separate skill with its own key setting
The README lists swaps and orders under gmgn-swap and gmgn-cooking, and says swapping needs GMGN_PRIVATE_KEY, appended to the same .env file, plus an IP-whitelisted key. Install only the skills you need.

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No switch is needed for this skill: its six market commands are queries, and SKILL.md says they use the API key alone with no signature. Placing orders is done by other skills (gmgn-swap, gmgn-cooking) that the README says need GMGN_PRIVATE_KEY and an IP-whitelisted key.
Talks to	The GMGN API receives the tokens, wallets and filters you ask about. npm download if gmgn-cli is missing or needs an update
Sign-in and keys	The API key lives in ~/.config/gmgn/.env, or in a project .env file that takes precedence.
Scopes	Runs gmgn-cli commands in your terminal Reads the GMGN API key from ~/.config/gmgn/.env Rate limits apply per API key plan

Questions

What does gmgn-market do?

It makes your agent fetch meme and crypto token market data through the GMGN API. That includes candlestick charts, trending rankings, new launches, signals, hot searches and token or wallet lookups.

How do I install it?

Use the install box at the top of this page for the skill itself. The skill also needs the gmgn-cli command-line tool (npm install -g gmgn-cli) and a GMGN API key, which the README says you create at gmgn.ai/ai. The README's own npx skills add command installs the whole GMGN set, not only this skill.

Does it need an API key?

Yes. It needs a GMGN API key kept in ~/.config/gmgn/.env. For this skill the key only runs read queries: SKILL.md says its commands use the API key alone, with no signature. The README says swapping needs the extra GMGN_PRIVATE_KEY setting and an IP-whitelisted key, which this skill does not use. The README also gives a shared public test key for trying read-only commands, and says to apply for your own at gmgn.ai/ai for real use.

Which chains does it cover?

Solana, BSC, Base and Ethereum are named in the description. SKILL.md lists ten chains for kline, trending and trenches, and signals skip hyperevm.

Is it safe to use?

Its commands query market data and none of them is a trade command, but it uses an API key and sends your queries to GMGN. Keep the key in the config file, not in chat. SKILL.md also scores tokens with words like "strong buy signal" and "act on confirmation"; treat those as rules of thumb from the skill author, not advice, and check any token yourself before putting money in.

How is it different from gmgn-token and gmgn-portfolio?

gmgn-market browses rankings and charts. The sibling gmgn-token researches one token, and gmgn-portfolio looks at wallets. The README lists all three, and the market skill points to gmgn-token for due diligence on a token you find.

What do the free and paid plans change?

Speed limits. SKILL.md gives Free 5/5, Plus 20/20 and Pro 50/50 as rate and capacity. The one-second candle resolution is Pro only.

Information

updated Nov 2, 2026

Repository: gmgnai/gmgn-skills
Folder: skills/gmgn-market

gmgnai/gmgn-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

gmgnai/gmgn-skills README · github.com
skills CLI commands · github.com
gmgn-market SKILL.md · github.com
gmgnai/gmgn-skills · github.com
gmgn-market on skills.sh · skills.sh
gmgn-skills .env.example · github.com