X/Twitter WebSocket API
面向交易机器人的选定账号 WebSocket feed：推文、更新、删除、置顶、取消置顶、资料变化、关注、取消关注、代币检测、OCR 与实时价格上下文。
无需轮询，实时监控影响市场的 X/Twitter 账号
TweetStream 通过一个 WebSocket 连接推送选定账号的提醒。被监控推文的服务器侧检测中位数为 170ms，并附带机器人或交易台需要处理的字段。
先按 t 和 op 路由：content 信封包含作者、正文、时间戳和媒体；meta 信封包含 OCR 文本以及检测到的代币、市场和价格。
机器人可以直接读取的载荷形态
[
{
"v": 1,
"t": "tweet",
"op": "content",
"id": "2064689031777615872",
"ts": 1781095200123,
"d": {
"tweetId": "2064689031777615872",
"kind": "post",
"text": "New token live. CA: 9xQeWvG816bUx9EP...",
"createdAt": 1781095199900,
"receivedAt": 1781095200108,
"author": {
"handle": "@marketdesk",
"name": "Market Account"
},
"media": [
{
"type": "image",
"url": "https://pbs.twimg.com/media/sample-token-chart.jpg"
}
]
}
},
{
"v": 1,
"t": "tweet",
"op": "meta",
"id": "2064689031777615872",
"ts": 1781095200340,
"d": {
"tweetId": "2064689031777615872",
"ocr": {
"text": "ticker $EDGE, liquidity rising"
},
"detected": {
"tokens": [
{
"symbol": "EDGE",
"contract": "9xQeWvG816bUx9EP...",
"chain": "solana",
"priceUsd": 0.0042,
"sources": ["text", "ocr"]
}
]
}
}
}
]- 使用一个 API Key 连接 wss://ws.tweetstream.io/ws
- 跟踪真正影响市场的账号，而不是抓取宽泛搜索结果
- 50 账号 X API 估算约 $1,500/月；TweetStream Basic 固定 $199/月
服务器侧检测中位数约 170ms，按生产事件时间戳计算：服务器接收时间减去推文 snowflake 时间。端到端投递会受丰富化和客户端网络影响。
3 天试用使用与付费套餐相同的检测管线，包含 5 个跟踪账号和 1 个 WebSocket 连接。试用后 Basic 含 50 个监控账号和 3 个连接，价格 $199/月，除非你在控制台管理或取消。
想先看代码？ 打开快速开始指南
WebSocket feed 包含什么
TweetStream 不是官方 X API，也不是通用社媒监听套件。它是面向选定账号与交易工作流的监控 API。
被监控账号的推文提醒与生命周期
从 watchlist 中的账号流式接收新帖子、更新、删除、置顶和取消置顶，包括作者字段、媒体、链接，以及可用的引用或回复上下文。
账号资料与关注事件
通过 account 事件包裹接收资料更新、关注和取消关注通知，无需再单独维护账号监控任务。
交易丰富化
当 TweetStream 检测到信号时，会附加 OCR、代币检测、交易所引用、预测市场检测与实时价格上下文。
实用的 WebSocket 协议
所有消息使用统一包裹结构，机器人可以路由 tweet、account 与 control 事件，而不用为每个功能写一套解析。
团队为何把 TweetStream 当作 Twitter 监控 API
- 无需调试、维护或扩容轮询循环
- 被监控推文服务器侧检测中位数 170ms
- 内置加密交易相关丰富化，减少后处理工程量
- 按被监控账号限制的固定套餐，而不是每个流程都按读取量计费
为选定账号监控流程而建
大多数加密团队并不需要所有公开帖子。他们需要少数影响价格的账号快速、干净地进入自己的系统。
- 选择账号。 添加交易台、机器人或 Discord 频道已经关注的账号。
- 打开一个 socket。 认证一次，然后接收 tweet、account 与 control 事件的实时 JSON 包裹。
- 路由信号。 把提醒送进交易逻辑、仪表盘、Discord 或历史回放，无需维护抓取栈。
几分钟内打开 WebSocket
只需要端点和协议：
WebSocket 端点： wss://ws.tweetstream.io/ws
协议： tweetstream.v1, tweetstream.auth.token.YOUR_API_KEY
查看 WebSocket 快速开始指南 获取完整示例。
适合什么场景
当速度、载荷结构和丰富化比宽泛社媒监听更重要时，用 TweetStream。如果你需要官方写入权限、合规归档或完整 X API 端点，请把官方 X API 与 TweetStream 搭配使用。
X/Twitter 监控 API 常见问题
TweetStream 是官方 X/Twitter API 吗？
不是。TweetStream 是独立的选定账号提醒 API，面向需要快速 WebSocket 投递和交易丰富化的团队。
这是所有公开推文的 WebSocket firehose 吗？
不是。TweetStream 会流式发送你配置的账号和过滤器产生的提醒，让 feed 保持聚焦，避免机器人处理大量社媒噪音。
WebSocket 可以收到哪些事件？
TweetStream 会发送推文内容、推文元数据、推文更新、可用的删除、置顶和取消置顶操作、账号资料更新、关注和取消关注事件，以及账号管理操作的 control 响应。
为什么不用轮询？
轮询会带来延迟、重试逻辑、限流处理与解析工作。TweetStream 保持一个 WebSocket 连接，并在被监控账号事件到达时主动推送。
准备开始流式传输？
测试 WebSocket 数据流准备开始流式传输？
3 天试用使用与付费套餐相同的检测管线，包含 5 个跟踪账号和 1 个 WebSocket 连接。试用后 Basic 含 50 个监控账号和 3 个连接，价格 $199/月，除非你在控制台管理或取消。
测试 WebSocket 数据流起价 $199/月 · Basic/Elite 含 3 天试用 · OCR + 代币检测