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); // قیمت و مقدار
};
جریان depth فقط تغییرات را میفرستد. دفتر کامل از یک اسنپشات 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 صرافی، هشدارها، داشبوردها | Genesis API با REST و پولینگ بهاندازهٔ تازگی پلن |
با Genesis API نمیتوان معامله کرد: سفارشها با API خود صرافی و با مسئولیت خودتان ثبت میشوند.
همچنین ببینید: تأخیر، وبهوک، APIهای دفتر سفارش، API ارز دیجیتال: انواع و نحوهٔ انتخاب.
پرسش و پاسخ
آیا Genesis API وبسوکت دارد؟
خیر. همهٔ درخواستها فراخوانی HTTP GET به یک REST API با پاسخ JSON هستند و تازگی داده به پلن بستگی دارد: 60، 30، 10 یا 5 ثانیه.