Erwa API

二娃聚合群 API

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

安装

npx skills add hengxuZ/erwaAPI

认证

所有接口使用 Bearer Token 认证：

Authorization: Bearer <your-token>

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

Base URL: https://juhequn.com

接口总览

核心接口详情

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 (每条记录字段):

{
  "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:

{
  "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 (每条记录字段):

{
  "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:

[
  {
    "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

群组分类参考:

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:

[
  {
    "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. 快讯

Query Parameters (today/latest):

• limit (int): 返回数量，默认20

Response:

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

11. Token使用次数

Endpoint: GET /api/v1/token/usage

Response:

{
  "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秒检查数据库。

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排行：

{
  "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秒检查数据库。

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);

推送消息格式:

{
  "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，直接访问。

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

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

数据表说明

group_ca（约33万条，实时同步）

CA合约地址记录，包含代币信息、市值、买卖数据、市值变化等。

ai_summary（约219条，每日更新）

飞书群组AI总结内容。

send_kol

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

newsflash

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

联系方式

微信：erwaNFT

API地址：https://juhequn.com