# 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 模型所引发的意外风险，需由用户自行评估与承担。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gmgn.ai/cn/gmgn-agent-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.