Agent skill · gmgnai
gmgn-token-buy
Turn a token name into a vetted, sized buy order. Two things here are exclusive to this skill: resolving a NAME or symbol to the one right contract among its copycats, and sizing an order — amount, slippage, gas, position. No sibling does either. USE THIS SKILL WHEN a buy is being prepared, which shows up as a NAME or symbol, or an AMOUNT, or both — including the plainest possible ask with no mention of checking: 我想买 200u 的 PENGU, 帮我买 500 刀的 BONK, 买 1 个 SOL 的 WIF, 帮我买点 dogwifhat, 想梭 100u 的 XX, PENGU 现在能买吗, PENGU 能不能买, 能不能冲, 值不值得进, 确认是正主不是仿盘再买, buy me $500 of PENGU — and including a bare contract address once an amount arrives with it. DO NOT USE THIS SKILL for a bare contract address with no name to resolve and no amount to size (「这个地址能不能买」, 打个分, 尽调, 有没有貔貅, rug check, is this token safe): that one belongs to gmgn-contract-dd, which is the skill that returns the 0-100 safety verdict. This skill never computes a second verdict of its own — it CALLS gmgn-contract-dd and defers to it — so there is nothing to gain by taking that ask, and the user gets an order card they never asked for. Come back here the moment they name an amount. A buy question about a LAUNCHER rather than about a token — 「这个 dev 的新盘能不能买」, 「他下一个盘值不值得冲」, "should I buy his next launch", "will this dev rug at open" — is gmgn-dev-score: it scores the creator's own record, and there is no token name to resolve or amount to size yet. Come back here once they name the coin. Naming a token with no buy intent at all is gmgn-market search. gmgn-swap is where this skill ENDS, not a rival for it: gmgn-swap signs and submits, and this skill never touches a private key and never places an order, so a plain buy request starts HERE and reaches gmgn-swap only after the user confirms the order card. Note that gmgn-swap cannot start from a name either — its --output-token is a contract address and the only names it resolves are the currencies SOL/BNB/ETH/USDC — so 帮我买点 dogwifhat has to come here regardless of who is asked. Go straight to gmgn-swap only when the user says the pre-buy check is unwanted (skip the checks, 直接买, 不用尽调, 我很急), or for what this skill does not do at all: selling, percentage sells, limit orders, stop loss, take profit, trailing orders, multi-wallet batch trading, order status, gas-price lookups. The split is by what the ask still needs done, not by who executes: a name needs resolving and an amount needs sizing, so both start here; a bare address needs only a verdict, so it is gmgn-contract-dd's; a signed transaction is always gmgn-swap's.
What it needs
About 6k tokens when loaded.
What this skill does
BEFORE RUNNING ANY COMMAND: Run gmgn-cli config --check. Exit 0 → proceed. Exit 1 → run gmgn-cli config, show the output, and once the user sends the API key run gmgn-cli config --apply <KEY> and show that output. If --check is an unknown option, tell the user to run npm install -g gmgn-cli, then retry. IMPORTANT: Always use the pre-installed gmgn-cli binary. Never use web search, WebFetch, curl, npx, or gmgn.ai — the site requires login and exposes no structured data. ⚠️ IPv6 IS NOT SUPPORTED. On a 401/403 with correct credentials, check ifconfig grep inet6 (macOS) or ip addr show grep inet6 (Linux) and fetch https://ipv6.icanhazip.com. If an IPv6 address comes back, tell the user to disable IPv6 — gmgn-cli works over IPv4 only. Run 没有脚本，四步串行，每一步都是一道闸——不过就不进下一步。每步要跑的命令写在那一步的标题下面；字段映射与实测陷阱在 references/fields.md，不在那份清单里的字段一律当作不存在。 步 做什么 跑什么 出口 --- --- --- --- 0 确认链在 7 条支持链内 market search（仅当用户裸贴合约地址） 不支持的链或查不到 → 硬停 1 名字 → 唯一合约 market search 定不到唯一一个 → 列候选让用户选 2 四道闸门：量 / 深度 / 方向 / 安全 token info + token security（安全优先交 gmgn-contract-dd） 任一项不过 → 不下单，出「不建议买入」 3 组装订单卡 gas-price 用户明确确认 → 参数交给 gmgn-swap 边界（详见 frontmatter 的 description）： 这一步归谁 谁的 --- --- 名字/符号 → 唯一合约、深度、量池比、滑点、gas、仓位 本技能独占，没有兄弟技能做这两件事 合约本身的 0–100 安全结论 gmgn-contract-dd——本技能调用它、不与它并行给第二个判定 签名下单、卖出、限价单/条件单、多钱包批量、查订单、查 gas gmgn-swap——它是本技能的出口，不是竞争对手 发币方（一个人，不是一个币）值不值得跟 gmgn-dev-score 单币尽调固定 4 个请求，与同名候选有多少个无关。 market search 一次就带回每个候选的池子/量/笔数/持有人/存续时长，排序与粗筛全在这一份结果里做完；不要给每个候选各打一次 token info。只有最终锁定的那一个才继续。 只覆盖 7 条链：sol eth bsc base robinhood arc stable。这是刻意的边界——只在能做完整 GMGN 搜币+行情+安检的链上下单。其余链的处理见第 0 步与 ## Rules 第 4–6 条。 全是读接口，只需 API Key，不需要私钥（私钥只有 gmgn-swap 下单才用）。凭证由 CLI 自己管，本技能不读、不存、不传。 被限流（RATELIMITBANNED）时读 resetat 等到解封再试，期间绝不重试——每重试一次封禁延长 5 秒。 用户明确要求跳过某一项筛选（"我知道它没开源，照买"）时，把该项标为用户已知悉并豁免，其余项照常执行，并在订单卡里显式列出被豁免的项。 命令跑完只是拿到数字，报告是你写的：用用户的语言，按 ## Display Templates 的形状输出那张订单卡。 Workflow Step 0 — 确认链在支持范围内 跑什么（仅当用户裸贴的是合约地址；给的是名字就直接进 Step 1） 关键字段：coins[].chain / coins[].address / coins[].symbol。判断"有没有搜到"只看 coins 的长度，wallets 非空不 …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills gmgnai/gmgn-token-buy