帖子要读，图片里的字也不能漏
feed 内置 OCR。每条帖子之后，TweetStream 会通过后续 meta 事件发送从图片中读到的文字，以及检测到的代币及其价格。截至 2026 年 9 月 30 日的 7 天内，TweetStream 检测 X 帖子的中位时间为 170 毫秒，从 X 帖子时间戳计时，到 TweetStream 服务器首次收到为止。
机器人可以直接读取的载荷形态
先按 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",
"platform": "twitter",
"ocr": {
"text": "ticker $EDGE, liquidity rising"
},
"detected": {
"tokens": [
{
"symbol": "EDGE",
"contract": "9xQeWvG816bUx9EP...",
"chain": "solana",
"priceUsd": 0.0042,
"sources": ["text", "ocr"]
}
]
}
}
}
]实时速度报告按 X 帖子发布时间到 TweetStream 服务器首次接收时间计算。为缩短收到帖子后的网络路径，请将 consumer 部署在靠近 endpoint 的区域。 打开实时速度报告
按 X 公开的按量价格，30 万 次 Post 读取约 $1,500/月；Minimum 以 $199/月覆盖 50 个监控账号。 查看 X API 成本拆解
WebSocket feed 包含什么
TweetStream 不是官方 X API，也不是通用社媒监听套件。它是面向选定账号与交易工作流的监控 API。
- 被监控账号的推文提醒与生命周期
- 从 watchlist 中的账号流式接收新帖子、更新、删除、置顶和取消置顶，包括作者字段、媒体、链接，以及可用的引用或回复上下文。
- 账号资料与关注事件
- 通过 account 事件包裹接收资料更新、关注和取消关注通知，无需再单独维护账号监控任务。
- 截图与图表内置 OCR
- 附件图片包含文字时，TweetStream 可以提取文字并通过 meta 信封发送 OCR 结果。机器人可以把这些文字与代币、市场和实时价格上下文一起处理。
- 实用的 WebSocket 协议
- 所有消息使用统一包裹结构，机器人可以路由 tweet、account 与 control 事件，而不用为每个功能写一套解析。
团队为何把 TweetStream 当作 Twitter 监控 API
- 无需调试、维护或扩容轮询循环
- 公开服务端检测方法
- 无需团队在接入后另建图片 OCR 与加密富化层
- 按被监控账号限制的固定套餐，而不是每个流程都按读取量计费
为选定账号监控流程而建
大多数加密团队并不需要所有公开帖子。他们需要少数影响价格的账号快速、干净地进入自己的系统。
- 选择账号。添加交易台、机器人或 Discord 频道已经关注的账号。
- 打开一个 socket。认证一次，然后接收 tweet、account 与 control 事件的实时 JSON 包裹。
- 路由信号。把提醒送进交易逻辑、仪表盘、Discord 或历史回放，无需维护抓取栈。
几分钟内打开 WebSocket
只需要端点和协议：
WebSocket 端点： wss://ws-global.tweetstream.io/ws
协议： tweetstream.v1, tweetstream.auth.token.YOUR_API_KEY
查看 完整 WebSocket 示例 获取可以直接下载运行的程序。
适合什么场景
当速度、载荷结构和丰富化比宽泛社媒监听更重要时，用 TweetStream。如果你需要官方写入权限、合规归档或完整 X API 端点，请把官方 X API 与 TweetStream 搭配使用。