🦞GMGN Agent API

一、为什么选择 GMGN Agent API？

1. ⚡️ 实时链上数据 · 提供多链实时行情与流动性池状态，让你的 AI Agent 零延迟捕捉市场机会

2. 🔍 特色数据全面 · API 开箱即用，免去繁琐的底层数据解析，直接输出高阶投研指标 - 狙击手、老鼠仓、捆绑钱包等

3. 🛡️ 交易安全方便 · 采用 GMGN 托管钱包架构，私钥不存本地，从根源杜绝泄露风险；IP 白名单自动拦截异常交易请求，开发者无需手动构造复杂的链上交易

---

二、运行你的第一个 GMGN AI Agent

为你的 AI Agent 接入链上能力——查询行情、获取市场数据、执行 Swap 交易，全程自然语言操作

快速开始：获取 API Key

在使用之前，请先创建 GMGN API Key，👉 申请地址：https://gmgn.ai/ai

---

1. 将 GMGN Skills 添加到你的 Agent

将以下指令复制并发送给你的 OpenClaw 或者 Claude Code 等其他 AI Agent 工具：

安装 GMGN skills，运行：npx skills add GMGNAI/gmgn-skills

---

2. 试一试！

安装完成后，直接发送以下指令测试查询能力：

获取 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN 的 K 线，分析是否值得买入。

---

3. 设置你的 API Key

为了稳定调用接口并解锁 Swap 交易功能，你需要配置全局凭证。发送以下指令：

在 ~/.config/gmgn/ 目录下创建一个 .env 文件，包含变量 GMGN_API_KEY。
如果需要交易功能，请一并添加 GMGN_PRIVATE_KEY 变量。
为我打开这个文件，提醒我把真实的 Key 粘贴进去并保存。注意，请确保这个文件不会被提交到 git。

⚠️ 注意：切勿将 .env 提交到 git（请添加到 .gitignore），绝不要在聊天、日志或截图中暴露私钥。执行 Swap 的私钥必须与绑定该 API Key 的钱包一致。

---

用法：

安装完成后，使用自然语言即可使用：

• "买入 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 的底层能力涵盖了最核心的链上交互场景：

1. 🪙 Token (代币)：查询基础信息、实时价格、安全检测、流动性池状态，以及 Top 持有者和交易者画像

2. 📈 Market (行情)：获取精准的 K 线数据，支持 1m 到 1d 的多维时间粒度自由切换

3. 🔥 Trending (榜单)：获取当前热门代币榜单

4. 💰 Portfolio (资产)：查询钱包持仓与代币余额，统计历史交易活动与盈亏数据

5. 🔄 Swap (交易)：通过最优路由提交代币兑换交易，支持自定义滑点，并能实时查询链上订单状态（需配置私钥）

---

四、支持的链：

ETH等新链正在接入中...

支持的链	用于交易的基础代币
SOL	SOL, USDC
BSC	BNB, USDC
Base	ETH, USDC

⚠️ 安全与免责声明：

在使用 GMGN Skills 的过程中，你的 AI Agent 可能会出错。所以在让 AI Agent 执行查询及链上资产交易的指令前（如 swap），请务必人工核对代币合约、金额与滑点等关键参数。因 AI 模型所引发的意外风险，需由用户自行评估与承担。