Thông tin nến 24h

API WebSocket này cung cấp cập nhật thời gian thực cho các ticker trên Nami Exchange.

Thông Tin Kết Nối

• Base URL: wss://nfp-gateway.nami.exchange

• Path: /ws/public

• Transport: WebSocket

• Định dạng dữ liệu: JSON

• Kết Nối Lại: Được kích hoạt với backoff lũy tiến (khuyến nghị phía client)

Kết Nối

const WS_URL = "wss://nfp-gateway.nami.exchange/ws/public?t=" + Date.now();
let socket;

function connect() {
  socket = new WebSocket(WS_URL);

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

    // Đăng ký ticker cho BTCUSDT
    socket.send(JSON.stringify({
      event: "subscribe",
      data: {
        channel: "nfp:ticker",
        params: ["btcusdt"]
      }
    }));
  };

  socket.onmessage = (event) => {
    const data = JSON.parse(event.data);
    console.log("Nhận dữ liệu:", data);
  };

  socket.onclose = () => {
    console.log("Ngắt kết nối, đang thử kết nối lại...");
    setTimeout(connect, 300);
  };

  socket.onerror = () => {
    socket.close();
  };
}

connect();

Sự Kiện

1. Kết Nối

• Sự Kiện: open

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

socket.onopen = () => {
  console.log("Đã kết nối với máy chủ WebSocket");
};

2. Đăng Ký Ticker

• Sự Kiện: subscribe

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

• Payload: Đối tượng JSON

{
  "event": "subscribe",
  "data": {
    "channel": "nfp:ticker",
    "params": ["btcusdt"]
  }
}

3. Nhận Cập Nhật Ticker

• Sự Kiện: nfp:ticker

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

• Payload: Đối tượng JSON chứa thông tin giá và chỉ số thị trường.

{
  "event": "nfp:ticker",
  "channel": "nfp:ticker:btcusdt",
  "data": {
    "ap": 88298.1,
    "ath": 126176.2,
    "b": "BTC",
    "bi": 9,
    "bp": 88294.4,
    "br": -0,
    "bvr": 1,
    "fi": 8,
    "ft": 1766246400000,
    "h": 126176.2,
    "hh": 126176.2,
    "hy": 126176.2,
    "ip": 88336.21869565,
    "l": 80599.9,
    "lQ": 176.5962,
    "lcp": 0.0045,
    "ld": 87900.8,
    "lft": 1766217600000,
    "lh": 80599.9,
    "lq": 0.002,
    "ly": 80599.9,
    "mp": 88329.43064239025,
    "p": 88298.1,
    "q": "USDT",
    "qi": 22,
    "r": -0.00048725994459568545,
    "s": "BTCUSDT",
    "sr": -0.00048725994459568545,
    "svr": 0,
    "t": 1766217683,
    "u": true,
    "vb": 2234727.288299677,
    "vq": 224201427501.51248
  }
}

s	string	Symbol giao dịch (ví dụ: BTCUSDT)
b	string	Base asset (BTC)
q	string	Quote asset (USDT)
p	number	Giá khớp gần nhất (Last price)
ap	number	Giá khớp trung bình gần nhất
bp	number	Best bid price
mp	number	Mark price
ip	number	Index price
h	number	Giá cao nhất 24h
l	number	Giá thấp nhất 24h
ath	number	Giá cao nhất mọi thời đại
vb	number	Khối lượng giao dịch 24h (base asset)
vq	number	Khối lượng giao dịch 24h (quote asset)
r / sr	number	Tỷ lệ biến động giá
lcp	number	Tỷ lệ biến động so với lần đóng gần nhất
fi	number	Funding interval
ft	number	Thời điểm funding tiếp theo (ms)
t	number	Thời điểm cập nhật (Unix timestamp, giây)
u	boolean	Trạng thái hợp lệ của ticker

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:

  • reconnect vô thời hạn

  • sau khi reconnect cần đăng ký lại (resubscribe) ticker

Ghi Chú

• Symbol đăng ký dùng lowercase (btcusdt), payload trả về uppercase (BTCUSDT).

• Ticker dùng làm:

  • hiển thị giá realtime

  • tính toán funding, mark price

  • crawl dữ liệu cho CoinGecko

• Client nên throttle việc render UI vì tần suất update cao.