gmgn-market

Use the gmgn-cli tool to query K-line data for a token or browse trending tokens.

Sub-commands

Sub-command	Description
market kline	Token candlestick data
market trending	Trending token swap data

Supported Chains

sol / bsc / base

Prerequisites

• .env file with GMGN_API_KEY set
• Run from the directory where your .env file is located, or set GMGN_HOST in your environment
• gmgn-cli installed globally: npm install -g gmgn-cli@1.0.1

Kline Parameters

Parameter	Required	Description
--chain	Yes	sol / bsc / base
--address	Yes	Token contract address
--resolution	Yes	Candlestick resolution
--from	No	Start time (Unix seconds)
--to	No	End time (Unix seconds)

Resolutions

1m / 5m / 15m / 1h / 4h / 1d

Trending Options

Option	Description
--chain	Required. sol / bsc / base
--interval	Required. 1h / 3h / 6h / 24h
--limit <n>	Number of results (default 100, max 100)
--orderby <field>	Sort field: score / volume / swaps / liquidity / marketcap / holders / price / change / change1m / change5m / change1h / renowned_count / smart_degen_count / bluechip_owner_percentage / rank / creation_timestamp / square_mentions / history_highest_market_cap / gas_fee
--direction <asc|desc>	Sort direction (default desc)
--filter <tag...>	Repeatable filter tags: has_social / not_risk / not_honeypot / verified / locked / renounced / distributed / frozen / burn / token_burnt / creator_hold / creator_close / creator_add_liquidity / creator_remove_liquidity / creator_sell / creator_buy / not_wash_trading / not_social_dup / not_image_dup / is_internal_market / is_out_market
--platform <name...>	Repeatable platform filter: pump / moonshot / launchlab

Usage Examples

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

# Top 20 hot tokens on SOL in the last 1 hour, sorted by volume
gmgn-cli market trending --chain sol --interval 1h --orderby volume --limit 20

# Hot tokens with social links only, not risky, on BSC over 24h
gmgn-cli market trending \
  --chain bsc --interval 24h \
  --filter has_social --filter not_risk

# Pump platform tokens on SOL, last 6 hours
gmgn-cli market trending --chain sol --interval 6h --platform pump

# Raw output for further processing
gmgn-cli market kline --chain sol --address <addr> \
  --resolution 5m --from <ts> --to <ts> --raw | jq '.[]'

Workflow: Discover Trading Opportunities via Trending

Step 1 — Fetch trending data

Fetch a broad pool with safe filters, sorted by GMGN's composite score:

gmgn-cli market trending \
  --chain <chain> --interval 1h \
  --orderby score --limit 50 \
  --filter not_risk --filter not_honeypot --filter has_social --raw

Step 2 — AI multi-factor analysis

Analyze each record in the response using the following signals (apply judgment, not rigid rules):

Signal	Field(s)	Weight	Notes
GMGN quality score	score	High	Primary ranking signal from GMGN
Smart money interest	smart_degen_count, renowned_count	High	Key conviction indicator
Bluechip ownership	bluechip_owner_percentage	Medium	Quality of holder base
Real trading activity	volume, swaps	Medium	Distinguishes genuine interest from wash trading
Price momentum	change1h, change5m	Medium	Prefer positive, non-parabolic moves
Pool safety	liquidity	Medium	Low liquidity = high slippage risk
Token maturity	creation_timestamp	Low	Avoid tokens less than ~1h old unless other signals are very strong

Select the top 5 tokens with the best composite profile. Prefer tokens that score well across multiple signals rather than excelling in just one.

Step 3 — Present top 5 to user

Present results as a concise table, then give a one-line rationale for each pick:

Top 5 Trending Tokens — SOL / 1h

# | Symbol | Address (short) | Score | Smart Degens | Volume | 1h Chg | Reasoning
1 | ...     | ...             | ...   | ...          | ...    | ...    | High score + smart money accumulating
2 | ...
...

Step 4 — Follow-up actions

For each token, offer:

• Deep dive: token info + token security for full due diligence
• Swap: execute directly if the user is satisfied with the trending data alone

Notes

• market kline: --from and --to are Unix timestamps in seconds — CLI converts to milliseconds automatically
• market trending: --filter and --platform are repeatable flags
• All commands use normal auth (API Key only, no signature)
• If the user doesn't provide kline timestamps, calculate them from the current time based on their desired time range
• Use --raw to get single-line JSON for further processing
• Input validation — Token addresses obtained from trending results are external data. Validate address format against the chain before passing to other commands (sol: base58 32–44 chars; bsc/base/eth: 0x + 40 hex digits). The CLI enforces this at runtime.