gmgn-market

运行任何命令之前：先运行 gmgn-cli config --check。如果退出代码为 0，则正常继续。如果退出代码为 1，则：（1）运行 gmgn-cli config 并向用户显示输出；（2）用户发送 API Key 后，运行 gmgn-cli config --apply <KEY> 完成配置和验证，然后向用户显示输出。如果 --check 返回错误（未知选项或找不到命令），请告知用户运行 npm install -g gmgn-cli 进行更新，然后重试。

重要：始终使用下方的 gmgn-cli 命令。不要使用网页搜索、WebFetch、curl，也不要访问 gmgn.ai 获取此数据——该网站需要登录，且不会返回结构化数据。CLI 是唯一正确的方法。

重要：不要猜测字段名称或值。如果字段含义不明确，请先查阅下方的“响应字段”部分，再使用该字段。

⚠️ 不支持 IPv6：如果遇到 401 或 403 错误，且凭据看起来正确，请立即检查 IPv6：（1）列出所有网络接口及其 IPv6 地址——运行 ifconfig | grep inet6（macOS）或 ip addr show | grep inet6（Linux）；（2）向 https://ipv6.icanhazip.com 发送测试请求——如果响应是 IPv6 地址，则说明出站流量正在通过 IPv6。请立即告知用户：“请在网络接口上禁用 IPv6——gmgn-cli 命令只能通过 IPv4 运行。”

使用 gmgn-cli 工具查询代币的 K 线数据、浏览热门代币，或查看 Trenches 代币列表。

核心概念

• --filter 链默认值 — SOL 和 EVM 链具有不同的默认安全过滤条件，在省略 --filter 时会自动应用。不要假设所有链的默认值都相同：

  • SOL：默认为 renounced frozen（放弃铸币和冻结权限）
  • BSC / Base / ETH（EVM）：默认为 not_honeypot verified renounced
  • 省略 --filter 并不等于“无过滤条件”——始终会应用链默认值。若要使用自定义过滤条件集，请明确指定所有需要的过滤标签。

• volume 与 amount（kline） — 命名容易引起误解。volume = 交易的美元价值；amount = 交易的代币数量。对于价格为 $0.0002 的代币，两者相差 5,000 倍。表示“交易了多少美元”时，始终使用 volume；表示“交易了多少代币”时，使用 amount。

• rug_ratio — 用于估算 Rug Pull 可能性的 0–1 分数。高于 0.3 表示高风险。不要将其视为二元指标——应结合 top_10_holder_rate、dev_team_hold_rate 和 is_honeypot 综合判断。

• smart_degen_count / renowned_count — 持有或交易该代币的平台标记智能资金钱包（smart_degen）和 KOL 钱包（renowned）数量。数值较高是看涨信号。这些钱包列表由 GMGN 标记，并非用户自定义。

• hot_level — 趋势热度分数。数值越高，表示当前交易越活跃。该分数未归一化——请在同一结果集中比较相对值，不要跨时间窗口比较。

• renounced_mint / renounced_freeze_account — SOL 专属字段。分别表示创建者是否放弃了增发代币或冻结钱包的能力。在 Solana 上，两者均为 1 是安全基线。在 EVM 链上始终为 false（此概念不适用）。

• is_honeypot — EVM 专属字段（BSC / Base）。表示代币合约是否禁止卖出。在 SOL 上始终为空/null——不要将空值解读为“不是蜜罐币”。

• creator_token_status — 开发者持仓状态。creator_hold = 开发者仍持有代币（存在抛售压力风险）。creator_close = 开发者已出售或销毁其份额（已确认退出信号）。

• cto_flag — 社区接管标记。1 = 原开发者放弃项目，由社区团队接管营销和开发。属于中性偏积极的信号；需结合具体情况评估。

• Trenches 分类 — Launchpad 代币生命周期的三个阶段：new_creation（刚创建，仍处于联合曲线阶段）、near_completion（联合曲线即将填满，即将毕业）、completed（已毕业并进入公开市场 / DEX）。在响应中，无论输入的 --type 是什么，near_completion 始终会以 data.pump 为键返回。

• wash_trading / rat_trader_amount_rate / bundler_rate — 人为制造交易活动的风险信号。is_wash_trading = 检测到协同造假交易量。rat_trader_amount_rate = 内幕交易 / 偷跑交易的比例。bundler_rate = 上线时由机器人捆绑买入的比例。数值较高（> 0.3）表明价格走势可能受到操纵。

子命令

子命令	描述
market kline	指定时间范围内的代币 K 线 / OHLCV 数据和交易量
market trending	按兑换活动排名的热门代币——使用 --interval 指定时间窗口（例如，1m 表示 1 分钟内最热门，1h 表示 1 小时热门代币）
market trenches	新发行的启动平台代币——当用户询问“新代币”“刚发行的代币”“pump.fun/letsbonk 上的最新代币”时使用此命令。分为三类：new_creation（刚创建）、near_completion（联合曲线即将填满）、completed（已毕业并进入公开市场 / DEX）
market signal	实时代币信号流——价格飙升、聪明钱买入、大额买入、Dex 广告、CTO 事件等。结果按 trigger_at 降序排列。仅支持 sol / bsc / robinhood / arc / stable。每组最多 50 条结果。
market hot-searches	热搜排名——按 visiting_count（搜索热度）排列的搜索次数最多的代币。**当用户询问“大家在搜索哪些代币”“搜索次数最多的代币”“热搜榜”时使用。**单次请求支持多个链。
market search	按名称、代号、合约地址、钱包地址或 ENS 查找特定代币或钱包。返回匹配的代币（coins）和钱包（wallets）。当用户提到某个代币 / 钱包并想要查找时使用——“搜索 PEPE”“查找此地址”“查找 vitalik.eth”“查一下这个代币 / 钱包”——而不是浏览排名（trending / hot-searches）。

支持的链

sol / bsc / base / eth / arbitrum / hyperevm / robinhood / arc / stable（kline / trending / trenches / hot-searches；signal：sol / bsc / robinhood / arc / stable；search：--chain 可选——省略此参数即可搜索所有链；接受 all 以及搜索模块已启用的任何链，包括动态启用的链，例如 tron / monad / megaeth / xlayer）

前提条件

• 已全局安装 gmgn-cli——如果尚未安装，请运行：npm install -g gmgn-cli
• 已在 ~/.config/gmgn/.env 中配置 GMGN_API_KEY

速率限制处理

此技能使用的所有标准市场路由均采用 GMGN 基于套餐的漏桶限流：Free 5/5、Plus 20/20、Pro 50/50（速率/容量）。持续吞吐量约为 套餐速率 ÷ 权重 次请求/秒，最大突发量约为 floor(套餐容量 ÷ 权重)。仅限 Pro 使用的 1s K 线路由采用 Pro API 密钥桶，以及单独的共享全局桶。

命令	路由	权重
market kline（标准分辨率）	GET /v1/market/token_kline	2
market kline --resolution 1s（仅限 Pro）	GET /v1/market/token_kline	对 Pro API 密钥桶的权重为 3；共享全局限流：500 req/s
market trending	GET /v1/market/rank	3
market trenches	POST /v1/trenches	2
market signal	POST /v1/market/token_signal	1
market hot-searches	POST /v1/market/hot_searches	3
market search	GET /v1/market/search	1

请求返回 429 时：

• 如果错误为 RATE_LIMIT_EXCEEDED，请原样告知用户：已达到当前套餐的限频上限，点击 https://gmgn.ai/ai?chain=bsc&tab=paid_plans 升级套餐，获得更高速率限制。每项用户任务最多显示一次此升级提示。同一冷却期间后续出现 RATE_LIMIT_BANNED 时，不要重复提示。

• 从响应头中读取 X-RateLimit-Reset。这是一个 Unix 时间戳（秒），表示限额预计重置的时间。

• 如果响应正文包含 reset_at（例如，{"code":429,"error":"RATE_LIMIT_BANNED","message":"...","reset_at":1775184222}），请提取 reset_at——这是封禁解除的 Unix 时间戳（通常为 5 分钟后）。将其转换为本地时间，并准确告知用户何时可以重试。

• 当剩余冷却时间较短时，CLI 可能会等待并自动重试一次。如果仍然失败，请停止并告知用户准确的重试时间，不要再发送请求。

• 对于 RATE_LIMIT_EXCEEDED 或 RATE_LIMIT_BANNED，在冷却期间重复请求可能会使封禁时间每次延长 5 秒，最长可达 5 分钟。不要频繁重试。

• 如果错误为 RATE_LIMIT_BANNED_MAX，表示由于冷却期间请求仍不断到达，封禁已达到 5 分钟上限。停止本任务中的所有 GMGN 调用（不只是失败的调用），并告知用户准确的重置时间；在 reset_at 之前发送任何请求，都会使封禁时间重新延长至 5 分钟。

• 如果错误为 403 PLAN_UPGRADE_REQUIRED，表示该端点消耗的速率限制权重超过用户套餐容量，因此在当前套餐下永远无法成功——不要重试或等待。请告知用户当前套餐无法使用该端点，并展示响应中的 upgrade_message（其中包含升级链接 https://gmgn.ai/ai?chain=bsc&tab=paid_plans）。

market kline 参数

参数	必填	描述
--chain	是	sol / bsc / base / eth / arbitrum / hyperevm / robinhood / arc / stable
--address	是	代币合约地址
--resolution	是	K 线分辨率：1s（仅限 Pro；每次请求最多 500 根 K 线） / 30s / 1m / 5m / 15m / 1h / 4h / 1d
--from	否	起始时间（Unix 秒）
--to	否	结束时间（Unix 秒）

market kline 响应字段

响应是一个包含 list 数组的对象。list 中的每个元素都是一根 K 线：

字段	类型	描述
time	number	K 线开盘时间——Unix 时间戳，单位为秒
open	string	周期开始时以 USD 计的开盘价
close	string	周期结束时以 USD 计的收盘价
high	string	周期内以 USD 计的最高价
low	string	周期内以 USD 计的最低价
volume	string	以基础代币单位计的交易量（交易的代币数量）
amount	string	以 USD 计的交易量（该周期内所有交易的美元价值）

重要区别（命名容易让人误解——请勿臆测）：

• volume = 代币数量（例如，5379110 表示约 538 万枚代币易手）
• amount = USD 美元价值（例如，1214 表示交易金额约为 1,214 USD）——要查询「以 USD 计的交易额」，请使用此字段
• 对于价格不为 1 USD 的代币，volume 和 amount 会相差多个数量级（例如，对于价格为 0.0002 USD 的代币，amount 为 1,214 USD 时，对应的 volume 为 5,379,110 枚代币）
• 要获取一段时间内的 USD 总交易量，请对该时间范围内所有 K 线的 amount 求和
• 要获取价格趋势，请按时间顺序（time 升序）读取 close 值
• 要检测波动性，请比较每根 K 线的 high 和 low
• K 线按时间顺序返回（从最早到最晚）

market trending 选项

--interval 选择指南——始终与用户指定的时间范围匹配：

用户表述	--interval
“1m trending” / “现在最热门”	1m
“5m” / “5 分钟”	5m
“1h” / “1 小时” / 未指定时间（默认值）	1h
“6h” / “6 小时”	6h
“24h” / “今天” / “每日”	24h

选项	说明
--chain	必需。sol / bsc / base / eth / arbitrum / hyperevm / robinhood / arc / stable
--interval	必需。1m / 5m / 1h / 6h / 24h（默认值为 1h）
--limit <n>	结果数量（默认值为 100，最多 100）
--order-by <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>	排序方向（默认值为 desc）
--filter <tag...>	可重复指定的筛选标签（因链而异）。⚠️ SOL 默认值：renounced frozen；BSC/Base/ETH 默认值：not_honeypot verified renounced。 省略 --filter 并不代表“无筛选”——始终会应用链默认值。sol 标签：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 标签：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...>	可重复指定的平台筛选条件（因链而异）。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 / four_xmode_agent / cubepeg / likwid / goplus_creator / goplus_skills / openfour / flap / flap_stocks / flap_aioracle / clanker / lunafun / pool_uniswap / pool_pancake。base：clanker / bankr / flaunch / zora / zora_creator / baseapp / basememe / virtuals_v2 / klik。eth：trench / clanker / klik / livo / stroid / pool_uniswap_v2 / pool_uniswap_v3 / printr

market trending 范围筛选

可选的 --min-* / --max-* 标志会在服务端应用数值范围筛选（含边界）。服务会忽略未知指标。

选项	描述
--min-volume / --max-volume	交易量（USD）
--min-liquidity / --max-liquidity	流动性（USD）
--min-marketcap / --max-marketcap	市值（USD）
--min-history-highest-marketcap / --max-history-highest-marketcap	历史最高市值（USD）
--min-swaps / --max-swaps	交换次数
--min-holder-count / --max-holder-count	持有者数量
--min-gas-fee / --max-gas-fee	Gas 费用
--min-renowned-count / --max-renowned-count	KOL / 知名钱包数量
--min-smart-degen-count / --max-smart-degen-count	聪明资金持有者数量
--min-bot-degen-count / --max-bot-degen-count	Bot-degen 钱包数量
--min-visiting-count / --max-visiting-count	访客数量
--min-price-change-percent / --max-price-change-percent	区间内价格变化率
--min-insider-rate / --max-insider-rate	内幕交易比率（0–1）；缺少此字段的代币会被排除
--min-bundler-rate / --max-bundler-rate	捆绑机器人交易比率（0–1）；缺少此字段的代币会被排除
--min-entrapment-ratio / --max-entrapment-ratio	诱捕交易比率（0–1）；缺少此字段的代币会被排除
--min-top10-holder-rate / --max-top10-holder-rate	前 10 名持有者集中度（0–1）
--min-top70-sniper-hold-rate / --max-top70-sniper-hold-rate	前 70 名狙击者持有比率（0–1）
--min-dev-team-hold-rate / --max-dev-team-hold-rate	开发团队持有比率（0–1）；--min-dev-team-hold-rate 还会排除创建者已关闭的代币
--min-created / --max-created	代币年龄范围，时长字符串，后缀为 m（分钟）/ h（小时）/ d（天），例如 30m / 6h / 7d。--min-created 表示最小年龄（排除较新的代币）；--max-created 表示最大年龄（排除较旧的代币）。**注意：**原始上游排名接口仅接受分钟；openapi-service 不会转发此字段，而是自行计算年龄范围（截止时间 = 当前时间 − 时长，原生支持 m/h/d），因此此处可使用 6h / 7d。务必包含单位后缀——不接受单独的数字。

使用示例

Kline

1s 仅适用于 Pro API 密钥。请求范围应限制在 500 秒以内，因为 1 秒请求最多返回 500 根 K 线。Free 和 Plus 密钥会收到 403 PRO_PLAN_REQUIRED；不要使用同一密钥重试。如果已安装的 CLI 不接受 1s，请先更新 CLI；不要悄悄回退到更粗的分辨率。

# Last 500 seconds of 1-second candles (Pro only; macOS)
gmgn-cli market kline \
  --chain sol \
  --address <token_address> \
  --resolution 1s \
  --from $(date -v-500S +%s) \
  --to $(date +%s)

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

Trending — 通用

# 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

Trending — 按 Launchpad 平台筛选 SOL

使用 --platform 将 Trending 结果筛选为仅包含来自指定 launchpad 的代币。

# 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

Trending — 按 Launchpad 平台筛选 BSC

# 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 — all BSC launchpads, sorted by volume
gmgn-cli market trending \
  --chain bsc --interval 5m \
  --platform fourmeme --platform fourmeme_agent --platform bn_fourmeme --platform four_xmode_agent \
  --platform cubepeg --platform likwid --platform goplus_creator --platform goplus_skills --platform openfour \
  --platform flap --platform flap_stocks --platform flap_aioracle --platform clanker --platform lunafun \
  --order-by volume --limit 50 --raw

# BSC 1h trending — all BSC launchpads with safety filters
gmgn-cli market trending \
  --chain bsc --interval 1h \
  --platform fourmeme --platform fourmeme_agent --platform bn_fourmeme --platform four_xmode_agent \
  --platform cubepeg --platform likwid --platform goplus_creator --platform goplus_skills --platform openfour \
  --platform flap --platform flap_stocks --platform flap_aioracle --platform clanker --platform lunafun \
  --filter not_honeypot --filter verified \
  --order-by volume --limit 20 --raw

Trending — 按 Launchpad 平台筛选 ETH

# ETH 1h trending — all platforms, sorted by volume
gmgn-cli market trending --chain eth --interval 1h --order-by volume --limit 20

# ETH 1h trending — specific platforms only
gmgn-cli market trending \
  --chain eth --interval 1h \
  --platform trench --platform clanker --platform klik \
  --order-by volume --limit 50 --raw

# ETH 1h trending — all ETH platforms with safety filters
gmgn-cli market trending \
  --chain eth --interval 1h \
  --platform trench --platform clanker --platform klik --platform livo --platform stroid \
  --platform pool_uniswap_v2 --platform pool_uniswap_v3 --platform printr \
  --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

Trending — 数值范围筛选

# SOL 1h trending — liquidity 10k–1M, market cap above 50k, sorted by volume
gmgn-cli market trending \
  --chain sol --interval 1h \
  --min-liquidity 10000 --max-liquidity 1000000 --min-marketcap 50000 \
  --order-by volume --limit 30 --raw

# SOL 5m hottest — fresh tokens (under 30 min old) with smart money interest
gmgn-cli market trending \
  --chain sol --interval 5m \
  --max-created 30m --min-smart-degen-count 1 \
  --order-by volume --limit 50 --raw

# SOL 1h trending — exclude high-insider / high-bundler tokens
gmgn-cli market trending \
  --chain sol --interval 1h \
  --max-insider-rate 0.3 --max-bundler-rate 0.3 \
  --order-by volume --limit 20 --raw

Trending — 按 Launchpad 平台筛选 Base

# 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 响应字段

响应为 data.rank——一个排名条目数组。每个条目代表一种代币。

基本信息

字段	描述
address	代币合约地址
symbol / name	代币代码和全名
logo	代币徽标图片 URL
chain	链标识符
total_supply	代币总供应量
creator	创建者钱包地址
launchpad_platform	Launchpad / 池平台（例如 Pump.fun、letsbonk、pool_meteora、fourmeme）
exchange	当前 DEX（例如 meteora_damm_v2、raydium、pump_amm）
open_timestamp	开放市场挂牌时间（Unix 秒）
creation_timestamp	代币创建时间（Unix 秒）
rank	在此 Trending 列表中的位置（数值越小越热门）
hot_level	Trending 热度等级（数值越高越热门）
价格与市场

Field	描述
price	当前价格（美元）
market_cap	市值（美元）（可直接获取，无需计算）
liquidity	当前流动性（美元）
volume	查询时间段内的交易量（美元）
history_highest_market_cap	历史最高市值（美元）
initial_liquidity	代币上线时的初始流动性
price_change_percent	查询时间段内的价格变化百分比
price_change_percent1m	过去 1 分钟的价格变化百分比
price_change_percent5m	过去 5 分钟的价格变化百分比
price_change_percent1h	过去 1 小时的价格变化百分比

交易活动

Field	描述
swaps	查询时间段内的兑换总次数
buys / sells	时间段内的买入 / 卖出次数
holder_count	持有该代币的独立持有人数量
gas_fee	每笔交易的平均 Gas 费

安全与风险

Field	Chains	描述
renounced_mint	SOL	已放弃铸币权限（1 = 是，0 = 否）
renounced_freeze_account	SOL	已放弃冻结权限（1 = 是，0 = 否）
is_honeypot	BSC / Base	貔貅盘标记（1 = 是，0 = 否）
is_open_source	all	合约已验证（1 = 是，0 = 否）
is_renounced	all	已放弃所有权（1 = 是，0 = 否）
buy_tax / sell_tax	all	税率——空字符串表示 0（无税）
burn_status	all	流动性销毁状态（例如 "none"、"burn"）
top_10_holder_rate	all	持仓量排名前 10 的钱包集中度（0–1）
rug_ratio	all	Rug pull 风险评分（0–1）
is_wash_trading	all	是否检测到刷量交易（true / false）
rat_trader_amount_rate	all	内部人士 / 偷跑交易量占比
bundler_rate	all	捆绑机器人交易量占比
entrapment_ratio	all	诱捕交易比例
sniper_count	all	上线时的狙击钱包数量
bot_degen_count / bot_degen_rate	all	Bot degen 钱包数量 / 占比
dev_team_hold_rate	all	开发团队持仓比例
top70_sniper_hold_rate	all	前 70 个狙击钱包的当前持仓比例
lock_percent	all	流动性锁定百分比

开发者状态

Field	描述
creator_token_status	开发者持仓状态：creator_hold（仍在持有）/ creator_close（已卖出 / 平仓）
creator_close	creator_token_status == creator_close 的布尔值简写
dev_token_burn_ratio	开发者代币中已销毁部分的比例

聪明钱

Field	描述
smart_degen_count	持有该代币的聪明钱钱包数量
renowned_count	持有该代币的知名人士 / KOL 钱包数量
bluechip_owner_percentage	持有人中蓝筹钱包的比例（0–1）

社交

Field	描述
twitter_username	Twitter / X 用户名（不是完整 URL——添加 https://x.com/ 前缀即可获取链接）
website	项目网站 URL
telegram	Telegram URL
cto_flag	社区接管标记（1 = 已发生 CTO）

Dexscreener 营销

Field	描述
dexscr_ad	是否投放了 Dexscreener 广告（1 = 是）
dexscr_update_link	是否在 Dexscreener 上更新了社交链接（1 = 是）
dexscr_trending_bar	是否付费登上 Dexscreener 趋势栏（1 = 是）
dexscr_boost_fee	已支付的 Dexscreener 推广金额（0 = 无）

---

工作流：通过趋势榜发现交易机会

发现市场机会的完整工作流：docs/workflow-market-opportunities.md

步骤：获取趋势榜（50 条结果，安全筛选）→ AI 多因素分析（聪明钱、交易量、动能、流动性、成熟度）→ 用表格展示前 5 个并说明理由 → 提供深入分析或替换选项。

当结果中包含值得关注的代币时，继续进行完整的代币尽职调查：docs/workflow-token-research.md

对于新代币 / 发射平台代币（market trenches）：应用结构化的早期项目筛选工作流，其中包括安全检查和聪明钱入场检测 — docs/workflow-early-project-screening.md

对于每日市场概览（用户询问“今天市场怎么样”“给我一份每日简报”“聪明钱今天在买什么”）：结合 market trending + market trenches 与 gmgn-track smartmoney — docs/workflow-daily-brief.md

代币质量筛选标准

评估 market trending 或 market trenches 返回的代币时，应用以下标准，快速区分高质量机会与噪声。不要未经筛选就展示原始结果。

通过 / 观察 / 跳过标准

信号	🟢 通过	🟡 观察	🔴 跳过
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 → 立即跳过
top_10_holder_rate	< 0.20	0.20–0.50	> 0.50
liquidity	> $50k	$10k–$50k	< $10k
has_social（或存在任意社交字段）	有	—	无（仅为弱信号）

快速排除规则： 如果 rug_ratio > 0.3 或 is_wash_trading = true 或 is_honeypot = 1 → 立即跳过，无需进一步分析。

强烈买入信号组合： smart_degen_count ≥ 3 + rug_ratio < 0.2 + creator_close + is_wash_trading = false + liquidity > $50k → 高质量机会，继续进行完整的代币研究。

对这里发现的任何代币进行完整尽职调查：docs/workflow-token-research.md

代币生命周期阶段

使用字段组合判断代币所处的阶段。这会影响信号的解读方式。

阶段 1 — 早期（刚创建）

指标：

• creation_timestamp < 1 小时前
• hot_level 较低或刚开始上升
• smart_degen_count = 0，renowned_count = 0

解读： 现在还太早，无法参考聪明钱信号。没有链上历史记录。风险高，潜在回报也高。行动前等待阶段 2 确认。 只有风险承受能力最强的交易者才会在此阶段入场。

阶段 2 — 突破

指标：

• smart_degen_count ≥ 3 且持续上升
• 交易量激增（比较 swaps_1h 与 swaps_24h / 24 — 前者明显更高）
• price_change_percent1h > 20%
• 此阶段 creator_token_status = creator_hold 可以接受（开发者尚未分发代币）

解读： 最强的入场信号。聪明钱正在积累。行动前核实安全性。这个窗口通常很短 — 根据确认信号行动，而非预判。

阶段 3 — 派发

指标：

• creator_token_status = creator_close（开发者已出售其配额）
• renowned_count 正在买入（滞后的社交信号 — KOL 通常在聪明钱入场后才跟进）
• smart_degen_count 持平或下降
• 交易量仍高，但动能正在减弱

解读： 已到后期阶段才入场。聪明钱可能正在借散户 / KOL 的需求退出。新入场的风险更高。如果已在阶段 2 持仓，请评估退出价位。

阶段 4 — 衰退

指标：

• 所有时间窗口内的交易量均在下降
• holder_count 下降
• rat_trader_amount_rate 偏高（内部人士／暗中交易占主导）
• smart_degen_count = 0 或明显下降

解读： 完全避免新建仓。如果仍持有，可考虑退出。机会很可能已经过去。

market trenches 参数

意图 → --type 映射（始终明确指定 --type）：

用户意图	--type 值
“新代币”“刚上线”“新创建”“最新代币”	new_creation
“即将毕业”“接近完成”“绑定曲线即将填满”	near_completion
“已毕业代币”“已上线 DEX”“公开市场代币”	completed
未提及具体阶段	省略 --type（返回全部三类）

参数	必需	说明
--chain	是	sol / bsc / base / eth / arbitrum / hyperevm / robinhood / arc / stable
--type	否	要查询的类别，可重复：new_creation / near_completion / completed（默认：全部三类）
--launchpad-platform	否	Launchpad 平台筛选条件，可重复。省略时：sol/bsc/base/eth/robinhood 使用服务端固定的默认允许列表；arc/stable 不应用平台筛选。传入值会替换该默认值。
--limit	否	每类的最大结果数，上限为 80（默认：80）
--filter-preset	否	服务端命名筛选预设：safe / smart-money / strict
--sort-by	否	每类的客户端排序字段：smart_degen_count / renowned_count / volume_24h / volume_1h / swaps_24h / swaps_1h / rug_ratio / holder_count / usd_market_cap / created_timestamp
--direction	否	排序方向：asc / desc（默认：desc；rug_ratio 使用 asc）
--min-* / --max-*	否	服务端筛选范围标志 — 参见下方的筛选字段参考

各链的 --launchpad-platform 值（在 sol/bsc/base/eth/robinhood 上，省略该标志时使用服务端默认允许列表，而非所有平台）：

链	平台
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 / ray_launchpad / meteora_virtual_curve / xstocks
bsc	fourmeme / fourmeme_agent / bn_fourmeme / four_xmode_agent / cubepeg / likwid / goplus_creator / goplus_skills / openfour / flap / flap_stocks / flap_aioracle / clanker / lunafun
base	clanker / bankr / flaunch / zora / zora_creator / baseapp / basememe / virtuals_v2 / klik
eth	trench / clanker / klik / livo / stroid / pool_uniswap_v2 / pool_uniswap_v3 / printr
arc	dyorfun_v3 / dyorswap / trench / onmifun / sharcfun / klik
stable	dyorfun_v3 / dyorswap / trench

筛选预设

预设在服务端应用：API 会在返回结果前筛选代币。

预设	应用的服务端筛选条件
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

预设与显式标志的交互： 显式筛选标志始终会覆盖预设值。例如，--filter-preset safe --max-rug-ratio 0.1 会应用 safe 预设，但将 rug_ratio 阈值覆盖为 0.1。

所有筛选标志都会作为 API 请求正文的一部分发送（在服务端处理）——服务器会在返回结果前筛选代币。使用 --limit 80（默认最大值）可最大限度扩大候选范围。

响应字段：data.new_creation、data.pump、data.completed——每个字段都是一个 RankItem 数组（字段与 market trending 排名项相同）。重要：响应中的 data.pump 对应请求中的 --type near_completion。API 始终使用键 pump 返回此类别，而不是 near_completion。

服务端筛选字段

所有筛选标志都作为 API 请求正文的一部分发送——服务器会在返回结果前筛选代币。标志遵循 --min-{field} / --max-{field} 的命名约定。

标志对	类型	描述
--min-volume-24h / --max-volume-24h	float	24 小时交易量（USD）
--min-net-buy-24h / --max-net-buy-24h	float	24 小时净买入量（USD）
--min-swaps-24h / --max-swaps-24h	int	24 小时总交换次数
--min-buys-24h / --max-buys-24h	int	24 小时买入次数
--min-sells-24h / --max-sells-24h	int	24 小时卖出次数
--min-visiting-count / --max-visiting-count	int	访问者数量
--min-progress / --max-progress	float	联合曲线进度（0–1）
--min-marketcap / --max-marketcap	float	市值（USD）
--min-liquidity / --max-liquidity	float	流动性（USD）
--min-created / --max-created	duration	代币年龄——建议使用单位后缀：秒（30s、10s）或分钟（0.5m、1m、5m、30m）。不带单位的数字（例如 5）会被视为分钟，并显示警告。
--min-holder-count / --max-holder-count	int	持有者数量
--min-top-holder-rate / --max-top-holder-rate	float	前 10 名持有者集中度（0–1）
--min-rug-ratio / --max-rug-ratio	float	Rug pull 风险评分（0–1）
--min-bundler-rate / --max-bundler-rate	float	捆绑机器人交易比例（0–1）
--min-insider-ratio / --max-insider-ratio	float	内幕交易比例（0–1）
--min-entrapment-ratio / --max-entrapment-ratio	float	诱骗/钓鱼交易比例（0–1）
--min-private-vault-hold-rate / --max-private-vault-hold-rate	float	私人金库持有比例（0–1）
--min-top70-sniper-hold-rate / --max-top70-sniper-hold-rate	float	前 70 名狙击者持有比例（0–1）
--min-bot-count / --max-bot-count	int	机器人钱包数量
--min-bot-degen-rate / --max-bot-degen-rate	float	机器人投机钱包比例（0–1）
--min-fresh-wallet-rate / --max-fresh-wallet-rate	float	新钱包比例（0–1）
--min-total-fee / --max-total-fee	float	总费用
--min-smart-degen-count / --max-smart-degen-count	int	聪明资金持有者数量
--min-renowned-count / --max-renowned-count	int	KOL / 知名钱包数量
--min-creator-balance-rate / --max-creator-balance-rate	float	创建者持有比例（0–1）
--min-creator-created-count / --max-creator-created-count	int	创建者创建代币总数
--min-creator-created-open-count / --max-creator-created-open-count	int	创建者已毕业代币数量
--min-creator-created-open-ratio / --max-creator-created-open-ratio	float	创建者毕业比例（0–1）
--min-x-follower / --max-x-follower	int	Twitter / X 粉丝数量
--min-twitter-rename-count / --max-twitter-rename-count	int	Twitter 改名次数
--min-tg-call-count / --max-tg-call-count	int	Telegram 调用次数

Trenches 筛选示例

# 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 响应字段

基本信息

字段	描述
address	代币合约地址
symbol / name	代币符号和名称
launchpad_platform	发射平台（例如 Pump.fun、letsbonk）
exchange	当前交易所（例如 pump_amm、raydium）
usd_market_cap	以美元计价的市值
liquidity	以美元计价的流动性
total_supply	代币总供应量
created_timestamp	创建时间（Unix 秒）
open_timestamp	开放市场交易时间（Unix 秒，仅适用于 completed）
complete_timestamp	联合曲线完成时间（Unix 秒）
complete_cost_time	从创建到完成所需的时间（秒）

交易数据

字段	描述
swaps_1m / swaps_1h / swaps_24h	每个时间段内的兑换次数
volume_1h / volume_24h	以美元计价的交易量
buys_24h / sells_24h	24 小时内的买入 / 卖出次数
net_buy_24h	24 小时内的净买入量
holder_count	代币持有者数量

安全与风险

字段	链	描述
renounced_mint	SOL	是否已放弃铸币权限（SOL 特有概念；在 EVM 链上始终为 false）
renounced_freeze_account	SOL	是否已放弃冻结权限（SOL 特有概念；在 EVM 链上始终为 false）
burn_status	all	流动性销毁状态
rug_ratio	all	Rug pull 风险比例
top_10_holder_rate	all	前 10 名持有者的集中度比例
rat_trader_amount_rate	all	内幕 / 偷偷交易量比例
bundler_trader_amount_rate	all	捆绑交易量比例
is_wash_trading	all	是否检测到洗售交易
sniper_count	all	狙击钱包数量
suspected_insider_hold_rate	all	疑似内幕人士持有比例
open_source	all	合约源代码是否已验证（"yes" / "no" / "unknown"）
owner_renounced	all	是否已放弃合约所有权（"yes" / "no" / "unknown"）
is_honeypot	BSC / Base	代币是否为蜜罐（"yes" / "no"）；在 SOL 上返回空字符串（不适用）
buy_tax	all	买入税比例（例如 0.03 = 3%）
dev_team_hold_rate	all	开发团队持有比例

开发者持仓

字段	描述
creator_token_status	开发者持仓状态（例如 creator_hold、creator_close）
creator_balance_rate	开发者持有量占总供应量的比例

聪明钱

字段	描述
smart_degen_count	聪明钱持有者数量
renowned_count	知名钱包持有者（KOL）数量

社交媒体

字段	描述
twitter	Twitter / X 链接
telegram	Telegram 链接
website	网站链接
instagram	Instagram 链接
tiktok	TikTok 链接
has_at_least_one_social	是否存在至少一个社交媒体链接
x_user_follower	Twitter 粉丝数
cto_flag	是否发生社区接管（CTO）

Dexscreener 营销

字段	描述
dexscr_ad	是否投放了 Dexscreener 广告
dexscr_update_link	是否已在 Dexscreener 上更新社交链接
dexscr_trending_bar	是否付费登上 Dexscreener 趋势栏
dexscr_boost_fee	Dexscreener 推广费用（0 = 无）

获取 trenches 结果后，请先应用“代币质量筛选标准”部分，再向用户展示代币。不要直接输出原始结果——先筛选，再呈现最优候选项。

Trenches 筛选示例

# 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

Solana Trenches 示例

# 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

BSC Trenches 示例

# 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 cubepeg --launchpad-platform likwid --launchpad-platform goplus_creator --launchpad-platform goplus_skills --launchpad-platform openfour \
  --launchpad-platform flap --launchpad-platform flap_stocks --launchpad-platform flap_aioracle --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 cubepeg --launchpad-platform likwid --launchpad-platform goplus_creator --launchpad-platform goplus_skills --launchpad-platform openfour \
  --launchpad-platform flap --launchpad-platform flap_stocks --launchpad-platform flap_aioracle --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 cubepeg --launchpad-platform likwid --launchpad-platform goplus_creator --launchpad-platform goplus_skills --launchpad-platform openfour \
  --launchpad-platform flap --launchpad-platform flap_stocks --launchpad-platform flap_aioracle --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 cubepeg --launchpad-platform likwid --launchpad-platform goplus_creator --launchpad-platform goplus_skills --launchpad-platform openfour \
  --launchpad-platform flap --launchpad-platform flap_stocks --launchpad-platform flap_aioracle --launchpad-platform clanker --launchpad-platform lunafun \
  --limit 80

Base Trenches 示例

# 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

ETH Trenches 示例

# All three categories at once
gmgn-cli market trenches --chain eth --raw \
  --type new_creation --type near_completion --type completed \
  --launchpad-platform trench --launchpad-platform clanker --launchpad-platform klik --launchpad-platform livo --launchpad-platform stroid --launchpad-platform pool_uniswap_v2 --launchpad-platform pool_uniswap_v3 --launchpad-platform printr \
  --limit 80

# New creation only
gmgn-cli market trenches --chain eth --raw \
  --type new_creation \
  --launchpad-platform trench --launchpad-platform clanker --launchpad-platform klik --launchpad-platform livo --launchpad-platform stroid --launchpad-platform pool_uniswap_v2 --launchpad-platform pool_uniswap_v3 --launchpad-platform printr \
  --limit 80

# Completed (open market) only
gmgn-cli market trenches --chain eth --raw \
  --type completed \
  --launchpad-platform trench --launchpad-platform clanker --launchpad-platform klik --launchpad-platform livo --launchpad-platform stroid --launchpad-platform pool_uniswap_v2 --launchpad-platform pool_uniswap_v3 --launchpad-platform printr \
  --limit 80

Arc Trenches 示例

# All three categories at once
gmgn-cli market trenches --chain arc --raw \
  --type new_creation --type near_completion --type completed \
  --launchpad-platform dyorfun_v3 --launchpad-platform dyorswap --launchpad-platform trench --launchpad-platform onmifun --launchpad-platform sharcfun --launchpad-platform klik \
  --limit 80

# New creation only
gmgn-cli market trenches --chain arc --raw \
  --type new_creation \
  --launchpad-platform dyorfun_v3 --launchpad-platform dyorswap --launchpad-platform trench --launchpad-platform onmifun --launchpad-platform sharcfun --launchpad-platform klik \
  --limit 80

# Near completion only
gmgn-cli market trenches --chain arc --raw \
  --type near_completion \
  --launchpad-platform dyorfun_v3 --launchpad-platform dyorswap --launchpad-platform trench --launchpad-platform onmifun --launchpad-platform sharcfun --launchpad-platform klik \
  --limit 80

# Completed (open market) only
gmgn-cli market trenches --chain arc --raw \
  --type completed \
  --launchpad-platform dyorfun_v3 --launchpad-platform dyorswap --launchpad-platform trench --launchpad-platform onmifun --launchpad-platform sharcfun --launchpad-platform klik \
  --limit 80

Stable Trenches 示例

# All three categories at once
gmgn-cli market trenches --chain stable --raw \
  --type new_creation --type near_completion --type completed \
  --launchpad-platform dyorfun_v3 --launchpad-platform dyorswap --launchpad-platform trench \
  --limit 80

# New creation only
gmgn-cli market trenches --chain stable --raw \
  --type new_creation \
  --launchpad-platform dyorfun_v3 --launchpad-platform dyorswap --launchpad-platform trench \
  --limit 80

# Near completion only
gmgn-cli market trenches --chain stable --raw \
  --type near_completion \
  --launchpad-platform dyorfun_v3 --launchpad-platform dyorswap --launchpad-platform trench \
  --limit 80

# Completed (open market) only
gmgn-cli market trenches --chain stable --raw \
  --type completed \
  --launchpad-platform dyorfun_v3 --launchpad-platform dyorswap --launchpad-platform trench \
  --limit 80

输出格式

market kline — 价格摘要

获取 K 线后，提供简要的价格分析。不要直接输出原始 K 线数组。

{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 — 热门代币榜单

将热门结果（默认为前 10 个，也可按要求调整）以表格形式呈现：

# | Symbol | Price | MCap | Volume ({interval}) | 1h Chg | SM | Liq | Platform | Signal

其中 Signal = 根据代币数据得出的质量标记：

• 🟢 通过：smart_degen_count ≥ 3 且 rug_ratio < 0.2 且 is_wash_trading = false
• 🔴 跳过：rug_ratio > 0.3 或 is_wash_trading = true 或 is_honeypot = 1
• 🟡 关注：其他情况

然后为任何值得关注的代币提供一句话亮点（例如：“TOKEN1 有 12 个聪明资金持有者，且 1 小时内上涨 +85%——🟢 强信号”）。

market trenches — 按类别分组

为每个类别分别添加标题：

🆕 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 参数

仅支持以下链：sol / bsc / robinhood / arc / stable。每组最多 50 个结果——可通过 --groups 使用多个分组，在单个请求中涵盖不同信号类型。

单组（单独的标志）：

请勿在 signal_type / --signal-type / --groups JSON 中传入信号类型 14、15 或 16——如果任一分组包含这些类型，OpenAPI 会返回 400。省略 --signal-type 时，会查询所有受支持的类型：1–13 和 17–21。

选项	必填	说明
--chain	是	sol / bsc / robinhood / arc / stable
--signal-type	否	信号类型，可重复指定：1–13、17–21；默认值：所有受支持的类型。请参阅下方的信号类型。
--mc-min	否	触发时的最低市值（USD）
--mc-max	否	触发时的最高市值（USD）
--trigger-mc-min	否	信号触发时的最低市值（USD）
--trigger-mc-max	否	信号触发时的最高市值（USD）
--total-fee-min	否	已支付的最低总费用（USD）
--total-fee-max	否	已支付的最高总费用（USD）
--min-create-or-open-ts	否	代币创建或开放时间的最早时间戳（Unix 秒数字符串）
--max-create-or-open-ts	否	代币创建或开放时间的最晚时间戳（Unix 秒数字符串）

多组覆盖：

传入 --groups '<json_array>'，即可在单个请求中查询多个筛选分组。上游会并行执行所有分组，并按 trigger_at 降序合并结果。存在 --groups 时，以上所有单独的标志均会被忽略。

gmgn-cli market signal --chain sol \
  --groups '[{"signal_type":[12,13]},{"signal_type":[6,7],"mc_min":50000}]'

信号类型

值	名称	说明
1	SignalType1	通用信号（K 线价格飙升）
2	SignalTypeDexAd	Dex 广告投放
3	SignalTypeDexUpdateLink	Dex 社交链接已更新
4	SignalTypeDexTrendingBar	Dex 热门榜
5	SignalTypeDexBoost	Dex Boost
6	SignalTypePriceUp	价格飙升
7	SignalTypePriceATH	历史最高价
8	SignalTypeMcpKeyLevel	市值关键水平
9	SignalTypeLive	直播
10	SignalTypeBundlerSell	打包器卖出
11	SignalTypeCto	社区接管（CTO）
12	SignalTypeSmartDegenBuy	聪明资金买入
13	SignalTypePlatformCall	平台呼叫
14	SignalTypeLargeAmountBuy	大额买入
15	SignalTypeMultiBuy	多笔买入
16	SignalTypeMultiLargeBuy	多笔大额买入
17	SignalTypeBagsClaims	Bags 领取
18	SignalTypePumpClaims	Pump 领取
19	SignalTypePlatformCallV2	平台呼叫（V2）
20	SignalTypeKOLBuy	KOL 买入
21	SignalTypeBankerClaims	Banker 领取（Base 链 Banker 平台领取费用）

market signal 响应字段

响应数组中的每一项都是一个信号事件：

字段	类型	描述
id	string	信号事件 ID
token_address	string	代币合约地址
signal_type	number	信号类型（1–21，参见上方的信号类型）
trigger_at	number	信号触发时的 Unix 时间戳（秒）
trigger_mc	number	信号触发时的市值（USD）
first_trigger_mc	number	此代币首次触发时的市值（USD）
market_cap	number	当前市值（USD）
ath	number	历史最高市值（USD）
signal_times	number	此信号对该代币触发的总次数
signal_times_by_type	object	按类型细分的信号触发次数
cur_data	object	查询时的代币实时统计数据（见下文）
data	object	触发时的完整上游快照（因链而异，原始透传）

cur_data 字段：

字段	类型	描述
top_10_holder_rate	number	前 10 名持有者集中度（0–1）
holder_count	number	当前持有者数量
liquidity	number	当前流动性（USD）

使用示例

# All supported signal types on SOL (no --signal-type)
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 hot-searches 参数

返回热搜排名——按 visiting_count（搜索热度）排序，显示用户当前搜索最多的代币。跨链前 500 名排名；一次请求即可覆盖多个链。用于查询“搜索量最高的代币”“热搜列表”“热搜榜”“大家都在关注什么”——这不同于按交易活动排名的 market trending，后者回答的是“哪些代币的交易最活跃”。

选项	描述
--chain <chain...>	可重复指定。sol / bsc / base / eth / arbitrum / hyperevm / robinhood / arc / stable。省略时查询默认的 9 链集合（每条链使用 24h 和适合该链的安全过滤条件）。
--interval <interval>	1m / 5m / 1h / 6h / 24h（默认 24h）。应用于提供的每个 --chain。
--limit <n>	每条链的结果上限（默认 500）。
--filter <tag...>	可重复指定的布尔过滤标签（下游的 filter.filters 数组）。**⚠️ SOL 默认值：renounced frozen；EVM 默认值：not_honeypot verified renounced。**省略 --filter 并不表示“不过滤”——服务端会应用链默认值。确切的标签词汇请参见下方的过滤标签表。
--min-* / --max-* <n>	数值范围边界，指标名称与 market trending 相同（例如 --min-liquidity、--max-marketcap、--min-smart-degen-count）。服务端会根据 --interval 转换。--min-created / --max-created 表示代币存续时长。请参见下方的范围过滤器表。
--params <json>	完全覆盖：JSON 参数对象数组。提供此项时，会忽略 --chain / --interval / --limit / --filter 及所有范围标志。过滤字段会直接展开到每个参数中（不使用嵌套的 filter 对象）：{ "label": "...", "chain": "...", "interval": "...", "filters": [...], "limit": 500, "min_liquidity": 1000 }——参数支持 filters、limit、min_created / max_created 以及排名样式的 min_<metric> / max_<metric> 键。

market hot-searches 筛选标签（--filter / filter.filters）

下游（gmgn 排名筛选服务）会将每个标签作为 AND 条件进行评估——代币必须通过所有标签才能留在列表中。未知标签会被静默接受，但不会产生任何作用（直接放行），因此无法识别的标签不会筛选任何内容——拼写很重要。这组标签是筛选服务的词汇表，与 market trending 的标签名称略有不同（见下方别名说明）。

仅以下标签可识别（其他任何标签都不会产生作用）：

标签	链	通过条件
renounced	sol / EVM	sol：已放弃铸币权限（renounced_mint == 1）；EVM：已放弃所有权（is_renounced == 1；宽松判定——nil 也通过）
frozen	仅 sol	已放弃冻结权限（renounced_freeze_account == 1）；非 sol 始终不通过
is_burnt	所有	LP 池已销毁（burn_status == "burn"）
token_burnt	所有	创建者已销毁代币（dev_token_burn_ratio > 0）
not_wash_trading	所有	未被标记为洗盘交易
not_honeypot	EVM	不是蜜罐（is_honeypot == 0；宽松判定——nil 也通过）
verified	EVM	合约已开源（is_open_source == 1；宽松判定——nil 也通过）
locked	EVM	流动性锁定比例 ≥ 50%（lock_percent >= 0.5）
has_social	所有	有 Twitter、Telegram 或 Website
distribed	所有	前 10 大持有者占比在 (0, 0.3] 范围内（分布良好）
not_risk	所有	综合低风险筛选（sol：流动性≥4000 + 已放弃铸币权限 + 前 10 大持有者占比<0.3 + 已放弃冻结权限 + LP 已销毁；EVM：不是蜜罐 + 流动性≥4000 + 已开源 + 已放弃所有权 + 锁定比例≥0.5）
img_not_duplicate	所有	头像图片未重复（image_dup == "0"）
social_not_duplicate	所有	社交链接未被共用（twitter_dup == 0 && telegram_dup == 0 && website_dup == 0）
creator_hold	所有	开发者仍持有代币（不是 creator_close）
creator_close	所有	开发者已卖出／关闭（creator_token_status == "creator_close"）
dexscr_update_link	所有	已在 DexScreener 更新社交链接（> 0）
launching	所有	仍处于 Launchpad 联合曲线上（launchpad_status == "0"）；与 migrated 搭配可同时允许两种状态
migrated	所有	已毕业／迁移至 DEX（launchpad_status == "1"）；与 launching 搭配可同时允许两种状态
hide_b20	仅 base	代币标准不是 b20（非 base 链上不会产生作用）
hide_non_b20	仅 base	代币标准是 b20（非 base 链上不会产生作用）

⚠️ 名称与 market trending 不同。 此路径使用 launching / migrated（而非 is_internal_market / is_out_market），以及 img_not_duplicate / social_not_duplicate（而非 not_image_dup / not_social_dup）。market trending 支持但此端点无法识别的标签（在此处会被静默忽略）：dexscr_ad、dexscr_trending_bar、dexscr_boost、cto_flag、is_internal_market、is_out_market、not_image_dup、not_social_dup。

market hot-searches 范围筛选条件（--min-* / --max-*）

数值上下限使用与 market trending 相同的排名式指标名称。这些值会在每个参数中以扁平形式发送，然后在服务端转换为该参数 --interval 对应的下游字段。区间为闭区间；下游无法读取的指标会被丢弃（并非在传输中无声地不起作用——它们会在请求发出前被移除）。

标志对	类型	指标
--min-volume / --max-volume	float	交易量（USD）——以 --interval 时间窗口为准
--min-swaps / --max-swaps	int	交换次数——以 --interval 时间窗口为准
--min-price-change-percent / --max-price-change-percent	float	价格变动比例——仅适用于 1m / 5m / 1h；6h / 24h 时会被丢弃
--min-liquidity / --max-liquidity	float	流动性（USD）
--min-marketcap / --max-marketcap	float	市值（USD）
--min-history-highest-marketcap / --max-history-highest-marketcap	float	历史最高市值（USD）
--min-holder-count / --max-holder-count	int	持有者数量
--min-gas-fee / --max-gas-fee	float	Gas 费
--min-renowned-count / --max-renowned-count	int	KOL / 知名持有者数量
--min-smart-degen-count / --max-smart-degen-count	int	聪明钱持有者数量
--min-bot-degen-count / --max-bot-degen-count	int	Bot degen 钱包数量
--min-visiting-count / --max-visiting-count	int	访客数量
--min-insider-rate / --max-insider-rate	float	内幕交易比例（0–1）；缺少此字段的代币会被排除
--min-bundler-rate / --max-bundler-rate	float	捆绑机器人交易比例（0–1）；缺少此字段的代币会被排除
--min-entrapment-ratio / --max-entrapment-ratio	float	陷阱交易比例（0–1）；缺少此字段的代币会被排除
--min-top10-holder-rate / --max-top10-holder-rate	float	前 10 大持有者集中度（0–1）
--min-top70-sniper-hold-rate / --max-top70-sniper-hold-rate	float	前 70 名狙击者持有比例（0–1）
--min-dev-team-hold-rate / --max-dev-team-hold-rate	float	开发团队持有比例（0–1）
--min-created / --max-created	duration	代币年龄范围（30m / 6h / 7d）。min_created = 最小年龄；max_created = 最大年龄

行为说明：

• --chain all 无效。如需汇总多个链，请多次传入 --chain（或省略 --chain，以使用默认的 9 链集合）。
• 传入 --chain 但省略 --filter 时，服务端会应用对应链的默认筛选条件，因此即使未显式指定 --filter，每条链也都会经过筛选。
• 不同链返回的数量不同：某条链的代币数量取决于其中有多少代币进入了全局前 500 名（sol 通常最多）。

market hot-searches 响应字段

响应中的 data 是一个数组。每个元素是一个 (interval, chain) 结果块：

字段	类型	描述
interval	字符串	此结果块的时间间隔
chain	字符串	此结果块所属的链
version	字符串	订阅版本 — WebSocket 重新连接时请保存此值
tokens	数组	按搜索热度降序排列的代币，最多 500 个。每个代币带有从 1 开始的 rank

代币字段与 market trending 的长格式字段相同 — 服务端会为你映射上游简写代码，因此可以直接读取 visiting_count / market_cap / symbol（而不是 v_c / mc / s）。关键字段：

字段	描述
address	代币合约地址
chain	链
name / symbol	代币名称 / 代币代码
price	当前价格（USD）
visiting_count	主要排名依据 — 搜索 / 访问热度
market_cap	市值（USD）
volume	此时间间隔内的交易量（USD）
liquidity	流动性（USD）
swaps / buys / sells	兑换 / 买入 / 卖出次数
holder_count	持有者数量
rank	此结果块内从 1 开始的位置

完整字段集请参阅上文的 market trending 响应字段部分 — hot-searches 代币使用相同的 RankItem 结构。

market hot-searches 用法示例

# Default 9-chain hot-search ranking (sol/bsc/base/eth/arbitrum/hyperevm/robinhood/arc/stable, each 24h)
gmgn-cli market hot-searches --raw

# SOL only, 24h hot-search list
gmgn-cli market hot-searches --chain sol --interval 24h --raw

# SOL + BSC + Base, 1h window, top 50 per chain
gmgn-cli market hot-searches --chain sol --chain bsc --chain base --interval 1h --limit 50 --raw

# SOL with custom boolean filters
gmgn-cli market hot-searches --chain sol --interval 24h \
  --filter renounced --filter frozen --raw

# SOL 1h hot-searches with numeric range filters (same metric names as `market trending`)
gmgn-cli market hot-searches --chain sol --interval 1h \
  --min-liquidity 10000 --min-volume 5000 --min-smart-degen-count 1 --raw

# Range filter by token age + market cap
gmgn-cli market hot-searches --chain sol --interval 24h \
  --max-created 7d --min-marketcap 50000 --raw

# Full per-param override via JSON (different filters per chain, incl. ranges)
gmgn-cli market hot-searches --raw --params '[
  {"label":"hot-search","chain":"sol","interval":"24h","filters":["renounced","frozen"],"limit":500,"min_liquidity":10000},
  {"label":"hot-search","chain":"bsc","interval":"24h","filters":["not_honeypot","verified","renounced"],"limit":500}
]'

market hot-searches — 输出格式

按链分别展示，并按 visiting_count（搜索热度）排序：

🔥 Hot Searches — {chain} ({interval})
# | Symbol | Price | MCap | Volume | Search Heat (visiting_count) | Liq

---

market search 参数

查找用户指定的特定代币或钱包 — 可按代币名称、代币代码、合约地址、钱包地址或 ENS 查找。单次请求会同时返回匹配的代币（coins）和钱包（wallets）。用户提供了明确的查找目标时使用此命令；用户想浏览排行榜时则使用 market trending / market hot-searches。

参数	必填	描述
--query / -q	是	搜索关键词 — 代币名称、代币代码、合约地址、钱包地址或 ENS。移除不可见字符 / 控制字符后，必须为 1–100 个 Unicode 字符。
--chain	否	将结果限定在一条链上。省略时搜索所有链。接受 all 和任何已启用的链（参阅支持的链 — 包括 9 条核心链以及动态启用的链，例如 tron / monad / megaeth / xlayer / hyperevm）。
--launchpad-platform	否	精确筛选 launchpad 平台，可重复指定，最多 50 个值（例如 pump / moonshot / raydium / pinksale）。仅筛选 coins — 不影响 wallets。
--is-og	否	true = 仅 OG 代币；false = 仅非 OG 代币。省略时不筛选 OG。仅适用于代币。
--is-launched	否	true = 仅已上线（已开放市场交易）的代币；false 或省略时不进行上线状态筛选。仅适用于代币。
--order-by	否	仅接受 weight — 按加权相关性分数降序排列 coins，并剔除蜜罐代币。仅适用于代币。

行为说明：

• --launchpad-platform、--is-og、--is-launched 和 --order-by 仅影响 coins 列表。wallets 列表不会受到这些标志的影响。
• wallets 结果最多为 50 个。
• 响应结构会原样透传下游 search_v3 API 的全部新增字段，并且返回前会对所有字符串字段进行元数据清理。可能会在不另行通知的情况下出现新字段 — 不要假定字段集合固定；遇到不熟悉的字段时应先查询，而不是猜测。

market search 响应字段

data 包含两个数组：coins（匹配的代币）和 wallets（匹配的钱包）。

coins[] — 匹配的代币

Field	Description
chain	链标识符
address	代币合约地址
name / symbol	代币名称 / 代币代码
price	当前美元价格（字符串）
mcp	美元市值（字符串）——注意短键 mcp，不是 market_cap
holder_count	代币持有者数量

可能还会包含其他代币字段（从 search_v3 额外透传）。

wallets[] — 匹配的钱包

Field	Description
chain	链标识符
address	钱包地址
twitter_username	关联的 Twitter / X 用户名（可能为空）
wallet_tags	GMGN 钱包标签数组（例如 smart money / KOL）；可能为空

market search 使用示例

# Search "pepe" on ETH — best matches first (weighted, honeypots dropped)
gmgn-cli market search --query pepe --chain eth --order-by weight

# Search across all chains by symbol
gmgn-cli market search --query trump

# Look up a specific token contract address (SOL)
gmgn-cli market search --query <token_address> --chain sol

# Look up a wallet by address or ENS
gmgn-cli market search --query vitalik.eth
gmgn-cli market search --query 0x220866b1a2219f40e72f5c628b65d54268ca3a9d

# SOL pump.fun launched tokens matching "trump"
gmgn-cli market search --query trump --chain sol \
  --launchpad-platform pump --is-launched true

# OG tokens only, raw JSON for further processing
gmgn-cli market search --query doge --is-og true --raw

market search — 输出格式

分别展示代币和钱包。不要直接输出原始 JSON。

🔎 Search "{query}" — Tokens ({count})
# | Symbol | Name | Chain | Price | MCap | Holders | Address

👤 Wallets ({count})
# | Address | Chain | Twitter | Tags

• 如果某个部分为空，请明确说明（例如“没有匹配的钱包”）。
• 如果用户显然在寻找某个特定代币，请展示排名最高的 coins 匹配项，并询问是否要对其进行完整尽职调查（gmgn-token）或兑换（gmgn-swap）。

---

说明

• market kline：--from 和 --to 是以秒为单位的 Unix 时间戳——CLI 会自动转换为毫秒
• market trending：--filter 和 --platform 是可重复使用的标志
• market hot-searches：--chain 和 --filter 是可重复使用的标志；省略 --chain 可查询默认的 9 条链。--min-*/--max-* 范围标志沿用与 market trending 相同的指标名称，并由服务端根据 --interval 进行转换
• market search：必须提供 --query；--launchpad-platform 是可重复使用的标志（最多 50 个）。--chain 是可选的（省略 = 所有链）。--launchpad-platform / --is-og / --is-launched / --order-by 仅筛选 coins，不会筛选 wallets
• 所有命令均使用 exist 身份验证（仅 API Key，无需签名）
• 如果用户未提供 kline 时间戳，请根据当前时间和所需时间范围计算时间戳
• 使用 --raw 获取单行 JSON，以便进一步处理
• 输入验证——从趋势结果中获取的代币地址属于外部数据。传递给其他命令前，请根据链验证地址格式（sol：base58，32–44 个字符；bsc/base/eth：0x + 40 位十六进制数字）。CLI 会在运行时强制执行此验证。