Обзор протокола
Tessium Streaming API v1 использует JSON-сообщения по одному WebSocket-соединению. Одно соединение может нести несколько независимых подписок.
Эндпоинт
text
wss://api.tessium.dev/stream?key=YOUR_API_KEYМожно также аутентифицироваться первым сообщением WebSocket, если удобнее держать ключ вне URL:
json
{ "op": "auth", "key": "tsk_live_..." }Виды фреймов
op | Направление | Назначение |
|---|---|---|
auth | клиент → сервер | Аутентификация, когда ключа нет в URL |
subscribe | клиент → сервер | Открыть подписку на стрим |
unsubscribe | клиент → сервер | Остановить подписку |
ping | клиент → сервер | Проверка соединения на уровне приложения |
ack | сервер → клиент | Подтвердить команду и вернуть id подписки |
pong | сервер → клиент | Ответ на application-level ping |
event | сервер → клиент | Доставить событие стрима |
error | сервер → клиент | Отклонить команду или сообщить о сбое |
notice | сервер → клиент | Сообщить о нефатальном состоянии стрима |
Полные конверты команд — в Фреймах, поведение при переподключении — в Cursor & replay, уровни полезной нагрузки — в Уровнях детализации, все машиночитаемые коды — в Ошибках и notices.
Модель доставки
- Стримятся только успешные транзакции Solana.
- У каждого события, кроме свечей, есть общий транзакционный конверт.
blockTimeможет бытьnull, пока время блока ещё недоступно; Tessium не задерживает событие в ожидании.- Подписка на токен и подписка на кошелёк могут обе эмитить событие по одной сделке. Это разные подписки, а не дубликаты.
- Сообщения клиента ограничены 64 KB.
Версия протокола: v1. Снимок справочника: 31 июля 2026.