gmgn-skills/skills/gmgn-token-buy/references/pitfalls.md

常见错误

每一条都是实测踩过的。Step 1 之前先读一遍——这些不是风格建议，是会让用户买错币或多付几个数量级手续费的错。

market search 不可用时用榜单命令代替。 market hot-searches / market trending / market trenches 是按热度或涨幅排的榜单，不是名称检索；用它们按名字找币会优先撞上正在被炒的仿盘。搜索命令缺失时硬停，见 SKILL.md 第 1 步。

• 搜到第一个结果就当成目标币 —— 必须做消歧，且先剔除符号与名称都不匹配的模糊命中。
• 只按质量分排同名候选 —— 仿盘和正主的质量分可能只差 2 倍，把存续时长算进相关性才分得开（但年龄绝不能进闸口）。
• 用发现阶段的残缺数字直接定名次 —— 搜索返回的是单池视角，正主可能只被搜到一个小池；给排名靠前的候选拉 GMGN token/info 权威深度后必须重排一次，别让粗排结果定生死。
• 把"只有一个源看到"当成数值不可信 —— 两个源的池子覆盖面本来就不同；V3 区间外的单边池是正常形态，深度是实测值。
• 只信一个搜索源就下结论 —— 同一查询两次的结果集合会变，用户要找的币可能整个不出现。
• 只按流动池大小选合约 —— 会被虚假流动性池骗过，必须同时看成交额、市值与持有人数。
• 把市值最大的直接当正主 —— 市值同样会被拉盘伪造，必须与成交额、池深、持有人数互相印证。
• 把行情源报的挂单额当成能吃到的流动性 —— 单边池会把 $9.63 的可交易深度报成 $36,963,124，也存在单源虚高 4900 倍的池子。
• 把"合约里有增发/冻结函数"直接当红旗 —— 权限已放弃时这些是死代码。
• 把"LP 没锁"直接当不通过 —— 要看分布。PEPE、SHIB 的 LP 一个都没锁，但没有任何地址能独自撤池；判不通过的是"单一外部地址持大半 LP 且未锁"。
• 把集中流动性池的"查不到锁仓"当成数据缺失 —— 它是不适用，严格模式不该因此拦。
• 算锁仓比例时把 NFT 仓位算进 LP 持有人 —— 分母是错的，安全接口的 lp_holders 把两种混在一起，而且最多只给 10 条。
• 缺独立买家数就把交易量闸判废 —— 它是旁证，主判据是量/池比。
• 拿"深池不可能高换手"当刷量依据 —— 实测龙头币真能做到 ~10 倍，真正的刷量假池是 6000 倍量级。
• 给每个同名候选各打一次 token info —— market search 一次就带回全部候选的池子/量/笔数/持有人/存续时长，够排序和粗筛了；几十个候选各打一次会撞限流，也没有任何额外信息。
• 密集连打 GMGN 接口触发限流 —— 官方漏桶 20 次/秒，单币尽调固定 4 个请求碰不到；被限（429）时读 reset_at 等到解封再试，期间绝不重试（每重试一次封禁延长 5 秒）。
• 把"安全检测接口没返回红旗"当成"安全"—— 要区分"检测通过"和"没检测到数据"。
• 用固定滑点 —— 小池子高税率的币会因此被夹或失败。
• 把 gas 档位当成一个数 —— 手续费与优先费是两笔，必须分开列；Solana 开防夹还有第三笔贿赂。
• 拿 EVM 的算法算 Solana 的 gas —— EVM 档位要乘 gas 用量，Solana/Tron 档位本身就是币量，混用会差几个数量级。
• gas 接口拿不到数据就自己估一个 —— 报"需手填"，不要编。
• 因为一条链没有安全检测源就当它安全 —— 无源即不通过。
• 筛选不过还继续给买入建议 —— 门槛是硬的。
• 未确认就把订单交给 gmgn-swap —— 绝不允许。
• 本技能自己去签名下单 —— 越权，执行只走 gmgn-swap。
• 只看成交额大小就放过方向 —— 24h $63M、1h 32,446 笔的币可以同时正在 5 分钟内跌 16.5%，四个窗口卖压全部大于买盘。量的大小和量的方向是两道闸，必须都过。
• 只读 24h 净流向 —— 累计量会把早期买盘和后期卖压对冲掉，要逐窗口读 5m / 1h / 24h，三个都为负才是持续卖压。
• 把 price_5m 当成涨跌幅 —— 它是 5 分钟前的价格，涨跌幅要自己算 price / price_5m − 1。
• 用不含波动项的滑点公式 —— 池深 $1.69M、零税的币算出 2.0% 滑点，而它 5 分钟动了 16.5%，市价单必然失败。
• 只把老鼠仓当交易者画像 —— 诱捕交易者、机器人占比、捆绑钱包三项都在同一份响应里，实测分别 55.57% / 76.78% / 8.5%，全漏计的结果是这个币只命中 1 项警告、通过了安全闸。
• 拿 wallet_tags_stat.bundler_wallets 当百分比 —— 它是钱包个数（971），要除以 holder_count（11,423）才是占比。
• 拿 dev.top_10_holder_rate 当开发者持仓 —— 开发者持仓读 stat.creator_hold_rate。
• lock_percent = 0 就判「没锁」 —— 实测同一个响应里 lock_detail[0] 是 95% 打进黑洞。销毁不一定被算进 lock_percent，要读 lock_detail。
• EVM 的 gas 用量自己编一个不标注的数 —— 按 pool.exchange 取默认值（v2 150K / v3 180K / v4 200K / 未知 200K），并在卡里写明「按 N 估算」。这是订单卡里唯一一个不来自字段的数，必须标出来。