gmgn-market

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Use the

gmgn-cli

tool to query K-line data for a token or browse trending tokens.

使用

gmgn-cli

工具查询代币的K线数据或浏览热门代币。

Sub-commands

子命令

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

子命令	说明
`market kline`	代币蜡烛图数据
`market trending`	热门代币交易兑换数据

Supported Chains

支持的链

sol

bsc

base

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_API_KEY
```
的
```
.env
```
文件
从
```
.env
```
文件所在目录运行，或在环境变量中设置
```
GMGN_HOST
```

Kline Parameters

K线参数

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)

参数	是否必填	说明
`--chain`	是	`sol` / `bsc` / `base`
`--address`	是	代币合约地址
`--resolution`	是	蜡烛图时间精度
`--from`	否	开始时间（Unix时间戳，秒）
`--to`	否	结束时间（Unix时间戳，秒）

Resolutions

时间精度选项

1m

5m

15m

1h

4h

1d

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`

选项	说明
`--chain`	必填。 `sol` / `bsc` / `base`
`--interval`	必填。 `1h` / `3h` / `6h` / `24h`
`--limit <n>`	结果数量（默认100，最大100）
`--orderby <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>`	排序方向（默认 `desc` ）
`--filter <tag...>`	可重复使用的筛选标签： `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...>`	可重复使用的平台筛选： `pump` / `moonshot` / `launchlab`

Usage Examples

使用示例

bash

undefined

bash

undefined

Last 1 hour of 1-minute candles

最近1小时的1分钟K线数据

macOS:

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

Linux: 使用$(date -d '1 hour ago' +%s)替代$(date -v-1H +%s)

Last 24 hours of 1-hour candles

最近24小时的1小时K线数据

macOS:

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

Linux: 使用$(date -d '24 hours ago' +%s)替代$(date -v-24H +%s)

Top 20 hot tokens on SOL in the last 1 hour, sorted by volume

SOL链过去1小时内按交易量排序的前20个热门代币

npx gmgn-cli market trending --chain sol --interval 1h --orderby volume --limit 20

Hot tokens with social links only, not risky, on BSC over 24h

BSC链过去24小时内仅带社交链接、无风险的热门代币

npx gmgn-cli market trending
--chain bsc --interval 24h
--filter has_social --filter not_risk

Pump platform tokens on SOL, last 6 hours

SOL链过去6小时内Pump平台上的代币

npx gmgn-cli market trending --chain sol --interval 6h --platform pump

Raw output for further processing

输出原始JSON用于后续处理

npx gmgn-cli market kline --chain sol --address <addr>
--resolution 5m --from <ts> --to <ts> --raw | jq '.[]'

undefined

npx gmgn-cli market kline --chain sol --address <addr>
--resolution 5m --from <ts> --to <ts> --raw | jq '.[]'

undefined

Workflow: Discover Trading Opportunities via Trending

工作流：通过热门数据发现交易机会

Step 1 — Fetch trending data

步骤1——获取热门数据

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

bash

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

使用安全筛选条件获取广泛的代币池，并按GMGN综合评分排序：

bash

npx 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

步骤2——AI多因子分析

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.

使用以下信号分析响应中的每条记录（需灵活判断，而非僵化执行规则）：

信号	字段	权重	说明
GMGN质量评分	`score`	高	GMGN提供的核心排名信号
聪明资金关注度	`smart_degen_count` , `renowned_count`	高	关键的信心指标
蓝筹地址持仓占比	`bluechip_owner_percentage`	中	持有者群体的质量
真实交易活跃度	`volume` , `swaps`	中	区分真实兴趣与洗盘交易
价格动量	`change1h` , `change5m`	中	优先选择正向、非抛物线式的涨幅
资金池安全性	`liquidity`	中	低流动性意味着高滑点风险
代币成熟度	`creation_timestamp`	低	除非其他信号极强，否则避免选择创建时间不足约1小时的代币

选择综合表现最佳的前5个代币。优先选择在多个信号上表现良好的代币，而非仅单一信号突出的代币。

Step 3 — Present top 5 to user

步骤3——向用户展示前5个代币

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

Top 5 Trending Tokens — SOL / 1h

以简洁表格形式展示结果，然后为每个选中的代币提供一行理由：

Top 5 热门代币 — SOL / 1小时

| Symbol | Address (short) | Score | Smart Degens | Volume | 1h Chg | Reasoning

| 符号 | 地址（简写） | 评分 | 聪明资金地址数 | 交易量 | 1小时涨幅 | 理由

1 | ... | ... | ... | ... | ... | ... | High score + smart money accumulating 2 | ... ...

undefined

1 | ... | ... | ... | ... | ... | ... | 高评分+聪明资金持续积累 2 | ... ...

undefined

Step 4 — Follow-up actions

步骤4——后续操作

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

为每个代币提供以下选项：

深度调研：
```
token info
```
+
```
token security
```
以完成全面尽职调查
交易兑换：若用户对热门数据满意，可直接执行交易

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

```
market kline
```
：
```
--from
```
和
```
--to
```
为秒级Unix时间戳——CLI会自动转换为毫秒
```
market trending
```
：
```
--filter
```
和
```
--platform
```
是可重复使用的参数
所有命令使用常规认证（仅需API Key，无需签名）
若用户未提供K线时间戳，根据用户期望的时间范围从当前时间自动计算
使用
```
--raw
```
获取单行JSON以用于后续处理