跳转到主要内容
建立连接后,加入应用需要的房间。所有订阅使用相同的认证、加入和离开消息,以及 JSON 心跳协议。
URL: wss://datastream.solanatracker.io/{apiKey}
在路径中使用你的 Data API 密钥。适用于 Premium、Business 和 Enterprise 套餐。

连接 URL

始终连接到标准的 Datastream 主机:
Datastream 通过 WebSocket 路径中的 API 密钥进行认证。REST 基础 URL 与 Datastream 主机相互独立。

认证失败

API 密钥无效或缺失时,WebSocket 握手仍可能完成,然后几乎立即关闭,并且:
  • 没有 JSON 错误 payload
  • 没有 joined 确认
如果连接立即关闭且没有房间确认,请先检查 API 密钥和 URL,再重试。

加入和离开

心跳(JSON ping/pong)

服务端可能发送 JSON 控制帧:
回复:
请在消息处理函数中回复 JSON 心跳。它们是应用层消息,与 WebSocket 协议的 ping/pong 帧无关。

钱包余额数量

在 wallet:{wallet}:balance 和 wallet:{wallet}:{token}:balance 房间中:
  • amount 是 UI 小数(人类可读单位),不是原始整数最小单位或 lamports
  • 原生 SOL 使用 mint So11111111111111111111111111111111111111112

限制和配额

Premium+ Datastream 包含无限消息(不按消息计费)。并发 WebSocket 连接数没有限制。每个连接最多可加入 100,000 个房间;超出后,加入请求会返回 { "type": "error", "message": "Maximum number of rooms (100000) reached" }。 请及时读取到达的消息。落后超过 1 MiB 的连接会被关闭;请重新连接并再次加入房间。服务端(hub)更新不会断开你的连接,已加入的房间会保留。 REST 月度请求配额用尽时,不会断开已建立的 Datastream 会话。

下一步

实时价格

价格和 K 线房间。

代币发行

发行、毕业和市场事件。

实时风险信号

狙击者、打包者和持有人信号。

实时盈亏

钱包和仓位的实时 PnL。