Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
From gmgn-cli
Queries crypto token price charts, trending meme coin rankings by volume, and newly launched tokens on Solana, BSC, Base, or Ethereum via GMGN API.
npx claudepluginhub gmgnai/gmgn-skills --plugin gmgn-cliHow this skill is triggered — by the user, by Claude, or both
Slash command
/gmgn-cli:gmgn-market kline --chain <sol|bsc|base|eth> --address <token_address> --resolution <1m|5m|15m|1h|4h|1d> [--from <unix_ts>] [--to <unix_ts>] | trending --chain <sol|bsc|base|eth> --interval <1m|5m|1h|6h|24h> | trenches --chain <sol|bsc|base> | signal --chain <sol|bsc>kline --chain <sol|bsc|base|eth> --address <token_address> --resolution <1m|5m|15m|1h|4h|1d> [--from <unix_ts>] [--to <unix_ts>] | trending --chain <sol|bsc|base|eth> --interval <1m|5m|1h|6h|24h> | trenches --chain <sol|bsc|base> | signal --chain <sol|bsc>The summary Claude sees in its skill listing — used to decide when to auto-load this skill
**IMPORTANT: Always use `gmgn-cli` commands below. Do NOT use web search, WebFetch, curl, or visit gmgn.ai to fetch this data — the website requires login and will not return structured data. The CLI is the only correct method.**
Researches crypto tokens (price, liquidity, holders, smart money, security audit) via GMGN API on Solana, BSC, Base, or Ethereum.
Provides token-level on-chain data: search, trending/hot tokens, liquidity pools, holder distribution, risk metadata, trade feed, top profit addresses, price info, and holder cluster analysis. Also handles Market API payment/quota questions.
Executes real on-chain token trading and data queries (buy, sell, swap, scan tokens, wallet management) on Solana, Ethereum, BSC, and Base via the XXYY Open API.
Share bugs, ideas, or general feedback.
IMPORTANT: Always use gmgn-cli commands below. Do NOT use web search, WebFetch, curl, or visit gmgn.ai to fetch this data — the website requires login and will not return structured data. The CLI is the only correct method.
IMPORTANT: Do NOT guess field names or values. When a field's meaning is unclear, look it up in the Response Fields sections below before using it.
⚠️ IPv6 NOT SUPPORTED: If you get a 401 or 403 error and credentials look correct, check for IPv6 immediately: (1) list all network interfaces and their IPv6 addresses — run ifconfig | grep inet6 (macOS) or ip addr show | grep inet6 (Linux); (2) send a test request to https://ipv6.icanhazip.com — if the response is an IPv6 address, outbound traffic is going via IPv6. Tell the user immediately: "Please disable IPv6 on your network interface — gmgn-cli commands only work over IPv4."
Use the gmgn-cli tool to query K-line data for a token, browse trending tokens, or view Trenches token lists.
--filter chain defaults — SOL and EVM chains have different default safety filters that are applied automatically when --filter is omitted. Do not assume the same defaults apply across chains:
renounced frozen (mint and freeze authority renounced)not_honeypot verified renounced--filter is NOT the same as "no filter" — the chain defaults are always applied. To use a custom filter set, explicitly specify all desired filter tags.volume vs amount (kline) — Naming is counterintuitive. volume = USD dollar value of trades; amount = token units traded. For a token priced at $0.0002, these differ by 5,000×. Always use volume for "how much USD was traded" and amount for "how many tokens changed hands."
rug_ratio — A 0–1 score estimating rug pull likelihood. Values above 0.3 are high-risk. Do not treat as binary — combine with top_10_holder_rate, dev_team_hold_rate, and is_honeypot for a full picture.
smart_degen_count / renowned_count — Number of platform-tagged smart money wallets (smart_degen) and KOL wallets (renowned) holding or trading this token. High values are bullish signals. These are GMGN-tagged wallet lists, not user-defined.
hot_level — Trending intensity score. Higher = more actively traded right now. Not normalized — compare relative values within the same result set, not across time windows.
renounced_mint / renounced_freeze_account — SOL-specific. Indicate whether the creator gave up the ability to mint more tokens or freeze wallets. Both being 1 is a safety baseline on Solana. Always false on EVM chains (concept does not apply).
is_honeypot — EVM-specific (BSC / Base). Indicates whether the token contract prevents selling. Always empty/null on SOL — do not interpret an empty value as "not a honeypot" on Solana.
creator_token_status — Dev holding status. creator_hold = dev still holds tokens (sell pressure risk). creator_close = dev has sold or burned their allocation (exit signal confirmed).
cto_flag — Community Takeover flag. 1 = original dev abandoned the project and a community group took over marketing/development. Neutral to positive signal; evaluate in context.
Trenches categories — Three lifecycle stages of launchpad tokens: new_creation (just created, still on bonding curve), near_completion (bonding curve nearly full, about to graduate), completed (graduated to open market / DEX). In the response, near_completion is always returned under the key data.pump regardless of the input --type.
wash_trading / rat_trader_amount_rate / bundler_rate — Risk signals for artificial activity. is_wash_trading = coordinated fake volume detected. rat_trader_amount_rate = ratio of insider/sneak trading. bundler_rate = ratio of bot-bundled buys at launch. High values (> 0.3) suggest manipulated price action.
| Sub-command | Description |
|---|---|
market kline | Token candlestick / OHLCV data and trading volume over a time range |
market trending | Trending tokens ranked by swap activity — use --interval to specify the time window (e.g. 1m for 1-minute hottest, 1h for 1-hour trending) |
market trenches | Newly launched launchpad platform tokens — use this when the user asks for "new tokens", "just launched tokens", "latest tokens on pump.fun/letsbonk". Three categories: new_creation (just created), near_completion (bonding curve almost full), completed (graduated to open market / DEX) |
market signal | Real-time token signal feed — price spikes, smart money buys, large buys, Dex ads, CTO events, and more. Results sorted by trigger_at descending. sol / bsc only. Max 50 results per group. |
sol / bsc / base / eth (kline / trending only; trenches: sol / bsc / base; signal: sol / bsc only)
gmgn-cli installed globally — if missing, run: npm install -g gmgn-cliGMGN_API_KEY configured in ~/.config/gmgn/.envAll market routes used by this skill go through GMGN's leaky-bucket limiter with rate=20 and capacity=20. Sustained throughput is roughly 20 ÷ weight requests/second, and the max burst is roughly floor(20 ÷ weight) when the bucket is full.
| Command | Route | Weight |
|---|---|---|
market kline | GET /v1/market/token_kline | 2 |
market trending | GET /v1/market/rank | 1 |
market trenches | POST /v1/trenches | 3 |
market signal | POST /v1/market/token_signal | 3 |
When a request returns 429:
X-RateLimit-Reset from the response headers. It is a Unix timestamp in seconds that marks when the limit is expected to reset.reset_at (e.g., {"code":429,"error":"RATE_LIMIT_BANNED","message":"...","reset_at":1775184222}), extract reset_at — it is the Unix timestamp when the ban lifts (typically 5 minutes). Convert to local time and tell the user exactly when they can retry.RATE_LIMIT_EXCEEDED or RATE_LIMIT_BANNED, repeated requests during the cooldown can extend the ban by 5 seconds each time, up to 5 minutes. Do not spam retries.First-time setup (if GMGN_API_KEY is not configured):
Generate key pair and show the public key to the user:
openssl genpkey -algorithm ed25519 -out /tmp/gmgn_private.pem 2>/dev/null && \
openssl pkey -in /tmp/gmgn_private.pem -pubout 2>/dev/null
Tell the user: "This is your Ed25519 public key. Go to https://gmgn.ai/ai, paste it into the API key creation form, then send me the API Key value shown on the page."
Wait for the user's API key, then configure:
mkdir -p ~/.config/gmgn
echo 'GMGN_API_KEY=<key_from_user>' > ~/.config/gmgn/.env
chmod 600 ~/.config/gmgn/.env
market kline Parameters| Parameter | Required | Description |
|---|---|---|
--chain | Yes | sol / bsc / base / eth |
--address | Yes | Token contract address |
--resolution | Yes | Candlestick resolution: 1m / 5m / 15m / 1h / 4h / 1d |
--from | No | Start time (Unix seconds) |
--to | No | End time (Unix seconds) |
market kline Response FieldsThe response is an object with a list array. Each element in list is one candlestick:
| Field | Type | Description |
|---|---|---|
time | number | Candle open time — Unix timestamp in milliseconds (divide by 1000 for seconds) |
open | string | Opening price in USD at the start of the period |
close | string | Closing price in USD at the end of the period |
high | string | Highest price in USD during the period |
low | string | Lowest price in USD during the period |
volume | string | Trading volume in USD (dollar value of all trades in this period) |
amount | string | Trading volume in base token units (number of tokens traded) |
Important distinctions (naming is counterintuitive — do not guess):
volume = USD dollar value (e.g. 1214 means ~$1,214 traded) — use this for "how much was traded in USD"amount = token count (e.g. 5379110 means ~5.38M tokens changed hands) — use this for "how many tokens were traded"volume and amount will differ by orders of magnitude (e.g. a $0.0002 token: $1,214 volume = 5,379,110 tokens)volume across all candles in the rangeclose values in chronological order (time ascending)high vs low within each candlemarket trending Options--interval selection guide — always match to the user's stated time window:
| User says | --interval |
|---|---|
| "1m trending" / "hottest right now" | 1m |
| "5m" / "5 minute" | 5m |
| "1h" / "1 hour" / no time specified (default) | 1h |
| "6h" / "6 hour" | 6h |
| "24h" / "today" / "daily" | 24h |
| Option | Description |
|---|---|
--chain | Required. sol / bsc / base / eth |
--interval | Required. 1m / 5m / 1h / 6h / 24h (default 1h) |
--limit <n> | Number of results (default 100, max 100) |
--order-by <field> | Sort field: default / swaps / marketcap / history_highest_market_cap / liquidity / volume / holder_count / smart_degen_count / renowned_count / gas_fee / price / change1m / change5m / change1h / creation_timestamp |
--direction <asc|desc> | Sort direction (default desc) |
--filter <tag...> | Repeatable filter tags (chain-specific). ⚠️ SOL defaults: renounced frozen; BSC/Base/ETH defaults: not_honeypot verified renounced. Omitting --filter is NOT "no filter" — chain defaults always apply. sol tags: renounced / frozen / burn / token_burnt / has_social / not_social_dup / not_image_dup / dexscr_update_link / not_wash_trading / is_internal_market / is_out_market. evm tags: not_honeypot / verified / renounced / locked / token_burnt / has_social / not_social_dup / not_image_dup / dexscr_update_link / is_internal_market / is_out_market |
--platform <name...> | Repeatable platform filter (chain-specific). sol: Pump.fun / pump_mayhem / pump_mayhem_agent / pump_agent / letsbonk / bonkers / bags / memoo / liquid / bankr / zora / surge / anoncoin / moonshot_app / wendotdev / heaven / sugar / token_mill / believe / trendsfun / trends_fun / jup_studio / Moonshot / boop / xstocks / ray_launchpad / meteora_virtual_curve / pool_ray / pool_meteora / pool_pump_amm / pool_orca. bsc: fourmeme / fourmeme_agent / bn_fourmeme / flap / clanker / lunafun / pool_uniswap / pool_pancake. base: clanker / bankr / flaunch / zora / zora_creator / baseapp / basememe / virtuals_v2 / klik. eth: no platform filter (omit --platform for ETH) |
# Last 1 hour of 1-minute candles
# macOS:
gmgn-cli market kline \
--chain sol \
--address <token_address> \
--resolution 1m \
--from $(date -v-1H +%s) \
--to $(date +%s)
# Linux: use $(date -d '1 hour ago' +%s) instead of $(date -v-1H +%s)
# Last 24 hours of 1-hour candles
# macOS:
gmgn-cli market kline \
--chain sol \
--address <token_address> \
--resolution 1h \
--from $(date -v-24H +%s) \
--to $(date +%s)
# Linux: use $(date -d '24 hours ago' +%s) instead of $(date -v-24H +%s)
# Raw output for further processing
gmgn-cli market kline --chain sol --address <addr> \
--resolution 5m --from <ts> --to <ts> --raw | jq '.[]'
# ETH token kline — last 24h, 1h candles (macOS)
gmgn-cli market kline \
--chain eth \
--address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 \
--resolution 1h \
--from $(date -v-24H +%s) \
--to $(date +%s)
# Top 20 hot tokens on SOL in the last 1 hour, sorted by volume
gmgn-cli market trending --chain sol --interval 1h --order-by volume --limit 20
# Top 50 tokens on SOL, 5m window, sorted by volume
gmgn-cli market trending --chain sol --interval 5m --order-by volume --limit 50
# Hot tokens with social links only, verified and not honeypot, on BSC over 24h
gmgn-cli market trending \
--chain bsc --interval 24h \
--filter has_social --filter not_honeypot --filter verified
Use --platform to filter trending results to tokens from specific launchpads only.
# SOL 1m hottest — Pump.fun + letsbonk only (most active launchpads), sorted by volume
gmgn-cli market trending \
--chain sol --interval 1m \
--platform Pump.fun --platform letsbonk \
--order-by volume --limit 50 --raw
# SOL 5m hottest — Pump.fun + letsbonk + Moonshot, sorted by volume
gmgn-cli market trending \
--chain sol --interval 5m \
--platform Pump.fun --platform letsbonk --platform moonshot_app \
--order-by volume --limit 50 --raw
# SOL 1h trending — Pump.fun only, with safety filters
gmgn-cli market trending \
--chain sol --interval 1h \
--platform Pump.fun \
--filter renounced --filter frozen --filter not_wash_trading \
--order-by volume --limit 20 --raw
# SOL 1h trending — all major launchpads combined
gmgn-cli market trending \
--chain sol --interval 1h \
--platform Pump.fun --platform letsbonk --platform moonshot_app \
--platform pump_mayhem --platform pump_mayhem_agent --platform bonkers \
--order-by volume --limit 50 --raw
# BSC 1m hottest — fourmeme (main BSC launchpad), sorted by volume
gmgn-cli market trending \
--chain bsc --interval 1m \
--platform fourmeme --platform four_xmode_agent \
--order-by volume --limit 50 --raw
# BSC 5m hottest — fourmeme family, sorted by volume
gmgn-cli market trending \
--chain bsc --interval 5m \
--platform fourmeme --platform fourmeme_agent --platform bn_fourmeme --platform four_xmode_agent \
--order-by volume --limit 50 --raw
# BSC 1h trending — fourmeme with safety filters
gmgn-cli market trending \
--chain bsc --interval 1h \
--platform fourmeme --platform fourmeme_agent --platform bn_fourmeme --platform four_xmode_agent \
--filter not_honeypot --filter verified \
--order-by volume --limit 20 --raw
# ETH 1h trending — all tokens, sorted by volume
gmgn-cli market trending --chain eth --interval 1h --order-by volume --limit 20
# ETH 1h trending — with safety filters
gmgn-cli market trending \
--chain eth --interval 1h \
--filter not_honeypot --filter verified \
--order-by volume --limit 20 --raw
# ETH 24h trending — sorted by smart money count
gmgn-cli market trending \
--chain eth --interval 24h \
--filter not_honeypot --filter verified \
--order-by smart_degen_count --limit 20 --raw
# Base 1m hottest — clanker + zora (main Base launchpads), sorted by volume
gmgn-cli market trending \
--chain base --interval 1m \
--platform clanker --platform zora --platform zora_creator \
--order-by volume --limit 50 --raw
# Base 5m hottest — clanker + zora + virtuals_v2 + flaunch, sorted by volume
gmgn-cli market trending \
--chain base --interval 5m \
--platform clanker --platform zora --platform zora_creator \
--platform virtuals_v2 --platform flaunch \
--order-by volume --limit 50 --raw
# Base 1h trending — all major launchpads with safety filters
gmgn-cli market trending \
--chain base --interval 1h \
--platform clanker --platform zora --platform zora_creator \
--platform virtuals_v2 --platform flaunch --platform baseapp \
--filter not_honeypot --filter verified \
--order-by volume --limit 20 --raw
market trending Response FieldsThe response is data.rank — an array of rank items. Each item represents one token.
Basic Info
| Field | Description |
|---|---|
address | Token contract address |
symbol / name | Token ticker and full name |
logo | Token logo image URL |
chain | Chain identifier |
total_supply | Total token supply |
creator | Creator wallet address |
launchpad_platform | Launch/pool platform (e.g. Pump.fun, letsbonk, pool_meteora, fourmeme) |
exchange | Current DEX (e.g. meteora_damm_v2, raydium, pump_amm) |
open_timestamp | Open market listing time (Unix seconds) |
creation_timestamp | Token creation time (Unix seconds) |
rank | Position in this trending list (lower = hotter) |
hot_level | Trending intensity level (higher = hotter) |
Price & Market
| Field | Description |
|---|---|
price | Current price in USD |
market_cap | Market cap in USD (directly available — no calculation needed) |
liquidity | Current liquidity in USD |
volume | Trading volume in USD for the queried interval |
history_highest_market_cap | All-time highest market cap in USD |
initial_liquidity | Initial liquidity at token launch |
price_change_percent | Price change % for the queried interval |
price_change_percent1m | Price change % in last 1 minute |
price_change_percent5m | Price change % in last 5 minutes |
price_change_percent1h | Price change % in last 1 hour |
Trading Activity
| Field | Description |
|---|---|
swaps | Total swap count in the queried interval |
buys / sells | Buy / sell count in the interval |
holder_count | Number of unique token holders |
gas_fee | Average gas fee per transaction |
Security & Risk
| Field | Chains | Description |
|---|---|---|
renounced_mint | SOL | Mint authority renounced (1 = yes, 0 = no) |
renounced_freeze_account | SOL | Freeze authority renounced (1 = yes, 0 = no) |
is_honeypot | BSC / Base | Honeypot flag (1 = yes, 0 = no) |
is_open_source | all | Contract verified (1 = yes, 0 = no) |
is_renounced | all | Ownership renounced (1 = yes, 0 = no) |
buy_tax / sell_tax | all | Tax rate — empty string means 0 (no tax) |
burn_status | all | Liquidity burn status (e.g. "none", "burn") |
top_10_holder_rate | all | Top 10 wallets concentration (0–1) |
rug_ratio | all | Rug pull risk score (0–1) |
is_wash_trading | all | Wash trading detected (true / false) |
rat_trader_amount_rate | all | Ratio of insider/sneak trading volume |
bundler_rate | all | Ratio of bundle bot trading volume |
entrapment_ratio | all | Entrapment trading ratio |
sniper_count | all | Number of sniper wallets at launch |
bot_degen_count / bot_degen_rate | all | Bot degen wallet count / ratio |
dev_team_hold_rate | all | Dev team holding ratio |
top70_sniper_hold_rate | all | Top 70 sniper current holding ratio |
lock_percent | all | Liquidity lock percentage |
Dev Status
| Field | Description |
|---|---|
creator_token_status | Dev holding status: creator_hold (still holding) / creator_close (sold/closed) |
creator_close | Boolean shorthand for creator_token_status == creator_close |
dev_token_burn_ratio | Ratio of dev's tokens that have been burned |
Smart Money
| Field | Description |
|---|---|
smart_degen_count | Number of smart money wallets holding the token |
renowned_count | Number of renowned / KOL wallets holding the token |
bluechip_owner_percentage | Ratio of holders that are bluechip wallets (0–1) |
Social
| Field | Description |
|---|---|
twitter_username | Twitter / X username (not a full URL — prepend https://x.com/ to get the link) |
website | Project website URL |
telegram | Telegram URL |
cto_flag | Community takeover flag (1 = CTO has occurred) |
Dexscreener Marketing
| Field | Description |
|---|---|
dexscr_ad | Dexscreener ad placed (1 = yes) |
dexscr_update_link | Social links updated on Dexscreener (1 = yes) |
dexscr_trending_bar | Paid for Dexscreener trending bar (1 = yes) |
dexscr_boost_fee | Dexscreener boost amount paid (0 = none) |
Full workflow for discovering market opportunities: docs/workflow-market-opportunities.md
Steps: fetch trending (50 results, safe filters) → AI multi-factor analysis (smart money, volume, momentum, liquidity, maturity) → present top 5 table with rationale → offer deep dive or swap.
When results contain interesting tokens, proceed to full token due diligence: docs/workflow-token-research.md
For new / launchpad tokens (market trenches): apply the structured early project screening workflow that includes security check and smart money entry detection — docs/workflow-early-project-screening.md
For a daily market overview (user asks "what's the market like today", "give me a daily brief", "what is smart money buying today"): combine market trending + market trenches with gmgn-track smartmoney — docs/workflow-daily-brief.md
When evaluating tokens returned from market trending or market trenches, apply these criteria to quickly separate high-quality opportunities from noise. Do not present raw results without filtering.
| Signal | 🟢 Pass | 🟡 Watch | 🔴 Skip |
|---|---|---|---|
smart_degen_count | ≥ 3 | 1–2 | 0 |
rug_ratio | < 0.1 | 0.1–0.3 | > 0.3 |
creator_token_status | creator_close | — | creator_hold |
is_wash_trading | false | — | true → skip immediately |
top_10_holder_rate | < 0.20 | 0.20–0.50 | > 0.50 |
liquidity | > $50k | $10k–$50k | < $10k |
has_social (or any social field present) | yes | — | no (weak signal only) |
Quick disqualification rule: If rug_ratio > 0.3 OR is_wash_trading = true OR is_honeypot = 1 → skip immediately, no further analysis needed.
Strong buy signal combination: smart_degen_count ≥ 3 + rug_ratio < 0.2 + creator_close + is_wash_trading = false + liquidity > $50k → high-quality opportunity, proceed to full token research.
For full due diligence on any token surfaced here: docs/workflow-token-research.md
Use field combinations to determine what stage a token is in. This affects how signals should be interpreted.
Indicators:
creation_timestamp < 1 hour agohot_level low or just starting to risesmart_degen_count = 0, renowned_count = 0Interpretation: Too early for smart money signals. No on-chain track record. High risk, high potential reward. Wait for Stage 2 confirmation before acting. Only the most risk-tolerant traders enter here.
Indicators:
smart_degen_count ≥ 3 AND risingswaps_1h vs swaps_24h / 24 — significantly higher)price_change_percent1h > 20%creator_token_status = creator_hold is OK at this stage (dev hasn't distributed yet)Interpretation: Strongest entry signal. Smart money is accumulating. Verify security before acting. This window is often short — act on confirmation, not anticipation.
Indicators:
creator_token_status = creator_close (dev has sold their allocation)renowned_count buying (late social signal — KOLs often enter after smart money)smart_degen_count plateauing or decliningInterpretation: Late stage entry. Smart money may be exiting into retail/KOL demand. Higher risk for new entries. If already holding from Stage 2, evaluate exit levels.
Indicators:
holder_count decliningrat_trader_amount_rate high (insider/sneak trading dominating)smart_degen_count = 0 or clearly decliningInterpretation: Avoid new entries entirely. If still holding, consider exiting. The opportunity has likely passed.
market trenches ParametersIntent → --type mapping (always specify --type explicitly):
| User intent | --type value |
|---|---|
| "new tokens", "just launched", "newly created", "latest tokens" | new_creation |
| "about to graduate", "near completion", "bonding curve almost full" | near_completion |
| "graduated tokens", "already on DEX", "open market tokens" | completed |
| No specific stage mentioned | omit --type (returns all three) |
| Parameter | Required | Description |
|---|---|---|
--chain | Yes | sol / bsc / base |
--type | No | Categories to query, repeatable: new_creation / near_completion / completed (default: all three) |
--launchpad-platform | No | Launchpad platform filter, repeatable (default: all platforms for the chain) |
--limit | No | Max results per category, max 80 (default: 80) |
--filter-preset | No | Named server-side filter preset: safe / smart-money / strict |
--sort-by | No | Client-side sort per category: smart_degen_count / renowned_count / volume_24h / volume_1h / swaps_24h / swaps_1h / rug_ratio / holder_count / usd_market_cap / created_timestamp |
--direction | No | Sort direction: asc / desc (default: desc; asc for rug_ratio) |
--min-* / --max-* | No | Server-side filter range flags — see Filter Fields Reference below |
Presets are applied server-side: the API filters tokens before returning results.
| Preset | Server-side filters applied |
|---|---|
safe | max_rug_ratio=0.3 + max_bundler_rate=0.3 + max_insider_ratio=0.3 |
smart-money | min_smart_degen_count=1 |
strict | max_rug_ratio=0.3 + max_bundler_rate=0.3 + max_insider_ratio=0.3 + min_smart_degen_count=1 + min_volume_24h=1000 |
Preset + explicit flag interaction: Explicit filter flags always override preset values. For example, --filter-preset safe --max-rug-ratio 0.1 applies the safe preset but overrides rug_ratio threshold to 0.1.
All filter flags are sent as part of the API request body (server-side) — the server filters tokens before returning results. Use --limit 80 (the default maximum) to maximise the pool.
Response fields: data.new_creation, data.pump, data.completed — each is an array of RankItem (same fields as market trending rank items). Important: data.pump in the response corresponds to --type near_completion in the request. The API always returns this category under the key pump, not near_completion.
All filter flags are sent as part of the API request body — the server filters tokens before returning results. Flags follow the naming convention --min-{field} / --max-{field}.
| Flag pair | Type | Description |
|---|---|---|
--min-volume-24h / --max-volume-24h | float | 24h trading volume (USD) |
--min-net-buy-24h / --max-net-buy-24h | float | 24h net buy volume (USD) |
--min-swaps-24h / --max-swaps-24h | int | 24h total swap count |
--min-buys-24h / --max-buys-24h | int | 24h buy count |
--min-sells-24h / --max-sells-24h | int | 24h sell count |
--min-visiting-count / --max-visiting-count | int | Visitor count |
--min-progress / --max-progress | float | Bonding curve progress (0–1) |
--min-marketcap / --max-marketcap | float | Market cap (USD) |
--min-liquidity / --max-liquidity | float | Liquidity (USD) |
--min-created / --max-created | duration | Token age — unit suffix recommended: seconds (30s, 10s) or minutes (0.5m, 1m, 5m, 30m). Bare numbers (e.g. 5) are treated as minutes with a warning. |
--min-holder-count / --max-holder-count | int | Holder count |
--min-top-holder-rate / --max-top-holder-rate | float | Top-10 holder concentration (0–1) |
--min-rug-ratio / --max-rug-ratio | float | Rug pull risk score (0–1) |
--min-bundler-rate / --max-bundler-rate | float | Bundle-bot trading ratio (0–1) |
--min-insider-ratio / --max-insider-ratio | float | Insider trading ratio (0–1) |
--min-entrapment-ratio / --max-entrapment-ratio | float | Entrapment/Phishing trading ratio (0–1) |
--min-private-vault-hold-rate / --max-private-vault-hold-rate | float | Private vault holding ratio (0–1) |
--min-top70-sniper-hold-rate / --max-top70-sniper-hold-rate | float | Top-70 sniper holding ratio (0–1) |
--min-bot-count / --max-bot-count | int | Bot wallet count |
--min-bot-degen-rate / --max-bot-degen-rate | float | Bot-degen wallet ratio (0–1) |
--min-fresh-wallet-rate / --max-fresh-wallet-rate | float | Fresh wallet ratio (0–1) |
--min-total-fee / --max-total-fee | float | Total fee |
--min-smart-degen-count / --max-smart-degen-count | int | Smart-money holder count |
--min-renowned-count / --max-renowned-count | int | KOL / renowned wallet count |
--min-creator-balance-rate / --max-creator-balance-rate | float | Creator holding ratio (0–1) |
--min-creator-created-count / --max-creator-created-count | int | Creator's total token creation count |
--min-creator-created-open-count / --max-creator-created-open-count | int | Creator's graduated token count |
--min-creator-created-open-ratio / --max-creator-created-open-ratio | float | Creator's graduation ratio (0–1) |
--min-x-follower / --max-x-follower | int | Twitter / X follower count |
--min-twitter-rename-count / --max-twitter-rename-count | int | Twitter rename count |
--min-tg-call-count / --max-tg-call-count | int | Telegram call count |
# Apply the safe preset (server-side)
gmgn-cli market trenches --chain sol --type new_creation --filter-preset safe
# Require at least 1 smart money holder (server-side)
gmgn-cli market trenches --chain sol --type new_creation --min-smart-degen-count 1
# Safe preset + require smart money + sort by smart degen count (server-side filter, client-side sort)
gmgn-cli market trenches --chain sol --type new_creation \
--filter-preset safe --min-smart-degen-count 1 --sort-by smart_degen_count
# Strict preset — safe + smart money + min $1k volume (server-side)
gmgn-cli market trenches --chain sol --type new_creation --type near_completion \
--filter-preset strict --sort-by smart_degen_count
# Manual range filters (all sent server-side)
gmgn-cli market trenches --chain sol --type new_creation \
--max-rug-ratio 0.3 --max-bundler-rate 0.3 --max-insider-ratio 0.3 \
--min-smart-degen-count 1 --min-volume-24h 1000
# Filter by token age: only tokens created within the last 30 minutes
gmgn-cli market trenches --chain sol --type new_creation --max-created 30m
# Filter by market cap range
gmgn-cli market trenches --chain sol --type new_creation \
--min-marketcap 10000 --max-marketcap 500000
market trenches Response FieldsBasic Info
| Field | Description |
|---|---|
address | Token contract address |
symbol / name | Token symbol and name |
launchpad_platform | Launch platform (e.g. Pump.fun, letsbonk) |
exchange | Current exchange (e.g. pump_amm, raydium) |
usd_market_cap | Market cap in USD |
liquidity | Liquidity in USD |
total_supply | Total token supply |
created_timestamp | Creation time (Unix seconds) |
open_timestamp | Open market listing time (Unix seconds, completed only) |
complete_timestamp | Bonding curve completion time (Unix seconds) |
complete_cost_time | Time from creation to completion in seconds |
Trading Data
| Field | Description |
|---|---|
swaps_1m / swaps_1h / swaps_24h | Swap count per time window |
volume_1h / volume_24h | Trading volume in USD |
buys_24h / sells_24h | Buy / sell count in 24h |
net_buy_24h | Net buy volume in 24h |
holder_count | Number of token holders |
Security & Risk
| Field | Chains | Description |
|---|---|---|
renounced_mint | SOL | Whether mint authority is renounced (SOL-specific concept; always false on EVM chains) |
renounced_freeze_account | SOL | Whether freeze authority is renounced (SOL-specific concept; always false on EVM chains) |
burn_status | all | Liquidity burn status |
rug_ratio | all | Rug pull risk ratio |
top_10_holder_rate | all | Top 10 holders concentration ratio |
rat_trader_amount_rate | all | Insider / sneak trading volume ratio |
bundler_trader_amount_rate | all | Bundle trading volume ratio |
is_wash_trading | all | Whether wash trading is detected |
sniper_count | all | Number of sniper wallets |
suspected_insider_hold_rate | all | Suspected insider holding ratio |
open_source | all | Whether contract source code is verified ("yes" / "no" / "unknown") |
owner_renounced | all | Whether contract ownership is renounced ("yes" / "no" / "unknown") |
is_honeypot | BSC / Base | Whether token is a honeypot ("yes" / "no"); returns empty string on SOL (not applicable) |
buy_tax | all | Buy tax ratio (e.g. 0.03 = 3%) |
dev_team_hold_rate | all | Dev team holding ratio |
Dev Holdings
| Field | Description |
|---|---|
creator_token_status | Dev holding status (e.g. creator_hold, creator_close) |
creator_balance_rate | Dev holding ratio as a proportion of total supply |
Smart Money
| Field | Description |
|---|---|
smart_degen_count | Number of smart money holders |
renowned_count | Number of renowned wallet holders (KOL) |
Social Media
| Field | Description |
|---|---|
twitter | Twitter / X link |
telegram | Telegram link |
website | Website link |
instagram | Instagram link |
tiktok | TikTok link |
has_at_least_one_social | Whether any social media link exists |
x_user_follower | Twitter follower count |
cto_flag | Whether community takeover (CTO) has occurred |
Dexscreener Marketing
| Field | Description |
|---|---|
dexscr_ad | Whether a Dexscreener ad has been placed |
dexscr_update_link | Whether social links have been updated on Dexscreener |
dexscr_trending_bar | Whether paid for Dexscreener trending bar placement |
dexscr_boost_fee | Amount paid for Dexscreener boost (0 = none) |
After fetching trenches results, apply the Token Quality Filter Criteria section before presenting tokens to the user. Do not dump raw results — filter first, then surface the strongest candidates.
# Quick safe screen — exclude rugs, wash trading, and bundlers
gmgn-cli market trenches --chain sol --type new_creation \
--filter-preset safe --raw
# Smart money screen — only tokens with smart money or KOL presence
gmgn-cli market trenches --chain sol \
--type new_creation --type near_completion \
--filter-preset smart-money \
--sort-by smart_degen_count --raw
# Strict screen — safe + smart money + minimum volume, sorted by smart degens
gmgn-cli market trenches --chain sol --type completed \
--filter-preset strict --sort-by smart_degen_count --raw
# Custom filter — no wash trading, rug_ratio <= 0.2, at least 1 smart degen
gmgn-cli market trenches --chain sol \
--type new_creation --type near_completion \
--exclude-wash-trading --max-rug-ratio 0.2 --min-smart-degen 1 \
--sort-by smart_degen_count --raw
# BSC — safe screen on new tokens from fourmeme
gmgn-cli market trenches --chain bsc --type new_creation \
--launchpad-platform fourmeme --launchpad-platform fourmeme_agent \
--filter-preset safe --sort-by volume_1h --raw
# Sort by rug_ratio ascending (safest first), no other filters
gmgn-cli market trenches --chain sol --type completed \
--sort-by rug_ratio --raw
# Find tokens with many holders and strong 1h swap activity
gmgn-cli market trenches --chain sol --type completed \
--min-holders 100 --min-swaps 50 \
--sort-by swaps_1h --raw
# All three categories at once
gmgn-cli market trenches --chain sol --raw \
--type new_creation --type near_completion --type completed \
--launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform pump_mayhem_agent --launchpad-platform pump_agent --launchpad-platform letsbonk --launchpad-platform bonkers --launchpad-platform bags \
--limit 80
# New creation only
gmgn-cli market trenches --chain sol --raw \
--type new_creation \
--launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform pump_mayhem_agent --launchpad-platform pump_agent --launchpad-platform letsbonk --launchpad-platform bonkers --launchpad-platform bags \
--limit 80
# Near completion only
gmgn-cli market trenches --chain sol --raw \
--type near_completion \
--launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform pump_mayhem_agent --launchpad-platform pump_agent --launchpad-platform letsbonk --launchpad-platform bonkers --launchpad-platform bags \
--limit 80
# Completed (open market) only
gmgn-cli market trenches --chain sol --raw \
--type completed \
--launchpad-platform Pump.fun --launchpad-platform pump_mayhem --launchpad-platform pump_mayhem_agent --launchpad-platform pump_agent --launchpad-platform letsbonk --launchpad-platform bonkers --launchpad-platform bags \
--limit 80
# All three categories at once
gmgn-cli market trenches --chain bsc --raw \
--type new_creation --type near_completion --type completed \
--launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent --launchpad-platform flap --launchpad-platform clanker --launchpad-platform lunafun \
--limit 80
# New creation only
gmgn-cli market trenches --chain bsc --raw \
--type new_creation \
--launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent --launchpad-platform flap --launchpad-platform clanker --launchpad-platform lunafun \
--limit 80
# Near completion only
gmgn-cli market trenches --chain bsc --raw \
--type near_completion \
--launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent --launchpad-platform flap --launchpad-platform clanker --launchpad-platform lunafun \
--limit 80
# Completed (open market) only
gmgn-cli market trenches --chain bsc --raw \
--type completed \
--launchpad-platform fourmeme --launchpad-platform fourmeme_agent --launchpad-platform bn_fourmeme --launchpad-platform four_xmode_agent --launchpad-platform flap --launchpad-platform clanker --launchpad-platform lunafun \
--limit 80
# All three categories at once
gmgn-cli market trenches --chain base --raw \
--type new_creation --type near_completion --type completed \
--launchpad-platform clanker --launchpad-platform bankr --launchpad-platform flaunch --launchpad-platform zora --launchpad-platform zora_creator --launchpad-platform baseapp --launchpad-platform basememe --launchpad-platform virtuals_v2 --launchpad-platform klik \
--limit 80
# New creation only
gmgn-cli market trenches --chain base --raw \
--type new_creation \
--launchpad-platform clanker --launchpad-platform bankr --launchpad-platform flaunch --launchpad-platform zora --launchpad-platform zora_creator --launchpad-platform baseapp --launchpad-platform basememe --launchpad-platform virtuals_v2 --launchpad-platform klik \
--limit 80
# Near completion only
gmgn-cli market trenches --chain base --raw \
--type near_completion \
--launchpad-platform clanker --launchpad-platform bankr --launchpad-platform flaunch --launchpad-platform zora --launchpad-platform zora_creator --launchpad-platform baseapp --launchpad-platform basememe --launchpad-platform virtuals_v2 --launchpad-platform klik \
--limit 80
# Completed (open market) only
gmgn-cli market trenches --chain base --raw \
--type completed \
--launchpad-platform clanker --launchpad-platform bankr --launchpad-platform flaunch --launchpad-platform zora --launchpad-platform zora_creator --launchpad-platform baseapp --launchpad-platform basememe --launchpad-platform virtuals_v2 --launchpad-platform klik \
--limit 80
market kline — Price SummaryAfter fetching candles, present a brief price analysis. Do not dump raw candle arrays.
{symbol} — {resolution} chart ({from} → {to})
Open: ${open of first candle} | Close: ${close of last candle} | Range: ${min low} – ${max high}
Total volume: ${sum of all volume fields} USD
Trend: [brief description — e.g. "steady uptrend", "sharp drop then recovery", "sideways"]
market trending — Top Tokens TablePresent the top results (default: top 10, or as requested) as a table:
# | Symbol | Price | MCap | Volume ({interval}) | 1h Chg | SM | Liq | Platform | Signal
Where Signal = quality flag derived from the token's data:
smart_degen_count ≥ 3 AND rug_ratio < 0.2 AND is_wash_trading = falserug_ratio > 0.3 OR is_wash_trading = true OR is_honeypot = 1Then give a one-line highlight for any standout tokens (e.g. "TOKEN1 has 12 smart money holders and +85% in 1h — 🟢 strong signal").
market trenches — Grouped by CategoryPresent each category separately with a header:
🆕 New Creation ({count} tokens)
# | Symbol | Created | Liquidity | Swaps (1h) | Smart Degens | Social
⏳ Near Completion ({count} tokens)
# | Symbol | Market Cap | Swaps (1h) | Smart Degens | Social
✅ Graduated ({count} tokens)
# | Symbol | Market Cap | Volume (1h) | Smart Degens | Social
market signal ParametersChains: sol / bsc only. Maximum 50 results per group — use multiple groups via --groups to cover different signal types in a single request.
Single-group (individual flags):
Do not pass signal types 14, 15, or 16 in signal_type / --signal-type / --groups JSON — OpenAPI returns 400 if any group includes them. Omitting --signal-type (empty filter) still queries all types upstream; responses may still include 14–16 in that case.
| Option | Required | Description |
|---|---|---|
--chain | Yes | sol / bsc |
--signal-type | No | Signal type(s), repeatable (1–18, default: all). See Signal Types below. |
--mc-min | No | Min market cap at trigger time (USD) |
--mc-max | No | Max market cap at trigger time (USD) |
--trigger-mc-min | No | Min market cap at signal trigger moment (USD) |
--trigger-mc-max | No | Max market cap at signal trigger moment (USD) |
--total-fee-min | No | Min total fees paid (USD) |
--total-fee-max | No | Max total fees paid (USD) |
--min-create-or-open-ts | No | Min token creation or open timestamp (Unix seconds string) |
--max-create-or-open-ts | No | Max token creation or open timestamp (Unix seconds string) |
Multi-group override:
Pass --groups '<json_array>' to query multiple filter groups in a single request. The upstream executes all groups in parallel and merges results sorted by trigger_at descending. When --groups is present, all individual flags above are ignored.
gmgn-cli market signal --chain sol \
--groups '[{"signal_type":[12,13]},{"signal_type":[6,7],"mc_min":50000}]'
| Value | Name | Description |
|---|---|---|
| 1 | SignalType1 | General signal (K-line price spike) |
| 2 | SignalTypeDexAd | Dex ad placement |
| 3 | SignalTypeDexUpdateLink | Dex social link updated |
| 4 | SignalTypeDexTrendingBar | Dex trending bar |
| 5 | SignalTypeDexBoost | Dex Boost |
| 6 | SignalTypePriceUp | Price spike |
| 7 | SignalTypePriceATH | All-time high price |
| 8 | SignalTypeMcpKeyLevel | Market cap key level |
| 9 | SignalTypeLive | Live stream |
| 10 | SignalTypeBundlerSell | Bundler sell |
| 11 | SignalTypeCto | Community takeover (CTO) |
| 12 | SignalTypeSmartDegenBuy | Smart money buy |
| 13 | SignalTypePlatformCall | Platform call |
| 14 | SignalTypeLargeAmountBuy | Large amount buy |
| 15 | SignalTypeMultiBuy | Multiple buys |
| 16 | SignalTypeMultiLargeBuy | Multiple large buys |
| 17 | SignalTypeBagsClaims | Bags Claim |
| 18 | SignalTypePumpClaims | Pump Claim |
market signal Response FieldsEach item in the response array is one signal event:
| Field | Type | Description |
|---|---|---|
id | string | Signal event ID |
token_address | string | Token contract address |
signal_type | number | Signal type (1–18, see Signal Types above) |
trigger_at | number | Unix timestamp (seconds) when the signal was triggered |
trigger_mc | number | Market cap at signal trigger time (USD) |
first_trigger_mc | number | Market cap at the very first trigger for this token (USD) |
market_cap | number | Current market cap (USD) |
ath | number | All-time high market cap (USD) |
signal_times | number | Total number of times this signal has triggered for this token |
signal_times_by_type | object | Signal trigger count broken down by type |
cur_data | object | Real-time token stats at query time (see below) |
data | object | Full upstream snapshot at trigger time (chain-specific, raw passthrough) |
cur_data fields:
| Field | Type | Description |
|---|---|---|
top_10_holder_rate | number | Top 10 holder concentration ratio (0–1) |
holder_count | number | Current holder count |
liquidity | number | Current liquidity (USD) |
# All signals on SOL (no --signal-type: upstream returns all types, including 14–16 if present)
gmgn-cli market signal --chain sol --raw
# Smart money buys only (type 12)
gmgn-cli market signal --chain sol --signal-type 12 --raw
# Price spikes + ATH (types 6 and 7) with market cap filter
gmgn-cli market signal --chain sol \
--signal-type 6 --signal-type 7 \
--mc-min 50000 --mc-max 5000000 --raw
# Smart money buys on BSC
gmgn-cli market signal --chain bsc --signal-type 12 --raw
# Multi-group: parallel groups (do not use signal_type 14–16 — API returns 400)
gmgn-cli market signal --chain sol \
--groups '[{"signal_type":[12]},{"signal_type":[6,7]}]' --raw
# Multi-group: combine signal type filter with market cap range per group
gmgn-cli market signal --chain sol \
--groups '[{"signal_type":[12,13],"mc_min":100000},{"signal_type":[6,7],"mc_min":50000,"mc_max":1000000}]' --raw
market kline: --from and --to are Unix timestamps in seconds — CLI converts to milliseconds automaticallymarket trending: --filter and --platform are repeatable flags--raw to get single-line JSON for further processing0x + 40 hex digits). The CLI enforces this at runtime.