دریافت معاملات انجامشده (Trade)
کانال @trade
اطلاعات لحظهای مربوط به معاملات انجامشده در بازار انتخابشده را فراهم میکند. این دادهها برای تحلیل رفتار بازار، ساخت نمودار تیک (Tick Chart)، و الگوریتمهای معاملاتی با حساسیت بالا نسبت به قیمت بسیار کاربردی هستند.
هر پیامی که در این کانال دریافت میکنید نمایانگر یک معاملهی است که بین خریدار و فروشنده اتفاق افتاده است.
آدرس اتصال WebSocket
برای اتصال باید از آدرس زیر استفاده کنید
wss://api.wallex.ir/ws
فرمت پیام Subscribe
برای دریافت معاملات انجامشده در هر بازار باید پیام خود را با فرمت زیر ارسال کنید و میتوانید هر مارکتی را جایگزین MARKET قرار دهید
["subscribe", { "channel": "MARKET@trade" }]
مثال
["subscribe", { "channel": "َUSDTTMN@trade" }]
["subscribe", { "channel": "َBTCUSDT@trade" }]
نمونه پاسخ دریافتی
پس از ارسال پیام در سوکت ، جواب هایی که دریافت میکنید بهصورت زیر میباشد که هر آبجکت بیانگر یک معامله انجامشده میباشد.
فیلد | نوع | توضیح |
---|---|---|
isBuyOrder | Boolean | نشان میدهد آیا این معامله در سمت خرید انجام شده است یا فروش |
quantity | String (decimal) | مقدار معاملهشده |
price | String (decimal) | قیمت انجام معامله |
timestamp | ISO 8601 String | زمان دقیق انجام معامله |
[
"USDTTMN@trade",
{
"isBuyOrder": true,
"quantity": "255.7500000000000000",
"price": "82131.0000000000000000",
"timestamp": "2025-06-01T09:33:41Z"
}
]
نمونه کد در زبان های مختلف
const socket = new WebSocket("wss://api.wallex.ir/ws");
socket.addEventListener("open", () => {
socket.send(JSON.stringify(["subscribe", { channel: "USDTTMN@trade" }]));
});
socket.addEventListener("message", event => {
console.log("Trade event:", event.data);
});