// API DOCUMENTATION

API 文档 & 在线测试

CA 追踪
GET /api/v1/group_ca

获取Group CA列表,支持多维筛选

GET /api/v1/group_ca/by-ca/{ca_address}

根据CA地址查群组来源

GET /api/v1/group_ca/popular

热门CA统计(按天)

GET /api/v1/group_ca/latest

获取最新CA记录

GET /api/v1/group_ca/by-username/{username}

根据用户名查CA列表(最多50条)

HTTP 链接
GET /api/v1/group_http

获取HTTP链接列表

GET /api/v1/popular_http

获取热门HTTP链接

群聊总结
GET /api/v1/summaries

获取AI群聊总结

GET /api/v1/summaries/narratives

获取每日叙事

KOL 观点
GET /api/v1/second_kol

二级KOL输出数据

GET /api/v1/second_kol/latest

获取最新KOL数据

GET /api/v1/second_kol/kol_names

获取KOL名称列表

GET /api/v1/us_stock_kol

美股博主输出数据

GET /api/v1/us_stock_kol/latest

获取最新美股博主数据

GET /api/v1/us_stock_kol/kol/{kol_name}

获取指定美股博主数据

GET /api/v1/us_stock_kol/kol_names

获取美股博主名称列表

美股查询
GET /api/v1/us_stock_kol/board/summary

美股标的汇总、热门Ticker和最新观点

GET /api/v1/us_stock_kol/board/token/{token_symbol}

查询单个美股标的详情和提及记录

GET /api/v1/us_stock_kol/board/token/{token_symbol}/kline

查询单个美股标的K线数据

快讯
GET /api/v1/newsflash/today

获取今日快讯

GET /api/v1/newsflash/date/{date}

获取指定日期快讯

GET /api/v1/newsflash/latest

获取最新快讯

群主发言
GET /api/v1/group_owner_messages/owners

获取可筛选的群主名称列表

通知
GET /api/v1/notifications/config

获取当前 Token 的通知渠道和规则

GET /api/v1/notifications/options

获取通知规则可选项

GET /api/v1/notifications/history

获取通知触发历史

系统
GET /api/v1/token/usage

查询Token使用次数

试一试 — HTTP 测试

GET /api/v1/group_ca

获取Group CA列表,支持按CA、用户名、群组、日期筛选。

点击「发送请求」开始测试...
WS

1. 全局新CA推送

连接即开始接收所有新CA。传入 last_id 时会先按数据库 ID 顺序补发断线期间的全部 CA,再切换到实时推送。

wss://juhequn.com/ws/new_ca?token=YOUR_TOKEN
可选参数:last_id(断点续传游标,传入后先按数据库 ID 顺序补发该 ID 之后的全部 CA)、ack_catchup(传 1 时补发完成后返回 catchup_complete 控制事件,默认 0)。
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

3. 热门CA排行

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

wss://juhequn.com/ws/popular_ca?token=YOUR_TOKEN
{
  "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链接实时推送

连接即开始接收所有新HTTP链接,无需订阅。每5秒检查数据库。只推送 http 不为空且 ca 为空的记录;X 推文中的站外链接会以“X推文”来源写入后进入本流。

wss://juhequn.com/ws/new_http?token=YOUR_TOKEN
{
  "type": "new_http",
  "data": {
    "id": 12345,
    "username": "白菜",
    "group_name": "区块日记群",
    "http": "https://example.com",
    "user_content_json": null,
    "has_discussion": true,
    "discussion_count": 1,
    "create_time": "2026-05-18T21:45:18"
  },
  "timestamp": "2026-05-18T21:45:18"
}
WS

5. 群主发言实时推送

连接后先返回最近历史消息;传入 last_id 时会连续补发全部缺口,然后按间隔轮询新消息。支持按群组和群主名称筛选。

wss://juhequn.com/ws/group-owner-messages?token=YOUR_TOKEN
可选参数:group_name(按群组筛选)、owner_name(按群主筛选)、names / name(按群主筛选,可重复传多个)、last_id(断点续传游标)、history(连接后补发的历史条数,默认 20,范围 0-200)、interval(轮询间隔秒数,默认 3,范围 0.5-10)、ack_catchup(传 1 时补发完成后返回 catchup_complete,默认 0)。
{
  "type": "group_owner_message",
  "id": 12345,
  "source": "telegram",
  "group_name": "孙哥聊天",
  "owner_name": "孙嘉良0xSun",
  "sender_name": "孙嘉良0xSun",
  "message_type": "text",
  "content": "群主发言内容",
  "image_url": null,
  "reply_user": null,
  "reply_content": null,
  "created_at": "2026-05-25T10:03:00",
  "received_at": "2026-05-25T10:03:00"
}
WS

7. TG Call 实时推送

连接后先返回最近历史消息,随后按间隔轮询新 TG Call。支持按频道筛选。

wss://juhequn.com/ws/new_tg_call?token=YOUR_TOKEN
可选参数:channels(按频道筛选,逗号分隔多个频道 key)、channel / channel_key(按频道筛选,可重复传多个)、last_id(断点续传游标)、history(连接后补发的历史条数,默认 20,范围 0-200)、interval(轮询间隔秒数,默认 3,范围 0.5-10)。
{
  "type": "new_tg_call",
  "id": 12345,
  "channel_key": "example_call_channel",
  "channel_name": "示例 TG Call",
  "sender_name": "Caller",
  "message_type": "text",
  "content": "call 内容",
  "ca_values": ["0x123..."],
  "urls": ["https://example.com"],
  "created_at": "2026-06-01T10:03:00"
}
WS

8. TG 快讯实时推送

连接后先返回最近快讯历史消息,随后按间隔轮询新增快讯。事件只来自 TG 快讯新表,不混入 CA/HTTP 聚合表。

wss://juhequn.com/ws/tg_newsflash?token=YOUR_TOKEN
可选参数:last_id(断点续传游标)、history(连接后补发的历史条数,默认 20,范围 0-200)、interval(轮询间隔秒数,默认 3,范围 0.5-10)。
{
  "type": "tg_newsflash",
  "id": 12345,
  "source_key": "tg_newsflash_blockbeats",
  "source_name": "区块律动",
  "sender_name": "区块律动",
  "message_type": "text",
  "content": "快讯内容",
  "urls": ["https://example.com"],
  "image_urls": [],
  "created_at": "2026-06-01T10:03:00"
}
WS

9. 币圈交易博主实时推送

连接后接收新增币圈交易博主记录。该接口只推送连接后的新数据,不返回历史消息。

wss://juhequn.com/ws/second_kol?token=YOUR_TOKEN
{
  "type": "new_second_kol",
  "data": {
    "id": 12345,
    "kol_name": "柳玉东",
    "content": "博主内容",
    "token": "BTC",
    "image_urls": ["https://example.com/image.jpg"],
    "sent_at": "2026-06-01T10:03:00",
    "created_at": "2026-06-01T10:03:05"
  },
  "timestamp": "2026-06-01T10:03:05"
}
WS

10. 美股博主实时推送

连接后接收新增美股博主记录。数据结构与币圈交易博主一致,消息类型为 new_us_stock_kol。

wss://juhequn.com/ws/us_stock_kol?token=YOUR_TOKEN
{
  "type": "new_us_stock_kol",
  "data": {
    "id": 12345,
    "kol_name": "柳玉东",
    "content": "美股博主内容",
    "token": "ETH",
    "image_urls": ["https://example.com/image.jpg"],
    "sent_at": "2026-06-01T10:03:00",
    "created_at": "2026-06-01T10:03:05"
  },
  "timestamp": "2026-06-01T10:03:05"
}
WS

11. 已开盘MEME 推送

接收 7 链已开盘 MEME 快照,支持看板实时刷新。

wss://juhequn.com/ws/gmgn_trenches?token=YOUR_TOKEN
{
  "type": "gmgn_trenches",
  "data": {
    "chain": "sol",
    "ca": "CA...",
    "symbol": "TOKEN",
    "market_cap": "120K"
  }
}
WS

12. MEME 喊单实时推送

推送上线后写入本站数据库的 GMGN 全局喊单事件。默认只推送连接后的新增记录;可通过 history 或 last_id 回放。

wss://juhequn.com/ws/gmgn_callouts?token=YOUR_TOKEN
可选参数:last_id(断点续传游标)、history(连接后补发的历史条数,默认 0 即不补发,范围 0-200)、interval(轮询间隔秒数,默认 2,范围 0.5-10)。
{
  "type": "gmgn_callout",
  "id": 12345,
  "source_id": 85580,
  "chain": "bsc",
  "call_wallet": "0x...",
  "call_token": "0x...",
  "call_thesis": "喊单逻辑",
  "token_symbol": "TOKEN",
  "create_time": 1785494320680
}
WS

13. FOMO监控(前50盈利账号)实时推送

推送手工白名单账号的买入、卖出、换仓、喊单、共识、现金和官方验证事件。

wss://juhequn.com/ws/fomo_callouts?token=YOUR_TOKEN
可选参数:last_id(断点续传游标)、history(连接后补发的历史条数,默认 20,范围 0-200)、interval(轮询间隔秒数,默认 2,范围 0.5-10)。
{ "type": "fomo_callout", "action_type": "buy", "amount_usd": 747.69, "handle": "sencrazy" }
WS

14. pump.fun 实时推送

推送 pump.fun 目录账号的喊单、跟进、买入和卖出事件。

wss://juhequn.com/ws/pump_callouts?token=YOUR_TOKEN
可选参数:last_id(断点续传游标)、history(连接后补发的历史条数,默认 20,范围 0-200)、interval(轮询间隔秒数,默认 2,范围 0.5-10)。
{ "type": "pump_callout", "action_type": "callout", "content_text": "3x send it higher" }
WS

15. EVM 链上钱包监控实时推送

推送链上监控钱包(冷静/王小二/镭射猫等)的买入、卖出、销毁和转出事件(platform=evm)。

wss://juhequn.com/ws/evm_callouts?token=YOUR_TOKEN
可选参数:last_id(断点续传游标)、history(连接后补发的历史条数,默认 20,范围 0-200)、interval(轮询间隔秒数,默认 2,范围 0.5-10)。
{ "type": "evm_callout", "action_type": "buy", "handle": "0xeb89...", "author_name": "冷静", "symbol": "SI", "chain": "bsc" }
WS

16. Wind X 实时推文

推送 Wind 采集的 X 账号动态,支持历史补发、断点续传和按间隔轮询。

wss://juhequn.com/ws/wind_x?token=YOUR_TOKEN
可选参数:last_id(断点续传游标)、history(连接后补发的历史条数,默认 20,范围 0-200)、interval(轮询间隔秒数,默认 2,范围 0.5-10)。
{ "type": "wind_x", "id": 12345, "action": "tweet", "action_label": "推文", "handle": "binance", "content_text": "X 内容", "source_url": "https://x.com/binance/status/123" }
WS

17. 聪明钱/KOL 信号实时推送

推送采集入库的 GMGN 聪明钱(smartmoney)与 KOL 钱包买卖事件,data 与 REST /api/v1/gmgn_signals/latest 行同口径,含 group_mention_count(近 24h 群聊提及次数)。

wss://juhequn.com/ws/gmgn_signals?token=YOUR_TOKEN
可选参数:history(连接后补发的历史条数,默认 0 即不补发,范围 0-200,补发消息带 replay: true)。
{ "type": "gmgn_signal", "data": { "id": 12345, "source": "smartmoney", "chain": "sol", "side": "buy", "symbol": "TOKEN", "maker": "wallet...", "amount_usd": "1234.56", "group_mention_count": 3 } }
WS

18. 群聊电台(TTS 朗读)订阅

订阅后服务端把群聊新消息合成语音并推送音频 URL(mp3,TTL 10 分钟)。连接后客户端发送 subscribe 指定群列表与音色偏好;音频经 /radio/audio/<uuid>.mp3 获取。本路由由独立单 worker 实例(ai-radio)提供。

wss://juhequn.com/ws/radio?token=YOUR_TOKEN
客户端发送:{ "subscribe": ["0xSun群", "群主发言"], "voice_mode": "single", "voice": "zh-CN-XiaoxiaoNeural", "group_voices": {}, "owner_speakers": null }
{ "type": "audio", "group": "0xSun群", "audio": "/radio/audio/<uuid>.mp3", "text": "朗读文本", "sender": "发送人" }

试一试 — WebSocket 测试

未连接
--:--:-- 等待连接...