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

---

接口总览

模块	接口	方法	说明
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 (每条记录字段):

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

群组分类参考:

类型	群组
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:

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

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

人気CAランキングを30秒ごとに自動でプッシュします。

{
  "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 は不要で、そのままアクセスできます。

ツール	URL	用途
DexScreener	https://dexscreener.com/search?q={CA}	時価総額、流動性、ローソク足
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桁の16進数アドレスを指定し、その後に有効な Move 識別子を2つ続けます。例： 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	1日の呼び出し上限に達しました

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

---

データテーブルの説明

group_ca（約33万件、リアルタイム同期）

CA コントラクトアドレスのレコードです。トークン情報、時価総額、売買データ、時価総額の変化などが含まれます。

ai_summary（約219件、毎日更新）

Feishu グループの AI による要約内容です。

send_kol

二次KOLが投稿したメッセージです。内容、Token、画像リンクが含まれます。

newsflash

速報メッセージです。タイトル、内容、リンクが含まれます。

---

お問い合わせ

WeChat：erwaNFT

API アドレス：https://juhequn.com