Giao dịch gần đây

API WebSocket này cung cấp các cập nhật theo thời gian thực cho các giao dịch gần đây trên Nami Exchange.

Lấy dữ liệu giao dịch gần đây theo thời gian thực bằng socket

Tổng Quan API WebSocket này cung cấp các cập nhật theo thời gian thực cho các giao dịch gần đây trên Nami Exchange.

• URL Cơ Bản: wss://stream-asia2.nami.exchange

• Đường Dẫn: /ws

• Giao Thức: WebSocket

• Kết Nối Lại: Được kích hoạt với backoff lũy tiến

Kết Nối Để thiết lập kết nối, sử dụng cấu hình WebSocket client sau:

const socket = socketIO("https://stream-asia2.nami.exchange", {
  path: "/ws",
  upgrade: false,
  reconnection: true,
  reconnectionDelay: 100,
  reconnectionDelayMax: 500,
  reconnectionAttempts: Infinity,
  transports: ["websocket"],
});

Sự Kiện

1. Kết Nối

• Sự Kiện: connect

• Mô Tả: Được kích hoạt khi client kết nối thành công tới server WebSocket.

• Ví Dụ:

  socket.on("connect", () => {
    console.log("Đã kết nối tới server WebSocket");
  });

2. Đăng Ký Giao Dịch Gần Đây

• Sự Kiện: subscribe:recent_trade

• Mô Tả: Đăng ký nhận cập nhật giao dịch gần đây theo thời gian thực cho một cặp giao dịch cụ thể.

• Payload: string (cặp giao dịch, ví dụ: "BTCUSDT")

• Ví Dụ:

  socket.emit("subscribe:recent_trade", "BTCUSDT");

3. Nhận Cập Nhật Giao Dịch Gần Đây

• Sự Kiện: spot:recent_trade:add

• Mô Tả: Cung cấp các cập nhật giao dịch gần đây theo thời gian thực cho cặp giao dịch đã đăng ký.

• Payload: Đối tượng JSON chứa thông tin chi tiết về giao dịch.

• Ví Dụ Phản Hồi:

  {
    "S": "SELL",
    "s": "BTCUSDT",
    "p": 97548.08,
    "q": 0.000002,
    "Q": 0,
    "t": 1738817372945
  }

Các Trường Phản Hồi:

Trường	Loại	Mô Tả
S	string	Loại giao dịch (BUY hoặc SELL)
s	string	Cặp giao dịch (ví dụ: BTCUSDT)
p	number	Giá giao dịch
q	number	Số lượng giao dịch
Q	number	Trường không xác định (có thể đại diện cho metadata giao dịch bổ sung)
t	number	Thời gian giao dịch (Unix time tính bằng milliseconds)

• Ví Dụ Xử Lý:

  socket.on("spot:recent_trade:add", (data) => {
    console.log("Cập nhật giao dịch gần đây:", data);
  });

Ngắt Kết Nối & Kết Nối Lại

• WebSocket client tự động cố gắng kết nối lại với backoff lũy tiến.

• Nếu bị ngắt kết nối, nó sẽ thử lại vô thời hạn với khoảng thời gian trễ giữa 100ms - 500ms.

Ghi Chú

• Đảm bảo WebSocket client của bạn hỗ trợ các chiến lược kết nối lại để duy trì kết nối ổn định.

• Dữ liệu có thể thay đổi theo biến động thị trường và cần được xử lý phù hợp.