پرش به مطلب اصلی

دریافت معاملات انجام‌شده (Trade)​

کانال @trade اطلاعات لحظه‌ای مربوط به معاملات انجام‌شده در بازار انتخاب‌شده را فراهم می‌کند. این داده‌ها برای تحلیل رفتار بازار، ساخت نمودار تیک (Tick Chart)، و الگوریتم‌های معاملاتی با حساسیت بالا نسبت به قیمت بسیار کاربردی هستند.

هر پیامی که در این کانال دریافت می‌کنید نمایانگر یک معامله‌ی است که بین خریدار و فروشنده اتفاق افتاده است.

آدرس اتصال WebSocket​

برای اتصال باید از آدرس زیر استفاده کنید

wss://api.wallex.ir/ws

فرمت پیام Subscribe​

برای دریافت معاملات انجام‌شده در هر بازار باید پیام خود را با فرمت زیر ارسال کنید و میتوانید هر مارکتی را جایگزین MARKET قرار دهید

["subscribe", { "channel": "MARKET@trade" }]

مثال

["subscribe", { "channel": "َUSDTTMN@trade" }]
["subscribe", { "channel": "َBTCUSDT@trade" }]

نمونه پاسخ دریافتی​

پس از ارسال پیام در سوکت ، جواب هایی که دریافت میکنید به‌صورت زیر میباشد که هر آبجکت بیانگر یک معامله انجام‌شده میباشد.

فیلدنوعتوضیح
isBuyOrderBooleanنشان می‌دهد آیا این معامله در سمت خرید انجام شده است یا فروش
quantityString (decimal)مقدار معامله‌شده
priceString (decimal)قیمت انجام معامله
timestampISO 8601 Stringزمان دقیق انجام معامله
[
  "USDTTMN@trade",
  {
    "isBuyOrder": true,
    "quantity": "255.7500000000000000",
    "price": "82131.0000000000000000",
    "timestamp": "2025-06-01T09:33:41Z"
  }
]