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 Number of results (default 100, max 100) --orderby 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 Sort direction (default desc ) --filter 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 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.