# Erwa API

> 二娃聚合群 API — 聚合 38+ 飞书群组，提供群聊AI总结、CA合约追踪、KOL观点、市场快讯的 Web3 数据服务

- Skill: `hengxuz/erwa-api` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hengxuz/erwa-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hengxuz/erwa-api/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: hengxuz (https://skillmd.com/u/hengxuz)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hengxuz/erwa-api

---


# 二娃聚合群 API

聚合 38+ 飞书群组，提供群聊AI总结、CA合约追踪、KOL观点、市场快讯的 Web3 数据服务。

---

## 安装

```bash
npx skills add hengxuZ/erwaAPI
```

---

## 认证

所有接口使用 Bearer Token 认证：

```
Authorization: Bearer <your-token>
```

获取 Token：联系管理员微信 **erwaNFT**

**Base URL**: `https://juhequn.com`

---

## 接口总览

| 模块 | 接口 | 方法 | 说明 |
|------|------|------|------|
| CA追踪 | `/api/v1/group_ca` | GET | CA列表（支持多维筛选） |
| CA追踪 | `/api/v1/group_ca/popular` | GET | 热门CA统计 |
| CA追踪 | `/api/v1/group_ca/latest` | GET | 最新CA记录 |
| CA追踪 | `/api/v1/group_ca/sync` | GET | 按 ID 增量同步 CA |
| CA追踪 | `/api/v1/group_ca/by-username/{username}` | GET | 按用户名查CA |
| CA追踪 | `/api/v1/group_ca/query_group` | GET | 根据CA查群组来源 |
| CA追踪 | `/api/v1/group_ca/user_content` | GET | 查询群友讨论情况 |
| CA追踪 | `/api/v1/group_ca/by-ca/{ca_address}` | GET | 根据 CA 地址查群组来源 |
| CA追踪 | `/api/v1/group_ca/search` | GET | 全局搜索，参数 `q` |
| CA追踪 | `/api/v1/group_ca/info/{ca_address}` | GET | CA 聚合元数据与摘要 |
| CA追踪 | `/api/v1/group_ca/{ca_id}` | GET | 按数据库 ID 查询 CA |
| CA追踪 | `/api/v1/group_ca/http` | GET | CA 相关 HTTP 记录 |
| CA追踪 | `/api/v1/group_ca/board/summary` | GET | CA 看板汇总 |
| CA追踪 | `/api/v1/group_ca/board/ca/{ca_address}` | GET | 单个 CA 看板详情 |
| CA追踪 | `/api/v1/group_ca/board/ca/{ca_address}/kline` | GET | 单个 CA K 线 |
| CA追踪 | `/api/v1/group_ca/call-leaderboard` | GET | 喊单成功榜 |
| 链接追踪 | `/api/v1/group_http` | GET | HTTP链接列表 |
| 链接追踪 | `/api/v1/popular_http` | GET | 热门HTTP统计 |
| 群聊总结 | `/api/v1/summaries/groups` | GET | 可用群组名称 |
| X 推文 | `/api/v1/popular_tweets/latest` | GET | 最新热门推文 |
| X 推文 | `/api/v1/popular_tweets/previews` | GET | CA/URL/X账号推文预览 |
| X 推文 | `/api/v1/popular_x_mention` | GET | X账号提及榜 |
| 群聊总结 | `/api/v1/summaries` | GET | AI群聊总结 |
| 群聊总结 | `/api/v1/summaries/narratives` | GET | 每日热门叙事 |
| KOL观点 | `/api/v1/second_kol` | GET | 二级KOL输出数据 |
| KOL观点 | `/api/v1/second_kol/latest` | GET | 最新KOL数据 |
| KOL观点 | `/api/v1/second_kol/kol/{kol_name}` | GET | 指定KOL数据 |
| KOL观点 | `/api/v1/second_kol/kol_names` | GET | KOL名称列表 |
| KOL观点 | `/api/v1/us_stock_kol` | GET | 美股KOL输出数据 |
| KOL观点 | `/api/v1/us_stock_kol/latest` | GET | 最新美股KOL数据 |
| KOL观点 | `/api/v1/us_stock_kol/kol/{kol_name}` | GET | 指定美股KOL数据 |
| KOL观点 | `/api/v1/us_stock_kol/kol_names` | GET | 美股KOL名称列表 |
| 美股看板 | `/api/v1/us_stock_kol/board/summary` | GET | 美股标的汇总 |
| 美股看板 | `/api/v1/us_stock_kol/board/token/{token_symbol}` | GET | 单个美股标的详情 |
| 美股看板 | `/api/v1/us_stock_kol/board/token/{token_symbol}/price-line` | GET | 美股价格线 |
| 美股看板 | `/api/v1/us_stock_kol/board/token/{token_symbol}/kline` | GET | 美股K线 |
| 快讯 | `/api/v1/newsflash/today` | GET | 今日快讯 |
| 快讯 | `/api/v1/newsflash/date/{date}` | GET | 指定日期快讯 |
| 快讯 | `/api/v1/newsflash/latest` | GET | 最新快讯 |
| 系统 | `/api/v1/token/usage` | GET | Token使用次数 |
| 群主发言 | `/api/v1/group_owner_messages/owners` | GET | 群主筛选名单 |
| 群主发言 | `/api/v1/group_owner_messages/latest` | GET | 群主发言历史 |
| 群主发言 | `/api/v1/group_owner_messages/sync` | GET | 按 ID 增量同步群主发言 |
| TG Call | `/api/v1/tg_call/latest` | GET | TG Call 历史 |
| TG Call | `/api/v1/tg_call/channels` | GET | TG Call 频道列表 |
| TG 快讯 | `/api/v1/tg_newsflash/latest` | GET | TG 快讯历史 |
| TG 快讯 | `/api/v1/tg_newsflash/sources` | GET | TG 快讯来源 |
| 市场 | `/api/v1/market/prices` | GET | BTC/SOL/ETH/BNB/HYPE 行情 |
| 市场 | `/api/v1/market/ca-quotes` | POST | 批量 CA 市值（支持 `sui`） |
| 扩展流 | `/api/v1/gmgn/hot-searches` | GET | GMGN 热搜 |
| 扩展流 | `/api/v1/gmgn_trenches/completed` | GET | 已开盘 MEME |
| 扩展流 | `/api/v1/gmgn/callout/{ca}` | GET | 指定 CA GMGN 喊单 |
| 扩展流 | `/api/v1/gmgn_callouts/latest` | GET | GMGN 喊单历史 |
| 扩展流 | `/api/v1/wind_callouts/latest` | GET | FOMO/pump 喊单 |
| 扩展流 | `/api/v1/purealpha/status` | GET | PureAlpha 状态 |
| 扩展流 | `/api/v1/purealpha/accounts` | GET | PureAlpha 账号 |
| 扩展流 | `/api/v1/purealpha/accounts/{source_id}` | GET | PureAlpha 单账号 |
| 扩展流 | `/api/v1/purealpha/events` | GET | PureAlpha 事件 |
| 扩展流 | `/api/v1/purealpha/feed` | GET | PureAlpha Feed |
| 扩展流 | `/api/v1/purealpha/popular` | GET | PureAlpha 热榜 |
| 扩展流 | `/api/v1/purealpha/hot` | GET | PureAlpha 热门快照 |
| 扩展流 | `/api/v1/kol_tracker/{slug}/board` | GET | KOL Tracker 看板 |
| 扩展流 | `/api/v1/kol_tracker/{slug}/ticker/{ticker}/price-line` | GET | KOL Tracker 标的价格线 |
| 扩展流 | `/api/v1/kol_tracker/{slug}/refresh` | POST | 刷新 KOL Tracker 数据 |
| Binance | `/api/v1/binance/address/{address}/info` | GET | 钱包地址代币持仓 |
| Binance | `/api/v1/binance/token/search` | GET | 搜索代币 |
| Binance | `/api/v1/binance/token/{ca}/info` | GET | 代币元数据与行情 |
| Binance | `/api/v1/binance/token/{ca}/audit` | POST | 代币安全审计 |
| Binance | `/api/v1/binance/market/rank/{category}` | POST | 市场排名 |
| Binance | `/api/v1/binance/meme/rush` | POST | Meme 发射追踪 |
| Binance | `/api/v1/binance/trading/signals` | POST | 聪明钱交易信号 |
| Binance | `/api/v1/binance/dexscreener/{ca}` | GET | DexScreener 链上数据 |
| Binance Web3 | `/api/v1/binance_web3`、`/api/v1/binance_web3/`、`/api/v1/binance_web3/{path}` | 多种 | Binance Web3 代理转发 |
| 聪明钱 | `/api/v1/smart_money` | GET | 聪明钱交易信号 |
| 币安广场 | `/api/v1/binance_square/status` | GET | 数据抓取状态 |
| 币安广场 | `/api/v1/binance_square/fetch` | POST | 手动触发抓取 |
| 币安广场 | `/api/v1/binance_square/latest` | GET | 最新广场内容 |
| 辅助 | `/api/v1/media/image` | GET | 图片代理，参数 `url` |
| 辅助 | `/api/v1/media/feishu_image` | GET | 飞书图片代理，参数 `key` |
| 辅助 | `/api/v1/notifications/config` | GET | 通知配置 |
| 辅助 | `/api/v1/notifications/config` | PUT | 更新通知配置 |
| 辅助 | `/api/v1/notifications/options` | GET | 通知选项 |
| 辅助 | `/api/v1/notifications/history` | GET | 通知历史 |
| 辅助 | `/api/v1/notifications/channels/test` | POST | 测试通知渠道 |
| 辅助 | `/api/v1/translate/zh` | POST | 中文翻译 |
| Telegram | `/telegram` | POST | Telegram 消息接收回调 |
| WebSocket | `/ws/new_ca` | WS | 全局新CA实时推送 |
| WebSocket | `/ws/new_http` | WS | 新HTTP链接实时推送 |
| WebSocket | `/ws/popular_ca` | WS | 热门CA实时排行 |
| WebSocket | `/ws/group-owner-messages` | WS | 群主发言实时推送 |
| WebSocket | `/ws/new_tg_call` | WS | TG Call 实时推送 |
| WebSocket | `/ws/tg_newsflash` | WS | TG 快讯实时推送 |
| WebSocket | `/ws/second_kol` | WS | 币圈 KOL 实时推送 |
| WebSocket | `/ws/us_stock_kol` | WS | 美股 KOL 实时推送 |
| WebSocket | `/ws/binance_square` | WS | 币安广场实时推送 |
| WebSocket | `/ws/purealpha` | WS | PureAlpha 实时推送 |
| WebSocket | `/ws/gmgn_trenches` | WS | 已开盘 MEME 实时推送 |
| WebSocket | `/ws/gmgn_callouts` | WS | GMGN 喊单实时推送 |
| WebSocket | `/ws/fomo_callouts` | WS | FOMO 喊单实时推送 |
| WebSocket | `/ws/pump_callouts` | WS | pump.fun 实时推送 |
| WebSocket | `/ws/new_tweet` | WS | X 热门推文实时推送 |

---

## 核心接口详情

### 1. CA列表

**Endpoint**: `GET /api/v1/group_ca`

**Query Parameters**:
- `ca` (string): CA地址模糊搜索
- `username` (string): 用户名筛选
- `group_name` (string): 群组名称筛选
- `limit` (int): 返回数量，默认100，最大1000
- `skip` (int): 跳过记录数
- `date` (date): 按日期筛选 (YYYY-MM-DD)

**Response** (每条记录字段):
```json
{
  "id": 78146,
  "ca": "0x6106c7d92308bbe4204667a59f9b570288954444",
  "username": "白菜",
  "group_name": "区块日记群",
  "create_time": "2026-03-13T11:34:24",
  "symbol": "PEPE",
  "chain": "bsc",
  "token_name": "Pepe Token",
  "market_cap": "6.4K",
  "first_market_cap": "2.1K",
  "age": 7,
  "total_mentions": 5,
  "twitter": "https://twitter.com/token123",
  "telegram": "https://t.me/token123",
  "website": "https://token123.io",
  "summary": "这是一个meme代币，社区活跃...",
  "m5_buys": 10,
  "h1_buys": 50,
  "h6_buys": 200,
  "h24_buys": 500,
  "user_content": "这个币看起来不错，可以关注一下",
  "liquidity": "37.5K",
  "volume_24h": "3.9M"
}
```

**字段说明**:
- `symbol`: 代币简称
- `chain`: 公链（bsc/sol/base/eth/sui/tron）
- `token_name`: 代币全称
- `market_cap`: 当前市值（>=1000用K，>=1000K用M，>=1000M用B；DexScreener 无数据时为 `null`）
- `first_market_cap`: 首次被提及时的市值
- `age`: 代币从创建到被提及的时间（分钟）
- `total_mentions`: 48h内提及次数
- `summary`: 代币叙事/总结
- `twitter` / `telegram` / `website`: 社交链接
- `m5_buys` / `h1_buys` / `h6_buys` / `h24_buys`: 对应时间窗口买入数
- `user_content`: 群友原始讨论内容（该CA对应的群聊原文）
- `liquidity`: 流动性（USD格式化，如 37.5K）
- `volume_24h`: 24小时成交额（USD格式化，如 3.9M）

**展示建议**: 按 `total_mentions` 排序，询问"今日金狗"按 `(market_cap - first_market_cap) / first_market_cap` 排序

---

### 2. 热门CA统计

**Endpoint**: `GET /api/v1/group_ca/popular`

**Query Parameters**:
- `date` (date): 统计日期，默认当天
- `min_count` (int): 最小提及次数阈值，默认10
- `group_name` (string): 群组名称筛选
- `limit` (int): 返回数量，默认100
- `skip` (int): 跳过记录数

响应字段同 CA列表，额外包含：
- `mc_change`: 市值变化（仅 popular 接口返回）`{"first_mc": "2.1K", "current_mc": "6.4K", "change_pct": 204.76}`
- `count`: 提及次数

---

### 3. 最新CA记录

**Endpoint**: `GET /api/v1/group_ca/latest`

**Query Parameters**:
- `limit` (int): 返回数量，默认1，最大100

只返回 `ca` 不为 null 且 `http` 为 null 的记录。

> 推荐使用 WebSocket 方式获取 CA，更快更准：`wss://juhequn.com/ws/new_ca`

---

### 4. 按用户名查CA

**Endpoint**: `GET /api/v1/group_ca/by-username/{username}`

**Path Parameters**:
- `username` (string, 必填): 用户名

**Query Parameters**:
- `limit` (int): 返回数量，默认50，最大50

最多返回50条。

---

### 5. 根据CA查群组

输入CA地址，返回所有发过该CA的群组列表。

**Endpoint**: `GET /api/v1/group_ca/query_group`

**Query Parameters**:
- `ca` (string, 必填): CA地址（精确匹配）

**Response**:
```json
{
  "ca": "7m3HtU4RDiXWpAt546HHC7Lho3Qzvz6tx2MiAmLiHpLn",
  "total_groups": 3,
  "groups": ["crazySen群", "孙哥群", "测试群组"]
}
```

---

### 6. HTTP链接列表

查询群组中分享的 HTTP 链接（group_ca 表中 http 不为空的记录）。

**Endpoint**: `GET /api/v1/group_http`

**Query Parameters**:
- `group_name` (string): 群组名称筛选
- `limit` (int): 返回数量，默认20，最大100
- `skip` (int): 跳过记录数
- `date` (date): 按日期筛选 (YYYY-MM-DD)

**Response** (每条记录字段):
```json
{
  "id": 4564,
  "username": "白菜",
  "group_name": "区块日记群",
  "create_time": "2026-03-13T11:34:24",
  "http": "https://example.com",
  "user_content": "这个链接有意思",
  "summary": null,
  "liquidity": null,
  "volume_24h": null
}
```

### 7. 查询群友讨论情况

根据 CA 地址或 HTTP 链接查询对应的群友讨论内容（user_content）。

**Endpoint**: `GET /api/v1/group_ca/user_content`

**Query Parameters**:
- `ca` (string, 可选): CA地址（精确匹配）
- `http` (string, 可选): HTTP链接（精确匹配）
- `limit` (int): 返回数量，默认20，最大100

> **注意**: `ca` 和 `http` 至少传一个。

**Response**:
```json
[
  {
    "id": 12345,
    "ca": "0x6106c7d92308bbe4204667a59f9b570288954444",
    "http": null,
    "username": "白菜",
    "group_name": "区块日记群",
    "create_time": "2026-03-13T11:34:24",
    "user_content": "这个币看起来不错，可以关注一下"
  }
]
```

---

### 7. AI群聊总结

**Endpoint**: `GET /api/v1/summaries`

**Query Parameters**:
- `group_name` (string): 群组名称（模糊匹配）
- `date` (date): 日期，默认今天
- `hour` (int): 指定小时 (0-23)
- `start_date` / `end_date` (datetime): 时间范围
- `limit` (int): 返回数量，默认100

**群组分类参考**:

| 类型 | 群组 |
|------|------|
| Meme/土狗 | cryptoD、0xSun、GDC、James、金蛙、985、镭射猫、crazySen、0xAA、AD、区块日记 |
| 空投 | leng、P总、小鑫、十一地主、十一Eleve、3D群 |
| 打新 | 中国万岁、AKAKAY、Meta |

---

### 8. 每日热门叙事

**Endpoint**: `GET /api/v1/summaries/narratives`

**Query Parameters**:
- `date` (date): 日期，默认今天

返回提及次数最多的前10条CA的 `summary`（代币叙事）字段。

---

### 9. 二级KOL数据

**Endpoint**: `GET /api/v1/second_kol`

**Query Parameters**:
- `kol_name` (string): KOL名称
- `token` (string): Token筛选
- `start_date` / `end_date` (date): 时间范围
- `limit` (int): 返回数量，默认50
- `skip` (int): 跳过数量

**Response**:
```json
[
  {
    "kol_name": "KOL张三",
    "content": "这是一个关于某代币的分析...",
    "token": "ABC123",
    "image_urls": ["https://example.com/img1.png"],
    "sent_at": "2026-03-08T15:30:00"
  }
]
```

**其他KOL接口**:
- `GET /api/v1/second_kol/latest?limit=20` — 最新KOL数据
- `GET /api/v1/second_kol/kol/{kol_name}` — 指定KOL数据
- `GET /api/v1/second_kol/kol_names` — 所有KOL名称列表

> 自动过滤包含屏蔽词（如 bitget）的内容，@everyone 不是代币 ONE

---

### 10. 快讯

| 接口 | 说明 |
|------|------|
| `GET /api/v1/newsflash/today` | 今日快讯 |
| `GET /api/v1/newsflash/date/{date}` | 指定日期快讯 |
| `GET /api/v1/newsflash/latest` | 最新快讯 |

**Query Parameters** (today/latest):
- `limit` (int): 返回数量，默认20

**Response**:
```json
[
  {
    "add_time": 1741252800,
    "title": "比特币突破新高",
    "content": "比特币价格突破10万美元大关...",
    "url": "https://example.com/news/12345"
  }
]
```

---

### 11. Token使用次数

**Endpoint**: `GET /api/v1/token/usage`

**Response**:
```json
{
  "token": "aaa3b7ad****b1c",
  "token_name": "API Token 500次/年",
  "daily_limit": 500,
  "used_today": 45,
  "remaining_today": 455,
  "reset_time": "2026-03-09 00:00:00"
}
```

---

## WebSocket 实时推送

**Base URL**: `wss://juhequn.com`

连接时通过 URL 参数传递 Token：`wss://juhequn.com/ws/new_ca?token=YOUR_TOKEN`

### WS 1. 全局新CA推送

**Endpoint**: `wss://juhequn.com/ws/new_ca`

连接即开始接收所有新CA，无需订阅。每5秒检查数据库。

```javascript
const ws = new WebSocket('wss://juhequn.com/ws/new_ca?token=YOUR_TOKEN');

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  if (data.type === 'new_ca') {
    console.log('新CA:', data.data.ca, '群组:', data.data.group_name);
  }
};

// 心跳
setInterval(() => ws.send('ping'), 30000);
```

### WS 2. 群主发言实时推送

**Endpoint**: `wss://juhequn.com/ws/group-owner-messages`

连接后接收群主发言事件；历史查询使用 `/api/v1/group_owner_messages/latest`。

### WS 3. 热门CA排行

**Endpoint**: `wss://juhequn.com/ws/popular_ca`

每30秒自动推送热门CA排行：

```json
{
  "type": "popular_ca_update",
  "data": [
    {"ca": "0x123...", "count": 25, "rank": 1},
    {"ca": "0x456...", "count": 18, "rank": 2}
  ],
  "timestamp": "2026-03-30T10:30:00"
}
```

### WS 4. 新HTTP链接实时推送

**Endpoint**: `wss://juhequn.com/ws/new_http`

连接即开始接收所有新HTTP链接，无需订阅。每5秒检查数据库。

```javascript
const ws = new WebSocket('wss://juhequn.com/ws/new_http?token=YOUR_TOKEN');

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  if (data.type === 'new_http') {
    console.log('新HTTP:', data.data.http, '群组:', data.data.group_name);
  }
};

// 心跳
setInterval(() => ws.send('ping'), 30000);
```

**推送消息格式**:

```json
{
  "type": "new_http",
  "data": {
    "id": 12345,
    "username": "白菜",
    "group_name": "区块日记群",
    "create_time": "2026-05-18T21:45:18",
    "http": "https://example.com",
    "user_content": "这个链接有意思",
    "summary": null,
    "liquidity": null,
    "volume_24h": null
  },
  "timestamp": "2026-05-18T21:45:18"
}
```

> 注意：只推送 `http` 不为空且 `ca` 为空的记录。

---

## 链上数据分析工具

以下为外部工具，无需 Token，直接访问。

| 工具 | URL | 用途 |
|------|-----|------|
| DexScreener | `https://dexscreener.com/search?q={CA}` | 市值、流动性、K线 |
| DexScreener API | `https://api.dexscreener.com/latest/dex/tokens/{CA}` | 交易对数据（SUI coin type 直接放入 `{CA}`） |
| GMGN.ai | `https://r.jina.ai/http://gmgn.ai/{chain}/token/{CA}` | 安全审计、持仓分布 |
| Binance叙事 | `https://web3.binance.com/...?chainId={id}&contractAddress={CA}` | AI叙事分析 |
| X平台搜索 | `https://fapi.uk/api/base/apitools/search?words={CA}` | Twitter讨论热度 |

**Chain参数**: `sol` / `bsc` / `base` / `eth` / `sui` / `tron`

SUI 使用标准 coin type：`0x` 加 64 位十六进制地址，再接两个合法 Move 标识符，例如
`0x228c580891953873670a13c4dc2e4eb84cae59925a3c774b978af134212092b5::template::TEMPLATE`。
查询 SUI 行情时使用 DexScreener 的 `sui` 链路径；`marketCap`/`fdv` 缺失时按 `null` 处理，不要填充为 0。
Tron 仅生成 GMGN 跳转：`https://gmgn.ai/tron/token/JtQgDPzN_{CA}`；SUI 不生成 GMGN 链接。

**Binance Chain ID**: solana=`CT_501`, bsc=`56`, base=`8453`

> 若外部网页被阻断，可在 URL 前加 `https://r.jina.ai/` 作为只读代理

---

## 错误处理

所有响应头包含 `X-Admin-Contact: wechat:erwaNFT`

| Code | 说明 |
|------|------|
| 401 | 缺少Token / Token无效 |
| 403 | Token已过期/被禁用 |
| 404 | 未找到记录 |
| 429 | 已达到每日调用限制 |

```json
{ "detail": "错误描述信息" }
```

---

## 数据表说明

### group_ca（约33万条，实时同步）
CA合约地址记录，包含代币信息、市值、买卖数据、市值变化等。

### ai_summary（约219条，每日更新）
飞书群组AI总结内容。

### send_kol
二级KOL发布消息，含内容、Token、图片链接。

### newsflash
快讯消息，含标题、内容、链接。

---

## 联系方式

微信：**erwaNFT**

API地址：https://juhequn.com