WebSocket
WebSocket — протокол постоянного двустороннего соединения поверх TCP: клиент открывает соединение один раз, а дальше сервер сам присылает сообщения, как только появляются новые данные. Протокол описан в RFC 6455 (2011), адреса начинаются с ws:// или wss:// — второй вариант шифруется TLS.
Как работает соединение
Соединение начинается с обычного HTTP-запроса с заголовком Upgrade: websocket. Сервер отвечает 101 Switching Protocols, и дальше по тому же TCP-соединению сообщения идут в обе стороны без новых запросов. Служебные кадры ping и pong проверяют, что вторая сторона на связи.
В REST API каждое обновление нужно запросить — это опрос. В WebSocket сервер присылает обновление сам, но соединение приходится держать, переподключать после обрыва и успевать обрабатывать поток.
WebSocket у бирж
Биржи отдают по WebSocket потоки сделок и изменений стакана. У Binance поток btcusdt@trade присылает каждую сделку пары BTC/USDT, а btcusdt@depth@100ms — изменения стакана раз в 100 мс (документация Binance).
// Браузер: сделки BTC/USDT с Binance, одно сообщение на сделку
const ws = new WebSocket(
'wss://stream.binance.com:9443/ws/btcusdt@trade'
);
ws.onmessage = (event) => {
const trade = JSON.parse(event.data);
console.log(trade.p, trade.q); // цена и количество
};
Поток стакана присылает только изменения. Полный стакан собирают из снимка по REST (/api/v3/depth) и событий потока, сверяя номера обновлений; пропущено событие — стакан собирают заново. Одно соединение с Binance живёт не дольше 24 часов.
WebSocket и Genesis API
У Genesis API WebSocket нет: данные отдаются по REST, а свежесть отдачи задаёт тариф — от 60 секунд на Trial до 5 секунд на Max. Потоки бирж Genesis Arbitrage собирает сам: в ответе стакана рынка поле source показывает, пришла книга по WebSocket (ws) или по REST (rest), а age_sec — её возраст в секундах.
| Задача | Что подходит |
|---|---|
| Ставить ордера и реагировать за доли секунды | WebSocket и торговый API биржи |
| Держать в памяти полный стакан одной пары | WebSocket биржи и снимок по REST |
| Искать спреды по 20+ биржам, алерты, дашборды | REST Genesis API с опросом на свежести тарифа |
Торговать через Genesis API нельзя: ордера ставятся через API самой биржи и на ваш риск.
Смотрите также: задержка, вебхук, API биржевых стаканов, API криптовалют: какие бывают и как выбрать.
Вопросы и ответы
Есть ли у Genesis API WebSocket?
Нет. Все запросы — HTTP GET к REST API с ответом в JSON, а свежесть данных зависит от тарифа: 60, 30, 10 или 5 секунд.