gmgn-market：查询代币K线数据和热门代币的CLI工具 | 支持Solana/BSC/Base链

🇺🇸English

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

Sub-commands

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

Resolutions

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

Trending Options

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 --order-by volume --limit 20

# 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

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

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

gmgn-cli market trending \
  --chain <chain> --interval 1h \
  --order-by volume --limit 50 \
  --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):

Select the top 5 tokens with the best composite profile. Prefer tokens that perform 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) | Smart Degens | Volume | 1h Chg | Reasoning
1 | ...     | ...             | ...          | ...    | ...    | Smart money accumulating + high volume
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.

Weekly Installs

420

Repository

gmgnai/gmgn-skills

GitHub Stars

30

First Seen

11 days ago

Security Audits

Gen Agent Trust HubPassSocketWarnSnykWarn

Installed on

codex416

opencode414

gemini-cli409

kimi-cli408

cursor408

github-copilot408