🦞GMGN Agent API
一、为什么选择 GMGN Agent API？
⚡️ 实时链上数据 · 提供多链实时行情与流动性池状态，让你的 AI Agent 零延迟捕捉市场机会
🔍 特色数据全面 · API 开箱即用，免去繁琐的底层数据解析，直接输出高阶投研指标 - 狙击手、老鼠仓、捆绑钱包等
🛡️ 交易安全方便 · 采用 GMGN 托管钱包架构，私钥不存本地，从根源杜绝泄露风险；IP 白名单自动拦截异常交易请求，开发者无需手动构造复杂的链上交易
二、运行你的第一个 GMGN AI Agent
为你的 AI Agent 接入链上能力——查询行情、获取市场数据、执行 Swap 交易，全程自然语言操作
快速开始：获取 API Key 和 密钥对
在使用之前，你需要完成以下准备：
生成密钥对：使用非对称密钥生成器在本地生成一对密钥（公钥 & 私钥），生成教程 🔑生成公钥
获取 API Key：前往 👉 https://gmgn.ai/ai ，上传你的公钥，即可创建并获取专属的 GMGN API Key（注：仅支持 IPv4 请求，暂不支持 IPv6）
使用 Skill 所要求的权限如下：
查询类 (gmgn-market / token / portfolio)
✅ API Key
交易类 (gmgn-swap)
✅ API Key + 私钥
1. 将 GMGN Skills 添加到你的 Agent
将以下指令复制并发送给你的 OpenClaw 或者 Claude Code 等其他 AI Agent 工具：
2. 配置 API Key 和 私钥
发送以下指令进行全局配置，Agent 回复后按需填写 API Key 和 私钥 即可：
⚠️ 注意：切勿将
.env提交到 git（请添加到.gitignore），绝不要在聊天、日志或截图中暴露私钥。执行 Swap 时填写的私钥，必须与你创建 API Key 时上传的公钥是属于同一密钥对
3. 试一试！
配置完成后，直接发送以下指令测试查询能力：
用法：
安装完成后，使用自然语言即可使用：
"买入 0.1 SOL 的 <token_address>"
"卖出 50% 的 <token_address>"
"获取 <token_address> 的 K 线，分析是否值得买入"
"查看 <token_address> 的合约安全和池子状态"
"查看 <wallet_address> 的近期交易记录"
"查看 <token_address> 的持有者列表"
三、什么是 GMGN Skills
介绍
GMGN Skills 是专为 AI Agent 打造的链上交易技能文档。它让 Agent 能够原生读取多链行情、多维度分析代币、管理钱包资产、并直接执行 Swap 交易
灵活的集成方式
AI Skills — 内置
/gmgn-token、/gmgn-market等系统级指令，Agent 通过自然语言即可直接调用，零 API 适配成本命令行 CLI — 提供开箱即用的
npx gmgn-cli终端命令，支持格式化 JSON 或单行 JSON（--raw）输出，完美适配脚本处理
核心能力
GMGN 的底层能力涵盖了最核心的链上交互场景：
🪙 Token (代币)：查询基础信息、实时价格、安全检测、流动性池状态，以及 Top 持有者和交易者画像
📈 Market (行情)：获取精准的 K 线数据，支持
1m到1d的多维时间粒度自由切换🔥 Trending (榜单)：获取当前热门代币榜单
💰 Portfolio (资产)：查询钱包持仓与代币余额，统计历史交易活动与盈亏数据
🔄 Swap (交易)：通过最优路由提交代币兑换交易，支持自定义滑点，并能实时查询链上订单状态（需配置私钥）
四、支持的链：
ETH等新链正在接入中...
SOL
SOL, USDC
BSC
BNB, USDC
Base
ETH, USDC
⚠️ 安全与免责声明：
在使用 GMGN Skills 的过程中，你的 AI Agent 可能会出错。所以在让 AI Agent 执行查询及链上资产交易的指令前（如
swap），请务必人工核对代币合约、金额与滑点等关键参数。因 AI 模型所引发的意外风险，需由用户自行评估与承担。
Last updated