Подключение
Last updated: November 20, 2026
- Конечная точка для подключения к основной сети:
wss://mainnet.tonstream.io/ws/v1/. - Коммуникация происходит по протоколу
JSON-RPC. - Рекомендуется использование WebSocket-расширения
permessage-deflateдля минимизации трафика.
Авторизация
Все методы стриминга доступны без API-ключа, но в этом случае они будут иметь ограниченную функциональность. Вы можете получить ключ в Telegram-боте @tonstreamapibot.
Указывать API-ключ при подключении нужно в GET-параметре api_key:
wss://mainnet.tonstream.io/ws/v1/?api_key=YOUR_API_KEY или в HTTP-заголовке X-Api-Key:
X-Api-Key: YOUR_API_KEY Активность соединения
Если сервер в течение 60 секунд не получает от вас никаких данных, он отправит PING-фрейм, на который ваш WebSocket-клиент должен ответить PONG-фреймом; в противном случае сервер закроет соединение.
В случае отсутствия поддержки PING/PONG-фреймов вы можете отправлять PING-запросы по протоколу JSON-RPC.
{
"jsonrpc": "2.0",
"method": "ping",
"params": 1234567890,
"id": 1
} Сервер ответит PONG-сообщением.
{
"jsonrpc": "2.0",
"result": 1234567890,
"id": 1
} Примечание
Значение параметра params должно быть строкой или числом.