> For the complete documentation index, see [llms.txt](https://docs.gmgn.ai/cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gmgn.ai/cn/gmgn-agent-api.md).

# GMGN Agent API

### 一、为什么选择 GMGN Agent API？

1. ⚡️ **实时链上数据**\
   · 提供多链实时行情与流动性池状态，让你的 AI Agent 零延迟捕捉市场机会
2. 🔍 **特色数据全面**\
   · API 开箱即用，免去繁琐的底层数据解析，直接输出高阶投研指标 - 狙击手、老鼠仓、捆绑钱包等
3. 🛡️ **交易安全方便**\
   · 采用 GMGN 托管钱包架构，私钥不存本地，从根源杜绝泄露风险；IP 白名单自动拦截异常交易请求，开发者无需手动构造复杂的链上交易

***

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

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

#### 快速开始：获取 API Key 和 密钥对

在使用之前，你需要完成以下准备：

* 生成密钥对：使用非对称密钥生成器在本地生成一对密钥（**公钥 & 私钥），**生成教程 [🔑生成公钥](https://docs.gmgn.ai/cn/sheng-cheng-gong-yao)
* 获取 API Key：前往 👉 <https://gmgn.ai/ai> ，上传你的公钥，即可创建并获取专属的 GMGN API Key（*注：仅支持 IPv4 请求，暂不支持 IPv6*）

使用 Skill 所要求的权限如下：

| Skill                                 | 需要             |
| ------------------------------------- | -------------- |
| 查询类 (gmgn-market / token / portfolio) | ✅ API Key      |
| 交易类 (gmgn-swap)                       | ✅ API Key + 私钥 |

***

#### 1. 将 GMGN Skills 添加到你的 Agent

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

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

***

#### **2. 配置 API Key 和 私钥**

发送以下指令进行全局配置，Agent 回复后按需填写 **API Key 和 私钥** 即可：

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

> ⚠️ 注意：切勿将 `.env` 提交到 git（请添加到 `.gitignore`），绝不要在聊天、日志或截图中暴露私钥。执行 Swap 时填写的私钥，必须与你创建 API Key 时上传的公钥是属于同一密钥对

***

#### **3. 试一试！**

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

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

***

#### 用法：

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

> * `"买入 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等新链正在接入中...

<table><thead><tr><th>支持的链</th><th width="342.645751953125">用于交易的基础代币</th></tr></thead><tbody><tr><td><strong>SOL</strong></td><td>SOL, USDC</td></tr><tr><td><strong>BSC</strong></td><td>BNB, USDC</td></tr><tr><td><strong>Base</strong></td><td>ETH, USDC</td></tr></tbody></table>

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