Độ sâu thị trường

API WebSocket này cung cấp dữ liệu cập nhật theo thời gian thực về độ sâu sổ lệnh trên Nami Exchange.

Lấy dữ liệu Độ Sâu Thị Trường Spot Theo Thời Gian Thực Qua WebSocket

Tổng Quan

API WebSocket này cung cấp dữ liệu cập nhật theo thời gian thực về độ sâu sổ lệnh trên Nami Exchange.

• Base URL: wss://stream-asia2.nami.exchange

• Đường dẫn: /ws

• Giao thức: WebSocket

• Tự động kết nối lại: Có, với chiến lược 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ả: Kích hoạt khi client kết nối thành công với WebSocket server.

• Ví dụ:

  socket.on("connect", () => {
    console.log("Kết nối thành công tới WebSocket server");
  });

2. Đăng Ký Nhận Dữ Liệu Độ Sâu Thị Trường

• Sự kiện: subscribe:depth

• Mô tả: Đăng ký nhận cập nhật sổ lệnh theo thời gian thực cho một cặp giao dịch cụ thể.

• Dữ liệu gửi đi: string (cặp giao dịch, ví dụ: "BTCUSDT")

• Ví dụ:

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

3. Nhận Cập Nhật Độ Sâu Sổ Lệnh

• Sự kiện: spot:depth:update

• Mô tả: Cung cấp dữ liệu cập nhật sổ lệnh theo thời gian thực cho cặp giao dịch đã đăng ký.

• Dữ liệu nhận được: JSON chứa danh sách các lệnh mua và bán.

• Ví dụ phản hồi:

  {
    "symbol": "BTCUSDT",
    "bids": [
      [ 97638.22, 2.66402 ],
      [ 97638.2, 0.00018 ]
    ],
    "asks": [
      [ 97638.23, 1.9828 ],
      [ 97638.27, 0.00018 ]
    ]
  }

Giải Thích Dữ Liệu Phản Hồi

Trường	Kiểu Dữ Liệu	Mô Tả
symbol	string	Cặp giao dịch (ví dụ: BTCUSDT)
bids	array	Danh sách lệnh mua (giá và khối lượng)
asks	array	Danh sách lệnh bán (giá và khối lượng)

• Ví dụ xử lý dữ liệu:

  socket.on("spot:depth:update", (data) => {
    console.log("Cập nhật sổ lệnh:", data);
  });

---

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

• WebSocket client sẽ tự động thử kết nối lại nếu bị mất kết nối.

• Nếu mất kết nối, client sẽ thử lại liên tục với độ trễ từ 100ms - 500ms.

---

Lưu Ý

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

• Dữ liệu được cập nhật theo thời gian thực và có thể thay đổi theo biến động thị trường.