Luồng thanh lý và giá

Một kết nối WebSocket đẩy cả lệnh thanh lý lẫn cập nhật giá. Không có thông điệp subscribe: máy chủ gửi một frame `history` và một frame `price_snapshot` khi kết nối, sau đó là các frame `liquidation` và `price` ngay khi sự kiện xảy ra.

WSwss://www.coinboss.com/ws

Yêu cầu

Không có thông điệp subscribe: máy chủ bắt đầu đẩy dữ liệu ngay khi kết nối được mở. Khi socket đóng, hãy chờ một khoảng rồi kết nối lại và nạp bù khoảng trống qua HTTP.

Yêu cầu mẫu

# WebSocket needs a WS client; with websocat:
websocat "wss://www.coinboss.com/ws"

Trường phản hồi

Loại frame	Thời điểm gửi	Cấu trúc
history	một lần, khi kết nối	{ "type": "history", "data": [ <liquidation>, ... ] }
price_snapshot	một lần, khi kết nối	{ "type": "price_snapshot", "data": { "<SYMBOL>": <price>, ... }, "ts": <ms> }
liquidation	mỗi lệnh thanh lý	{ "type": "liquidation", "data": <liquidation> }
price	mỗi lần giá thay đổi	{ "type": "price", "symbol": "BTCUSDT", "price": <number>, "ts": <ms> }

Phản hồi mẫu

Không lưu ví dụ nào vì phản hồi thành công gần nhất quá lớn để hiển thị. Hãy gọi endpoint trong Playground.

Chi tiết

Xác thực: Không cần. Endpoint công khai.
Giới hạn tần suất: 1200 yêu cầu mỗi phút cho mỗi IP
Cache máy chủ: Không cache
Tần suất cập nhật: Được đẩy theo thời gian thực. Các frame `liquidation` đi theo feed thanh lý của sàn; các frame `price` đi theo các cập nhật ticker hợp đồng tương lai.
Khung thời gian: `history` chứa các lệnh thanh lý gần nhất tại thời điểm kết nối; mọi dữ liệu khác đều là trực tiếp.
Nguồn dữ liệu: Các feed thanh lý của sàn do CoinBoss thu thập; luồng ticker hợp đồng tương lai.
Dấu thời gian: Unix epoch tính bằng mili giây (UTC) trong `ts` / `timestamp`.
Định dạng phản hồi: json-frames
Độ ổn định: Ổn định

Trạng thái trực tiếp

Khả dụngKiểm tra lúc 2026-11-13 03:59:35 UTCHTTP 1014 msChưa kiểm tra schema

Độ khả dụng, 30 ngày qua

100% trong 408 lần kiểm tra đạt

Lỗi

Lệnh gọi thất bại có chung một cấu trúc trên mọi endpoint. Danh sách đầy đủ nằm ở trang lỗi. Lỗi và giới hạn tần suất →

Mã	HTTP	Ý nghĩa	Cách xử lý
INVALID_PARAM	400	Thiếu một tham số bắt buộc hoặc một giá trị không được chấp nhận. `param` nêu tên tham số khi xác định được.	Đừng thử lại với yêu cầu y nguyên; hãy sửa yêu cầu.
UNAUTHORIZED	401	Header `CB-API-KEY` đã được gửi nhưng khóa không tồn tại hoặc đã bị thu hồi. Dữ liệu công khai không cần khóa — hãy bỏ header hoặc dùng một khóa hợp lệ.	Đừng thử lại với yêu cầu y nguyên.
FORBIDDEN	403	Route này không thuộc API công khai (nội bộ hoặc chỉ dành cho tài khoản).	Đừng thử lại.
NOT_FOUND	404	Route không xác định, hoặc coin / sàn / quỹ được yêu cầu không tồn tại.	Đừng thử lại; hãy đối chiếu đường dẫn và các mã định danh với danh mục.
RATE_LIMITED	429	Số yêu cầu vượt quá giới hạn mỗi phút. `Retry-After` cho biết số giây cần chờ.	Chờ theo `Retry-After`, rồi thử lại có backoff.
INTERNAL	500	Lỗi máy chủ không mong đợi. Thông báo được cố ý viết chung chung; hãy trích dẫn `request_id` khi báo lỗi.	Thử lại một lần sau vài giây; nếu lỗi vẫn tiếp diễn, hãy báo cáo kèm ID yêu cầu.
UPSTREAM_FAILED	503	Nguồn dữ liệu đứng sau endpoint này không trả lời kịp thời. Không có số liệu quá hạn hay số liệu thay thế nào được trả về thay cho nó.	Thử lại có backoff; xem trang trạng thái.
UNAVAILABLE	501 / 503	Bộ dữ liệu tạm thời chưa sẵn sàng (cache đang được làm nóng) hoặc endpoint chưa có nguồn công khai hợp pháp.	Thử lại sau; danh mục có đánh dấu những endpoint không khả dụng theo thiết kế.
REQUEST_FAILED	200	Một số endpoint cũ hơn trả về HTTP 200 với `success: false`. Hãy luôn kiểm tra `success`, không chỉ trạng thái HTTP.	Tùy vào thông báo; hãy coi là một yêu cầu thất bại.

Dùng thử

WS/wsKhả dụng

Đây là một luồng WebSocket. Hãy kết nối để xem thông điệp thật được đẩy về; kết nối tự động đóng sau 25 thông điệp.

URL yêu cầuwss://www.coinboss.com/ws

Phản hồi

Chọn một endpoint rồi nhấn “Gửi yêu cầu”. Phản hồi, header và thời gian xử lý sẽ hiện ở đây.

Luồng thanh lý và giá /ws