Skip to content

Подключение

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
}