API & WEBSOCKET

让信息流，
接入你的工作流。

把 CA 追踪、社群总结、KOL 观点与实时快讯接入研究脚本、数据看板或 AI Agent。按需查询历史内容，也可以持续订阅新消息。

开始接入 →浏览接口目录

27 常用 HTTP 查询15 实时订阅JSON · TOKEN AUTH

01 / HTTP API

需要时，查询一份数据。

按地址、来源、时间或标的筛选。适合历史回查、数据整理和定时研究任务。

CA · 总结 · KOL · 美股 · 快讯

02 / WEBSOCKET

有更新，接收一条消息。

保持连接，接收新 CA、群主发言与其他实时事件。部分通道支持历史补发。

实时推送 · 分类订阅 · 消息事件

01快速开始

先验证鉴权，再选择数据接口

01获取接入信息联系客服确认接入地址、Token 与已开通权限。

02配置本地环境将地址和 Token 写入环境变量，先查询 Token 使用情况。

03接入目标数据选择查询接口或实时通道，按参数表设置筛选条件。

cURL · 终端

# 替换为开通时提供的接入地址与 Token
export API_BASE_URL="YOUR_HTTPS_API_BASE_URL"
export API_TOKEN="YOUR_API_TOKEN"

# 查询当前 Token 的使用情况
curl --get "$API_BASE_URL/api/v1/token/usage" \
  -H "Authorization: Bearer $API_TOKEN"

使用 Python 标准库接入

使用相同的 API_BASE_URL 与 API_TOKEN 环境变量。

Python · urllib

import json
import os
from urllib.request import Request, urlopen

base_url = os.environ["API_BASE_URL"].rstrip("/")
request = Request(
    base_url + "/api/v1/token/usage",
    headers={"Authorization": "Bearer " + os.environ["API_TOKEN"]},
)
with urlopen(request, timeout=20) as response:
    print(json.load(response))

02地址与鉴权

HTTP: API_BASE_URL + /api/v1/…
Authorization: Bearer YOUR_API_TOKEN
实时订阅: WS_BASE_URL + /ws/…?token=YOUR_API_TOKEN

接入地址与 Token 在开通时提供。示例中的 API_BASE_URL、WS_BASE_URL 和 YOUR_API_TOKEN 都需要替换。联系接入客服 ↗

Token 放在你自己的运行环境中管理，不要写入公开仓库或公开网页。HTTP 使用请求头鉴权；WebSocket 使用连接参数鉴权。

03接口目录

展开接口，查看参数与示例

这里整理常用的读取接口与实时通道。每个通道的历史回放和筛选能力不同，请以对应条目的说明为准。

42 个接口

HTTP / CA 追踪

GETCA 列表/api/v1/group_ca

按 CA、用户、群组或日期检索记录。

参数	位置 / 类型	说明
ca	query string \| null	筛选合约地址。
group_name	query string \| null	筛选社群名称。
username	query string \| null	筛选用户名称。
date	query string \| null	指定日期，格式 YYYY-MM-DD。格式：date
skip	query integer	跳过的记录数。默认：`0` 最小值：0
limit	query integer	最多返回的记录数。默认：`100` 最小值：1 最大值：1000

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
id	integer	是
ca	string \| null	是
username	string	是
group_name	string	是
create_time	string	是
symbol	string \| null	可选
chain	string \| null	可选
token_name	string \| null	可选
market_cap	string \| null	可选
first_market_cap	string \| null	可选
age	integer \| null	可选
total_mentions	integer \| null	可选
x_mention_count	integer \| null	可选
twitter	string \| null	可选
telegram	string \| null	可选
website	string \| null	可选
image_url	string \| null	可选
icon	string \| null	可选
summary	string \| null	可选
m5_buys	integer \| null	可选
h1_buys	integer \| null	可选
h6_buys	integer \| null	可选
h24_buys	integer \| null	可选
user_content	string \| null	可选
has_discussion	boolean \| null	可选
discussion_count	integer \| null	可选
liquidity	number \| null	可选
volume_24h	number \| null	可选
mc_change	object \| null	可选
fomo_holdings_pct	number \| null	可选
fomo_holders	integer \| null	可选
holders_onchain	integer \| null	可选
fomo_thesis_count	integer \| null	可选

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/group_ca" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=100"

GETCA 来源/api/v1/group_ca/by-ca/{ca_address}

查找一个合约地址出现过的群组。

参数	位置 / 类型	说明
ca_address 必填	path string	完整合约地址。

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/group_ca/by-ca/YOUR_CA_ADDRESS" \
  -H "Authorization: Bearer $API_TOKEN"

GET热门 CA/api/v1/group_ca/popular

按日期或滚动小时窗口统计 CA 热度，按提及次数排序。

参数	位置 / 类型	说明
date	query string \| null	指定日期，格式 YYYY-MM-DD。格式：date
hours	query integer	最近多少小时；不传时按该接口默认行为处理。默认：`24` 最小值：1 最大值：96
min_count	query integer	提及次数的下限。默认：`10` 最小值：1
group_name	query string \| null	筛选社群名称。
include_discussion	query boolean	是否返回讨论内容等大字段。默认：`true`
limit	query integer	最多返回的记录数。默认：`35` 最小值：1

这是热门榜，最多返回 35 条。更大的 limit 会按 35 处理。
此路由不分页，page、size、offset、skip 会被忽略。
date 存在时按指定日期统计；不传 date 时使用 hours 滚动窗口。

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/group_ca/popular" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=35"

GET最新 CA/api/v1/group_ca/latest

读取近期入库的 CA。

参数	位置 / 类型	说明
hours	query integer \| null	最近多少小时；不传时按该接口默认行为处理。最小值：1 最大值：8760
before_id	query integer \| null	返回 ID 小于该值的较早记录。
limit	query integer	最多返回的记录数。默认：`1` 最小值：1 最大值：100
include_discussion	query boolean	是否返回讨论内容等大字段。默认：`false`

按 ID 从大到小返回。翻页时将上一页的最小 ID 作为 before_id。
page、size、offset、skip 不参与分页。

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
id	integer	是
ca	string \| null	是
username	string	是
group_name	string	是
create_time	string	是
symbol	string \| null	可选
chain	string \| null	可选
token_name	string \| null	可选
market_cap	string \| null	可选
first_market_cap	string \| null	可选
age	integer \| null	可选
total_mentions	integer \| null	可选
x_mention_count	integer \| null	可选
twitter	string \| null	可选
telegram	string \| null	可选
website	string \| null	可选
image_url	string \| null	可选
icon	string \| null	可选
summary	string \| null	可选
m5_buys	integer \| null	可选
h1_buys	integer \| null	可选
h6_buys	integer \| null	可选
h24_buys	integer \| null	可选
user_content	string \| null	可选
has_discussion	boolean \| null	可选
discussion_count	integer \| null	可选
liquidity	number \| null	可选
volume_24h	number \| null	可选
mc_change	object \| null	可选
fomo_holdings_pct	number \| null	可选
fomo_holders	integer \| null	可选
holders_onchain	integer \| null	可选
fomo_thesis_count	integer \| null	可选

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/group_ca/latest" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=1"

GET用户 CA 记录/api/v1/group_ca/by-username/{username}

查询指定用户的 CA，最多返回 50 条。

参数	位置 / 类型	说明
username 必填	path string	筛选用户名称。
limit	query integer	最多返回的记录数。默认：`50` 最小值：1 最大值：50

按发布时间从新到旧返回，上限为 50 条。

响应字段 · object

JSON 对象；下列为声明的顶层字段。

字段	类型	是否必有
username	string	是
total_cas	integer	是
cas	array<object>	是

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/group_ca/by-username/YOUR_USERNAME" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=50"

HTTP / HTTP 链接

GET链接列表/api/v1/group_http

读取聚合的 HTTP 链接。

参数	位置 / 类型	说明
group_name	query string \| null	筛选社群名称。
hours	query integer \| null	最近多少小时；不传时按该接口默认行为处理。最小值：1 最大值：8760
before_id	query integer \| null	返回 ID 小于该值的较早记录。
limit	query integer	最多返回的记录数。默认：`20` 最小值：1 最大值：100
skip	query integer	跳过的记录数。默认：`0` 最小值：0
include_discussion	query boolean	是否返回讨论内容等大字段。默认：`false`
dedupe_site	query boolean	按站点去重，只保留各站点最新记录。默认：`false`
site	query string \| null	筛选站点 key；设置后忽略 dedupe_site。
date	query string \| null	指定日期，格式 YYYY-MM-DD。格式：date

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
id	integer	是
username	string	是
group_name	string	是
create_time	string \| null	可选
http	string \| null	可选
name	string \| null	可选
description	string \| null	可选
member_count	integer \| null	可选
community_id	string \| null	可选
user_content	array<unspecified> \| string \| null	可选
summary	string \| null	可选
x_content	string \| null	可选
liquidity	number \| null	可选
volume_24h	number \| null	可选
total_mentions	integer \| null	可选
x_mention_count	integer \| null	可选
has_discussion	boolean \| null	可选
discussion_count	integer \| null	可选
from_tweet	boolean \| null	可选
tweet_id	string \| null	可选
tweet_url	string \| null	可选
tweet_created_at	integer \| null	可选
author_screen_name	string \| null	可选
author_name	string \| null	可选
site_key	string \| null	可选
site_record_count	integer \| null	可选

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/group_http" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=20"

GET热门链接/api/v1/popular_http

查看受到关注的 HTTP 链接。

参数	位置 / 类型	说明
hours	query integer	最近多少小时；不传时按该接口默认行为处理。默认：`48` 最小值：1 最大值：720
min_count	query integer	提及次数的下限。默认：`1` 最小值：1 最大值：1000
limit	query integer	最多返回的记录数。默认：`20` 最小值：1 最大值：100
skip	query integer	跳过的记录数。默认：`0` 最小值：0
include_discussion	query boolean	是否返回讨论内容等大字段。默认：`true`

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
http	string \| null	可选
name	string \| null	可选
description	string \| null	可选
member_count	integer \| null	可选
community_id	string \| null	可选
summary	string \| null	可选
user_content	array<unspecified> \| string \| null	可选
x_content	string \| null	可选
total_mentions	integer \| null	可选
x_mention_count	integer \| null	可选
tweet_count	integer \| null	可选
last_seen_at	integer \| null	可选
has_discussion	boolean \| null	可选
discussion_count	integer \| null	可选
from_tweet	boolean \| null	可选
tweet_id	string \| null	可选
tweet_url	string \| null	可选
tweet_created_at	integer \| null	可选
author_screen_name	string \| null	可选
author_name	string \| null	可选

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/popular_http" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=20"

HTTP / 群聊总结

GETAI 总结/api/v1/summaries

读取群聊总结。

参数	位置 / 类型	说明
group_name	query string \| null	筛选社群名称。
start_date	query string \| null	开始日期。使用 ISO 8601 日期时间。格式：date-time
end_date	query string \| null	结束日期。使用 ISO 8601 日期时间。格式：date-time
date	query string \| null	指定日期，格式 YYYY-MM-DD。格式：date
skip	query integer	跳过的记录数。默认：`0` 最小值：0
limit	query integer	最多返回的记录数。默认：`20` 最小值：1 最大值：1000

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
id	integer	是
group_name	string	是
content	string	是
create_at	string	是

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/summaries" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=20"

GET每日叙事/api/v1/summaries/narratives

查看按日整理的叙事内容。

参数	位置 / 类型	说明
date	query string \| null	指定日期，格式 YYYY-MM-DD。格式：date
group_name	query string \| null	筛选社群名称。
limit	query integer	最多返回的记录数。默认：`10` 最小值：1 最大值：100

不传 date 时，在最新 300 条记录中统计；设置 date 后查询该日记录。
按 CA 出现频次选择叙事内容，最多返回 limit 条。

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
ca	string	是
summary	string \| null	可选
count	integer	可选

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/summaries/narratives" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=10"

HTTP / KOL 观点

GET币圈 KOL 内容/api/v1/second_kol

读取二级交易 KOL 内容。

参数	位置 / 类型	说明
kol_name	query string \| null	筛选博主名称。
token	query string \| null	筛选代币符号或标的；这里不是用于鉴权的 API Token。
start_date	query string \| null	开始日期。格式 YYYY-MM-DD。格式：date
end_date	query string \| null	结束日期。格式 YYYY-MM-DD。格式：date
limit	query integer	最多返回的记录数。默认：`50` 最小值：1 最大值：500
skip	query integer	跳过的记录数。默认：`0` 最小值：0

按 sent_at 从新到旧返回；服务端会过滤包含屏蔽词的内容。

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
id	integer \| null	可选
kol_name	string	是
content	string \| null	是
token	string \| null	是
image_urls	array<string> \| null	是
icon_url	string \| null	是
sent_at	string	是
created_at	string \| null	可选

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/second_kol" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=50"

GET最新币圈 KOL 内容/api/v1/second_kol/latest

读取最新二级 KOL 记录。

参数	位置 / 类型	说明
hours	query integer \| null	最近多少小时；不传时按该接口默认行为处理。最小值：1 最大值：8760
before_id	query integer \| null	返回 ID 小于该值的较早记录。
limit	query integer	最多返回的记录数。默认：`10` 最小值：1 最大值：100

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
id	integer \| null	可选
kol_name	string	是
content	string \| null	是
token	string \| null	是
image_urls	array<string> \| null	是
icon_url	string \| null	是
sent_at	string	是
created_at	string \| null	可选

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/second_kol/latest" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=10"

GET币圈 KOL 名单/api/v1/second_kol/kol_names

读取可查询的 KOL 名称。

除鉴权请求头外，没有额外的路径或查询参数。

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
kol_name	string	是
count	integer	是

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/second_kol/kol_names" \
  -H "Authorization: Bearer $API_TOKEN"

GET美股 KOL 内容/api/v1/us_stock_kol

读取美股博主内容。

参数	位置 / 类型	说明
kol_name	query string \| null	筛选博主名称。
token	query string \| null	筛选代币符号或标的；这里不是用于鉴权的 API Token。
start_date	query string \| null	开始日期。格式 YYYY-MM-DD。格式：date
end_date	query string \| null	结束日期。格式 YYYY-MM-DD。格式：date
limit	query integer	最多返回的记录数。默认：`50` 最小值：1 最大值：500
skip	query integer	跳过的记录数。默认：`0` 最小值：0

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
id	integer \| null	可选
kol_name	string	是
content	string \| null	是
token	string \| null	是
image_urls	array<string> \| null	是
icon_url	string \| null	是
sent_at	string	是
created_at	string \| null	可选
mentioned_tokens	unspecified \| null	可选
mentioned_token_fields	object \| null	可选

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/us_stock_kol" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=50"

GET最新美股 KOL 内容/api/v1/us_stock_kol/latest

读取最新美股博主记录。

参数	位置 / 类型	说明
hours	query integer \| null	最近多少小时；不传时按该接口默认行为处理。最小值：1 最大值：8760
before_id	query integer \| null	返回 ID 小于该值的较早记录。
limit	query integer	最多返回的记录数。默认：`10` 最小值：1 最大值：100

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
id	integer \| null	可选
kol_name	string	是
content	string \| null	是
token	string \| null	是
image_urls	array<string> \| null	是
icon_url	string \| null	是
sent_at	string	是
created_at	string \| null	可选
mentioned_tokens	unspecified \| null	可选
mentioned_token_fields	object \| null	可选

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/us_stock_kol/latest" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=10"

GET指定美股 KOL/api/v1/us_stock_kol/kol/{kol_name}

按博主名称查询内容。

参数	位置 / 类型	说明
kol_name 必填	path string	筛选博主名称。
limit	query integer	最多返回的记录数。默认：`50` 最小值：1 最大值：200
skip	query integer	跳过的记录数。默认：`0` 最小值：0

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
id	integer \| null	可选
kol_name	string	是
content	string \| null	是
token	string \| null	是
image_urls	array<string> \| null	是
icon_url	string \| null	是
sent_at	string	是
created_at	string \| null	可选
mentioned_tokens	unspecified \| null	可选
mentioned_token_fields	object \| null	可选

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/us_stock_kol/kol/YOUR_KOL_NAME" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=50"

GET美股 KOL 名单/api/v1/us_stock_kol/kol_names

读取可查询的美股博主名称。

除鉴权请求头外，没有额外的路径或查询参数。

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
kol_name	string	是
count	integer	是

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/us_stock_kol/kol_names" \
  -H "Authorization: Bearer $API_TOKEN"

HTTP / 美股查询

GET美股看板汇总/api/v1/us_stock_kol/board/summary

获取标的汇总、热门 Ticker 与最新观点。

参数	位置 / 类型	说明
kol_name	query string \| null	筛选博主名称。
keyword	query string \| null	匹配 Ticker、博主、内容或推文 ID 等关键词。
days	query integer \| null	最近多少天。最小值：1 最大值：365
token	query string \| null	筛选代币符号或标的；这里不是用于鉴权的 API Token。
limit	query integer	最多返回的记录数。默认：`30` 最小值：1 最大值：200

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/us_stock_kol/board/summary" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=30"

GET单个美股标的/api/v1/us_stock_kol/board/token/{token_symbol}

查询指定标的及提及记录。

参数	位置 / 类型	说明
token_symbol 必填	path string	美股代码。
kol_name	query string \| null	筛选博主名称。
keyword	query string \| null	匹配博主、内容或推文 ID 等关键词。
days	query integer \| null	最近多少天。最小值：1 最大值：365
limit	query integer	最多返回的记录数。默认：`50` 最小值：1 最大值：300

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/us_stock_kol/board/token/AAPL" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=50"

GET美股 K 线/api/v1/us_stock_kol/board/token/{token_symbol}/kline

获取指定标的的 K 线。

参数	位置 / 类型	说明
token_symbol 必填	path string	美股代码。
kol_name	query string \| null	筛选博主名称。
keyword	query string \| null	匹配博主、内容或推文 ID 等关键词。
days	query integer \| null	最近多少天。最小值：1 最大值：365
interval	query string	K 线周期：1m、5m、15m、30m、1h、4h、1d。默认：`1h` 可选：`1m` / `5m` / `15m` / `30m` / `1h` / `4h` / `1d`
limit	query integer	最多返回的记录数。默认：`120` 最小值：1 最大值：300

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/us_stock_kol/board/token/AAPL/kline" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=120"

HTTP / 快讯

GET今日快讯/api/v1/newsflash/today

查询当天快讯。

参数	位置 / 类型	说明
limit	query integer	最多返回的记录数。默认：`100` 最小值：1 最大值：1000
skip	query integer	跳过的记录数。默认：`0` 最小值：0

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
add_time	integer	是
content	string	是
url	string \| null	可选

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/newsflash/today" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=100"

GET指定日期快讯/api/v1/newsflash/date/{date}

按日期读取快讯。

参数	位置 / 类型	说明
date 必填	path string	指定日期，格式 YYYY-MM-DD。
limit	query integer	最多返回的记录数。默认：`100` 最小值：1 最大值：1000
skip	query integer	跳过的记录数。默认：`0` 最小值：0

请使用 YYYY-MM-DD 日期。

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
add_time	integer	是
content	string	是
url	string \| null	可选

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/newsflash/date/2026-09-21" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=100"

GET最新快讯/api/v1/newsflash/latest

读取最近快讯。

参数	位置 / 类型	说明
limit	query integer	最多返回的记录数。默认：`20` 最小值：1 最大值：100

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
add_time	integer	是
content	string	是
url	string \| null	可选

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/newsflash/latest" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=20"

HTTP / 群主发言

GET群主名单/api/v1/group_owner_messages/owners

获取可用于筛选的群主名称。

参数	位置 / 类型	说明
days	query integer	最近多少天。默认：`30` 最小值：1 最大值：365
limit	query integer	最多返回的记录数。默认：`200` 最小值：1 最大值：500
configured_only	query boolean	只列出配置中启用的群主与关注用户。默认：`false`

响应字段 · array

JSON 数组；下列字段属于每一条记录。

字段	类型	是否必有
name	string	是
username	string \| null	可选
display_name	string \| null	可选
count	integer	是
latest_at	string \| null	可选
sector	string \| null	可选

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/group_owner_messages/owners" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "days=30" \
  --data-urlencode "limit=200"

HTTP / 通知

GET通知配置/api/v1/notifications/config

读取当前 Token 的通知渠道与规则。

除鉴权请求头外，没有额外的路径或查询参数。

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/notifications/config" \
  -H "Authorization: Bearer $API_TOKEN"

GET通知选项/api/v1/notifications/options

读取规则可用选项。

参数	位置 / 类型	说明
days	query integer	最近多少天。默认：`30` 最小值：1 最大值：365
limit	query integer	最多返回的记录数。默认：`300` 最小值：1 最大值：1000

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/notifications/options" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "days=30" \
  --data-urlencode "limit=300"

GET通知历史/api/v1/notifications/history

查看已触发通知的记录。

参数	位置 / 类型	说明
limit	query integer	最多返回的记录数。默认：`50` 最小值：1 最大值：200

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/notifications/history" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data-urlencode "limit=50"

HTTP / 系统

GETToken 使用量/api/v1/token/usage

查询 Token 的调用次数。

除鉴权请求头外，没有额外的路径或查询参数。
返回每日上限、今日用量、剩余额度与重置时间。
按返回的 reset_time 确认重置时间；次日 0 点的说明没有标注时区。

响应字段 · object

JSON 对象；下列为声明的顶层字段。

字段	类型	是否必有
token	string	是
token_name	string \| null	是
expires_at	string \| null	是
daily_limit	integer	是
used_today	integer	是
remaining_today	integer	是
reset_time	string	是

请求示例 · 先配置接入地址和 Token# 链接

cURL

curl --get "$API_BASE_URL/api/v1/token/usage" \
  -H "Authorization: Bearer $API_TOKEN"

WebSocket / 实时消息通道

WS全局新 CA/ws/new_ca

接收新入库的 CA。

事件类型：new_ca

参数	位置 / 类型	说明
token 必填	query string	API Token；连接 URL 中传入，展示或分享 URL 前请移除。
last_id	query integer	上次已处理记录的 ID，用于请求断线后的记录。
ack_catchup	query integer	设为 1，请求补发结束的 catchup_complete 控制消息。默认：`0` 可选：`0` / `1`

提供 last_id 时，先按数据库 ID 升序补齐该游标之后的全部 CA，再进入实时阶段。
客户端可每 30 秒发送文本 ping 作为心跳。
示例仅展示 type、data.ca 与 data.group_name。

连接示例 · 替换接入地址和 Token# 链接

JavaScript

const WS_BASE_URL = "YOUR_WS_BASE_URL"; // 开通时提供的 wss:// 接入地址
const token = "YOUR_API_TOKEN";
const url = new URL("/ws/new_ca", WS_BASE_URL);
url.searchParams.set("token", token);

const ws = new WebSocket(url);
let heartbeat;
ws.addEventListener("open", () => {
  heartbeat = setInterval(() => {
    if (ws.readyState === WebSocket.OPEN) ws.send("ping");
  }, 30000);
});
ws.addEventListener("close", () => clearInterval(heartbeat));
ws.addEventListener("message", ({ data }) => {
  if (data === "pong") return;
  try { console.log(JSON.parse(data)); }
  catch { console.log(data); }
});
ws.addEventListener("error", () => console.error("连接异常，请检查接入地址与权限"));

字段示意，不代表当前数据

事件结构示例 · JSON

{
  "type": "new_ca",
  "data": {
    "ca": "示例合约地址",
    "group_name": "示例社群"
  }
}

WS热门 CA 排行/ws/popular_ca

每 30 秒收到一轮热度排行。

事件类型：popular_ca_update

参数	位置 / 类型	说明
token 必填	query string	API Token；连接 URL 中传入，展示或分享 URL 前请移除。

连接示例 · 替换接入地址和 Token# 链接

JavaScript

const WS_BASE_URL = "YOUR_WS_BASE_URL"; // 开通时提供的 wss:// 接入地址
const token = "YOUR_API_TOKEN";
const url = new URL("/ws/popular_ca", WS_BASE_URL);
url.searchParams.set("token", token);

const ws = new WebSocket(url);
ws.addEventListener("message", ({ data }) => {
  if (data === "pong") return;
  try { console.log(JSON.parse(data)); }
  catch { console.log(data); }
});
ws.addEventListener("error", () => console.error("连接异常，请检查接入地址与权限"));

字段示意，不代表当前数据

事件结构示例 · JSON

{
  "type": "popular_ca_update",
  "data": [
    {
      "ca": "示例合约地址",
      "count": 12,
      "rank": 1
    }
  ],
  "timestamp": "2026-09-21T10:00:00"
}

WS新链接/ws/new_http

接收 HTTP 链接增量，服务端每 5 秒检查一次。

事件类型：new_http

参数	位置 / 类型	说明
token 必填	query string	API Token；连接 URL 中传入，展示或分享 URL 前请移除。

只包含 http 有值且 ca 为空的记录。
X 推文中的外站链接也可进入此流。
连接后自动接收新增记录。

连接示例 · 替换接入地址和 Token# 链接

JavaScript

const WS_BASE_URL = "YOUR_WS_BASE_URL"; // 开通时提供的 wss:// 接入地址
const token = "YOUR_API_TOKEN";
const url = new URL("/ws/new_http", WS_BASE_URL);
url.searchParams.set("token", token);

const ws = new WebSocket(url);
ws.addEventListener("message", ({ data }) => {
  if (data === "pong") return;
  try { console.log(JSON.parse(data)); }
  catch { console.log(data); }
});
ws.addEventListener("error", () => console.error("连接异常，请检查接入地址与权限"));

字段示意，不代表当前数据

事件结构示例 · JSON

{
  "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-09-21T10:00:00"
  },
  "timestamp": "2026-09-21T10:00:00"
}

WS群主发言/ws/group-owner-messages

读取历史后持续接收群主消息，可筛选群组与姓名。

事件类型：group_owner_message

参数	位置 / 类型	说明
token 必填	query string	API Token；连接 URL 中传入，展示或分享 URL 前请移除。
group_name	query string	群组名称。
owner_name	query string	群主名称。
names	query string	两个参数名均可按群主筛选，支持重复传值。
name	query string	两个参数名均可按群主筛选，支持重复传值。
last_id	query integer	上次已处理记录的 ID，用于请求断线后的记录。
history	query integer	初次连接时请求的历史条数。默认：`20` 最小值：0 最大值：200
interval	query number	检查新增记录的间隔，单位秒。默认：`3` 最小值：0.5 最大值：10
ack_catchup	query integer	设为 1，请求补发结束的 catchup_complete 控制消息。默认：`0` 可选：`0` / `1`

last_id 模式持续补齐所有缺失记录；补发结束后转入轮询。
业务字段直接位于事件顶层，没有 data 包装。

连接示例 · 替换接入地址和 Token# 链接

JavaScript

const WS_BASE_URL = "YOUR_WS_BASE_URL"; // 开通时提供的 wss:// 接入地址
const token = "YOUR_API_TOKEN";
const url = new URL("/ws/group-owner-messages", WS_BASE_URL);
url.searchParams.set("token", token);

const ws = new WebSocket(url);
ws.addEventListener("message", ({ data }) => {
  if (data === "pong") return;
  try { console.log(JSON.parse(data)); }
  catch { console.log(data); }
});
ws.addEventListener("error", () => console.error("连接异常，请检查接入地址与权限"));

字段示意，不代表当前数据

事件结构示例 · JSON

{
  "type": "group_owner_message",
  "id": 12345,
  "source": "telegram",
  "group_name": "示例社群",
  "owner_name": "示例群主",
  "sender_name": "示例发送者",
  "message_type": "text",
  "content": "示例消息",
  "image_url": null,
  "reply_user": null,
  "reply_content": null,
  "created_at": "2026-09-21T10:00:00",
  "received_at": "2026-09-21T10:00:00"
}

WSTG Call/ws/new_tg_call

历史补发后接收 TG Call，可按频道筛选。

事件类型：new_tg_call

参数	位置 / 类型	说明
token 必填	query string	API Token；连接 URL 中传入，展示或分享 URL 前请移除。
channels	query string	多个频道 key 以逗号分隔。
channel	query string	频道 key；两个参数名均可重复传值。
channel_key	query string	频道 key；两个参数名均可重复传值。
last_id	query integer	上次已处理记录的 ID，用于请求断线后的记录。
history	query integer	初次连接时请求的历史条数。默认：`20` 最小值：0 最大值：200
interval	query number	检查新增记录的间隔，单位秒。默认：`3` 最小值：0.5 最大值：10

业务字段位于事件顶层。
使用 last_id 续传时，客户端应按 ID 去重并检查消息是否连续。

连接示例 · 替换接入地址和 Token# 链接

JavaScript

const WS_BASE_URL = "YOUR_WS_BASE_URL"; // 开通时提供的 wss:// 接入地址
const token = "YOUR_API_TOKEN";
const url = new URL("/ws/new_tg_call", WS_BASE_URL);
url.searchParams.set("token", token);

const ws = new WebSocket(url);
ws.addEventListener("message", ({ data }) => {
  if (data === "pong") return;
  try { console.log(JSON.parse(data)); }
  catch { console.log(data); }
});
ws.addEventListener("error", () => console.error("连接异常，请检查接入地址与权限"));

字段示意，不代表当前数据

事件结构示例 · JSON

{
  "type": "new_tg_call",
  "id": 12345,
  "channel_key": "example_channel",
  "channel_name": "示例频道",
  "sender_name": "示例发送者",
  "message_type": "text",
  "content": "示例内容",
  "ca_values": [
    "示例合约地址"
  ],
  "urls": [
    "https://example.com"
  ],
  "created_at": "2026-09-21T10:00:00"
}

WSTG 快讯/ws/tg_newsflash

接收 TG 快讯来源的历史与增量。

事件类型：tg_newsflash

参数	位置 / 类型	说明
token 必填	query string	API Token；连接 URL 中传入，展示或分享 URL 前请移除。
last_id	query integer	上次已处理记录的 ID，用于请求断线后的记录。
history	query integer	初次连接时请求的历史条数。默认：`20` 最小值：0 最大值：200
interval	query number	检查新增记录的间隔，单位秒。默认：`3` 最小值：0.5 最大值：10

仅使用 TG 快讯新表，不包含 CA/HTTP 聚合表的记录。
业务字段位于事件顶层。

连接示例 · 替换接入地址和 Token# 链接

JavaScript

const WS_BASE_URL = "YOUR_WS_BASE_URL"; // 开通时提供的 wss:// 接入地址
const token = "YOUR_API_TOKEN";
const url = new URL("/ws/tg_newsflash", WS_BASE_URL);
url.searchParams.set("token", token);

const ws = new WebSocket(url);
ws.addEventListener("message", ({ data }) => {
  if (data === "pong") return;
  try { console.log(JSON.parse(data)); }
  catch { console.log(data); }
});
ws.addEventListener("error", () => console.error("连接异常，请检查接入地址与权限"));

字段示意，不代表当前数据

事件结构示例 · JSON

{
  "type": "tg_newsflash",
  "id": 12345,
  "source_key": "example_source",
  "source_name": "示例快讯源",
  "sender_name": "示例发送者",
  "message_type": "text",
  "content": "示例快讯",
  "urls": [
    "https://example.com"
  ],
  "image_urls": [],
  "created_at": "2026-09-21T10:00:00"
}

WS币圈交易博主/ws/second_kol

接收连接之后新增的币圈 KOL 内容。

事件类型：new_second_kol

参数	位置 / 类型	说明
token 必填	query string	API Token；连接 URL 中传入，展示或分享 URL 前请移除。

只推送连接后的新增记录，不补发历史。

连接示例 · 替换接入地址和 Token# 链接

JavaScript

const WS_BASE_URL = "YOUR_WS_BASE_URL"; // 开通时提供的 wss:// 接入地址
const token = "YOUR_API_TOKEN";
const url = new URL("/ws/second_kol", WS_BASE_URL);
url.searchParams.set("token", token);

const ws = new WebSocket(url);
ws.addEventListener("message", ({ data }) => {
  if (data === "pong") return;
  try { console.log(JSON.parse(data)); }
  catch { console.log(data); }
});
ws.addEventListener("error", () => console.error("连接异常，请检查接入地址与权限"));

字段示意，不代表当前数据

事件结构示例 · JSON

{
  "type": "new_second_kol",
  "data": {
    "id": 12345,
    "kol_name": "示例博主",
    "content": "示例观点",
    "token": "BTC",
    "image_urls": [
      "https://example.com/image.jpg"
    ],
    "sent_at": "2026-09-21T10:00:00",
    "created_at": "2026-09-21T10:00:05"
  },
  "timestamp": "2026-09-21T10:00:05"
}

WS美股博主/ws/us_stock_kol

接收连接之后新增的美股 KOL 内容。

事件类型：new_us_stock_kol

参数	位置 / 类型	说明
token 必填	query string	API Token；连接 URL 中传入，展示或分享 URL 前请移除。

事件以 data 包装内容；用于接收新增记录。

连接示例 · 替换接入地址和 Token# 链接

JavaScript

const WS_BASE_URL = "YOUR_WS_BASE_URL"; // 开通时提供的 wss:// 接入地址
const token = "YOUR_API_TOKEN";
const url = new URL("/ws/us_stock_kol", WS_BASE_URL);
url.searchParams.set("token", token);

const ws = new WebSocket(url);
ws.addEventListener("message", ({ data }) => {
  if (data === "pong") return;
  try { console.log(JSON.parse(data)); }
  catch { console.log(data); }
});
ws.addEventListener("error", () => console.error("连接异常，请检查接入地址与权限"));

字段示意，不代表当前数据

事件结构示例 · JSON

{
  "type": "new_us_stock_kol",
  "data": {
    "id": 12345,
    "kol_name": "示例博主",
    "content": "示例观点",
    "token": "示例标的",
    "image_urls": [
      "https://example.com/image.jpg"
    ],
    "sent_at": "2026-09-21T10:00:00",
    "created_at": "2026-09-21T10:00:05"
  },
  "timestamp": "2026-09-21T10:00:05"
}

WS已开盘 MEME/ws/gmgn_trenches

获取已开盘 MEME 的实时快照。

事件类型：gmgn_trenches

参数	位置 / 类型	说明
token 必填	query string	API Token；连接 URL 中传入，展示或分享 URL 前请移除。

提供 7 条链的已开盘 MEME 快照。
示例仅展示部分字段。

连接示例 · 替换接入地址和 Token# 链接

JavaScript

const WS_BASE_URL = "YOUR_WS_BASE_URL"; // 开通时提供的 wss:// 接入地址
const token = "YOUR_API_TOKEN";
const url = new URL("/ws/gmgn_trenches", WS_BASE_URL);
url.searchParams.set("token", token);

const ws = new WebSocket(url);
ws.addEventListener("message", ({ data }) => {
  if (data === "pong") return;
  try { console.log(JSON.parse(data)); }
  catch { console.log(data); }
});
ws.addEventListener("error", () => console.error("连接异常，请检查接入地址与权限"));

字段示意，不代表当前数据

事件结构示例 · JSON

{
  "type": "gmgn_trenches",
  "data": {
    "chain": "sol",
    "ca": "示例合约地址",
    "symbol": "TOKEN",
    "market_cap": "120K"
  }
}

WSMEME 喊单/ws/gmgn_callouts

接收入库的 GMGN 全局喊单事件。

事件类型：gmgn_callout

参数	位置 / 类型	说明
token 必填	query string	API Token；连接 URL 中传入，展示或分享 URL 前请移除。
last_id	query integer	上次已处理记录的 ID，用于请求断线后的记录。
history	query integer	初次连接时请求的历史条数。默认：`0` 最小值：0 最大值：200
interval	query number	检查新增记录的间隔，单位秒。默认：`2` 最小值：0.5 最大值：10

默认只接收连接后的新增内容；history 或 last_id 可请求回放。
业务字段位于事件顶层。

连接示例 · 替换接入地址和 Token# 链接

JavaScript

const WS_BASE_URL = "YOUR_WS_BASE_URL"; // 开通时提供的 wss:// 接入地址
const token = "YOUR_API_TOKEN";
const url = new URL("/ws/gmgn_callouts", WS_BASE_URL);
url.searchParams.set("token", token);

const ws = new WebSocket(url);
ws.addEventListener("message", ({ data }) => {
  if (data === "pong") return;
  try { console.log(JSON.parse(data)); }
  catch { console.log(data); }
});
ws.addEventListener("error", () => console.error("连接异常，请检查接入地址与权限"));

字段示意，不代表当前数据

事件结构示例 · JSON

{
  "type": "gmgn_callout",
  "id": 12345,
  "source_id": 23456,
  "chain": "bsc",
  "call_wallet": "示例钱包",
  "call_token": "示例合约地址",
  "call_thesis": "示例说明",
  "token_symbol": "TOKEN",
  "create_time": 1789948800000
}

WSFOMO 监控/ws/fomo_callouts

接收手工白名单账号的交易、喊单、共识、现金和验证事件。

事件类型：fomo_callout

参数	位置 / 类型	说明
token 必填	query string	API Token；连接 URL 中传入，展示或分享 URL 前请移除。
last_id	query integer	上次已处理记录的 ID，用于请求断线后的记录。
history	query integer	初次连接时请求的历史条数。默认：`20` 最小值：0 最大值：200
interval	query number	检查新增记录的间隔，单位秒。默认：`2` 最小值：0.5 最大值：10

监控来源为手工白名单账号。
示例只展示部分事件字段。

连接示例 · 替换接入地址和 Token# 链接

JavaScript

const WS_BASE_URL = "YOUR_WS_BASE_URL"; // 开通时提供的 wss:// 接入地址
const token = "YOUR_API_TOKEN";
const url = new URL("/ws/fomo_callouts", WS_BASE_URL);
url.searchParams.set("token", token);

const ws = new WebSocket(url);
ws.addEventListener("message", ({ data }) => {
  if (data === "pong") return;
  try { console.log(JSON.parse(data)); }
  catch { console.log(data); }
});
ws.addEventListener("error", () => console.error("连接异常，请检查接入地址与权限"));

字段示意，不代表当前数据

事件结构示例 · JSON

{
  "type": "fomo_callout",
  "action_type": "buy",
  "amount_usd": 100,
  "handle": "example_account"
}

WSpump.fun 动态/ws/pump_callouts

接收目录账号的喊单、跟进与买卖事件。

事件类型：pump_callout

参数	位置 / 类型	说明
token 必填	query string	API Token；连接 URL 中传入，展示或分享 URL 前请移除。
last_id	query integer	上次已处理记录的 ID，用于请求断线后的记录。
history	query integer	初次连接时请求的历史条数。默认：`20` 最小值：0 最大值：200
interval	query number	检查新增记录的间隔，单位秒。默认：`2` 最小值：0.5 最大值：10

示例只展示部分事件字段。

连接示例 · 替换接入地址和 Token# 链接

JavaScript

const WS_BASE_URL = "YOUR_WS_BASE_URL"; // 开通时提供的 wss:// 接入地址
const token = "YOUR_API_TOKEN";
const url = new URL("/ws/pump_callouts", WS_BASE_URL);
url.searchParams.set("token", token);

const ws = new WebSocket(url);
ws.addEventListener("message", ({ data }) => {
  if (data === "pong") return;
  try { console.log(JSON.parse(data)); }
  catch { console.log(data); }
});
ws.addEventListener("error", () => console.error("连接异常，请检查接入地址与权限"));

字段示意，不代表当前数据

事件结构示例 · JSON

{
  "type": "pump_callout",
  "action_type": "callout",
  "content_text": "示例内容"
}

WSWind X 动态/ws/wind_x

接收 Wind 采集的 X 账号动态。

事件类型：wind_x

参数	位置 / 类型	说明
token 必填	query string	API Token；连接 URL 中传入，展示或分享 URL 前请移除。
last_id	query integer	上次已处理记录的 ID，用于请求断线后的记录。
history	query integer	初次连接时请求的历史条数。默认：`20` 最小值：0 最大值：200
interval	query number	检查新增记录的间隔，单位秒。默认：`2` 最小值：0.5 最大值：10

支持历史和游标参数，服务端按 interval 轮询。
示例只列出部分字段。

连接示例 · 替换接入地址和 Token# 链接

JavaScript

const WS_BASE_URL = "YOUR_WS_BASE_URL"; // 开通时提供的 wss:// 接入地址
const token = "YOUR_API_TOKEN";
const url = new URL("/ws/wind_x", WS_BASE_URL);
url.searchParams.set("token", token);

const ws = new WebSocket(url);
ws.addEventListener("message", ({ data }) => {
  if (data === "pong") return;
  try { console.log(JSON.parse(data)); }
  catch { console.log(data); }
});
ws.addEventListener("error", () => console.error("连接异常，请检查接入地址与权限"));

字段示意，不代表当前数据

事件结构示例 · JSON

{
  "type": "wind_x",
  "id": 12345,
  "action": "tweet",
  "action_label": "推文",
  "handle": "example_account",
  "content_text": "示例推文",
  "source_url": "https://x.com/example_account/status/123"
}

WS聪明钱 / KOL 钱包信号/ws/gmgn_signals

接收 GMGN 聪明钱和 KOL 钱包的买卖事件。

事件类型：gmgn_signal

参数	位置 / 类型	说明
token 必填	query string	API Token；连接 URL 中传入，展示或分享 URL 前请移除。
history	query integer	初次连接时请求的历史条数。默认：`0` 最小值：0 最大值：200

历史回放消息带 replay: true 标记。
group_mention_count 为过去 24 小时的群聊提及次数。
仅支持 history 参数。

连接示例 · 替换接入地址和 Token# 链接

JavaScript

const WS_BASE_URL = "YOUR_WS_BASE_URL"; // 开通时提供的 wss:// 接入地址
const token = "YOUR_API_TOKEN";
const url = new URL("/ws/gmgn_signals", WS_BASE_URL);
url.searchParams.set("token", token);

const ws = new WebSocket(url);
ws.addEventListener("message", ({ data }) => {
  if (data === "pong") return;
  try { console.log(JSON.parse(data)); }
  catch { console.log(data); }
});
ws.addEventListener("error", () => console.error("连接异常，请检查接入地址与权限"));

字段示意，不代表当前数据

事件结构示例 · JSON

{
  "type": "gmgn_signal",
  "data": {
    "id": 12345,
    "source": "smartmoney",
    "chain": "sol",
    "side": "buy",
    "symbol": "TOKEN",
    "maker": "示例钱包",
    "amount_usd": "100.00",
    "group_mention_count": 3
  }
}

WS群聊电台/ws/radio

订阅群组后接收消息朗读的音频地址。

事件类型：audio

参数	位置 / 类型	说明
token 必填	query string	API Token；连接 URL 中传入，展示或分享 URL 前请移除。

连接后发送 subscribe 消息指定群组与音色。
MP3 音频地址有效期为 10 分钟。
音频使用接入时提供的服务基址解析相对路径。

连接示例 · 替换接入地址和 Token# 链接

JavaScript

const WS_BASE_URL = "YOUR_WS_BASE_URL"; // 开通时提供的 wss:// 接入地址
const token = "YOUR_API_TOKEN";
const url = new URL("/ws/radio", WS_BASE_URL);
url.searchParams.set("token", token);

const ws = new WebSocket(url);
ws.addEventListener("open", () => {
  ws.send(JSON.stringify({
    subscribe: ["YOUR_GROUP_NAME"],
    voice_mode: "single",
    voice: "zh-CN-XiaoxiaoNeural"
  }));
});
ws.addEventListener("message", ({ data }) => {
  if (data === "pong") return;
  try { console.log(JSON.parse(data)); }
  catch { console.log(data); }
});
ws.addEventListener("error", () => console.error("连接异常，请检查接入地址与权限"));

字段示意，不代表当前数据

事件结构示例 · JSON

{
  "type": "audio",
  "group": "示例社群",
  "audio": "/radio/audio/<uuid>.mp3",
  "text": "示例朗读内容",
  "sender": "示例发送者"
}

04连接与补发

按通道能力处理，不使用同一套默认值

让连接保持活跃

按通道要求配置心跳。新 CA 示例每 30 秒发送文本 ping，且只在 OPEN 状态下发送。关闭后清理计时器；其他通道先确认支持的消息协议，再配置心跳与重连。

保存消息处理进度

对明确支持 last_id 的通道，记录成功处理的消息 ID，重连时使用该游标。按消息 ID 去重，避免把历史补发当成新的重复事件。

区分实时和历史

币圈 KOL 通道只推送连接后的新记录；部分通道可设置 history。聪明钱 / KOL 信号的补发消息带 replay: true，不能据此推断其他通道也支持游标。

确认补发结束

新 CA 和群主发言通道支持 ack_catchup=1，补发完成时可收到 catchup_complete。其他通道的补发逻辑见各自参数说明。

05常见问题

接入地址和 Token 从哪里获取？

通过本页“接入咨询”联系失眠聚合群客服，确认已开通的服务与接口权限。示例占位符不是实际凭据。

查询和实时订阅应该怎么选？

需要按条件回查或定时汇总时使用 HTTP；需要持续接收新增事件时使用 WebSocket。历史是否可补发，由各实时通道单独定义。

连接成功但暂时没有消息，正常吗？

部分通道仅发送连接之后的新数据。先核对通道权限、筛选条件以及是否支持 history，再检查是否有新事件；不要把暂时无消息当作历史为空。

能否在本页填写 Token 并直接测试？

本页提供接入说明和可复制示例，不收集 Token。请在自己的终端、脚本或应用环境中运行示例。

为什么某个接口提示无权限或请求失败？

先检查接入地址、Token 和 Authorization 请求头；再对照接口参数与已开通权限。向客服反馈状态码和错误信息时，请遮住 Token。

让信息流，接入你的工作流。

需要时，查询一份数据。

有更新，接收一条消息。

01快速开始

02地址与鉴权

03接口目录

HTTP / CA 追踪

HTTP / HTTP 链接

HTTP / 群聊总结

HTTP / KOL 观点

HTTP / 美股查询

HTTP / 快讯

HTTP / 群主发言

HTTP / 通知

HTTP / 系统

WebSocket / 实时消息通道

04连接与补发

让连接保持活跃

保存消息处理进度

区分实时和历史

确认补发结束

05常见问题

让信息流，
接入你的工作流。