Các mức max pain thanh lý

Các mức max pain thanh lý (phía long và phía short)

GET/api/liq-maxpain

Yêu cầu

Tham số truy vấn

Tên	Kiểu	Bắt buộc	Mặc định	Giá trị hợp lệ	Mô tả
symbol	string	Tùy chọn	—	—	Ký hiệu coin; bỏ trống = tất cả.
limit	integer	Tùy chọn	100	≤ 200	Số dòng trả về. Ví dụ: 100

Yêu cầu mẫu

curl -s "https://www.coinboss.com/api/liq-maxpain?limit=100"

Trường phản hồi

Bảng trường được tạo từ phản hồi thật nên liệt kê đúng những gì endpoint trả về. Đường dẫn dùng a[] cho phần tử mảng và {*} cho object có khóa là tên động, chẳng hạn một coin hoặc một sàn.

Trường	Kiểu	Đơn vị	Mô tả
success	boolean	—	true khi yêu cầu thành công. Khi thất bại, nội dung phản hồi là `{ success: false, code, error, request_id }`.
count	number	—	Số mục.
data	array	—	Dữ liệu trả về.
data[]	object	—	Dữ liệu trả về.
data[].symbol	string	—	Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT).
data[].price	number	—	Giá gần nhất tính theo đồng yết giá (USD hoặc USDT nếu không nêu khác).
data[].updatedAt	number	ms	Thời điểm dữ liệu được cập nhật lần gần nhất.
data[].d1	object	—	Các mức max pain từ bản đồ thanh lý 1 ngày (vị thế được mô hình hóa từ 24 nến giờ gần nhất): `long`, `short`, `totalLong`, `totalShort`.
data[].d1.long	object	—	Giá trị phía long.
data[].d1.long.price	number	—	Giá gần nhất tính theo đồng yết giá (USD hoặc USDT nếu không nêu khác).
data[].d1.long.usd	number	USD	Giá trị.
data[].d1.long.distPct	number	%	Khoảng cách từ giá max pain phía long tới `price` hiện tại: (mức giá − `price`) ÷ `price` × 100; âm vì nằm phía dưới.
data[].d1.short	object	—	Giá trị phía short.
data[].d1.short.price	number	—	Giá gần nhất tính theo đồng yết giá (USD hoặc USDT nếu không nêu khác).
data[].d1.short.usd	number	USD	Giá trị.
data[].d1.short.distPct	number	%	Khoảng cách từ giá max pain phía short tới `price` hiện tại: (mức giá − `price`) ÷ `price` × 100; dương vì nằm phía trên.
data[].d1.totalLong	number	—	Tổng long.
data[].d1.totalShort	number	—	Tổng short.
data[].d7	object	—	Các mức max pain từ bản đồ thanh lý 7 ngày (168 nến giờ gần nhất, trục giá ±18 %); null khi bản đồ đó không khả dụng.
data[].d7.long	object	—	Giá trị phía long.
data[].d7.long.price	number	—	Giá gần nhất tính theo đồng yết giá (USD hoặc USDT nếu không nêu khác).
data[].d7.long.usd	number	USD	Giá trị.
data[].d7.long.distPct	number	%	Khoảng cách từ giá max pain phía long 7 ngày tới `price` hiện tại: (mức giá − `price`) ÷ `price` × 100; âm vì nằm phía dưới.
data[].d7.short	object	—	Giá trị phía short.
data[].d7.short.price	number	—	Giá gần nhất tính theo đồng yết giá (USD hoặc USDT nếu không nêu khác).
data[].d7.short.usd	number	USD	Giá trị.
data[].d7.short.distPct	number	%	Khoảng cách từ giá max pain phía short 7 ngày tới `price` hiện tại: (mức giá − `price`) ÷ `price` × 100; dương vì nằm phía trên.
data[].d7.totalLong	number	—	Tổng long.
data[].d7.totalShort	number	—	Tổng short.
data[].liqLong24h	number	USD	Giá trị danh nghĩa của các vị thế long thực sự bị thanh lý trong 24 giờ qua trên mọi sàn được theo dõi (lệnh thanh lý đã ghi nhận, không phải giá trị mô hình).
data[].liqShort24h	number	USD	Giá trị danh nghĩa của các vị thế short thực sự bị thanh lý trong 24 giờ qua trên mọi sàn được theo dõi (lệnh thanh lý đã ghi nhận, không phải giá trị mô hình).
data[].oiUsd	number	USD	Vị thế mở.
data[].volUsd	number	USD	Khối lượng.

Tạo lúc 2026-11-11 23:00 UTC từ 1 phản hồi thật.

Phản hồi mẫu

/api/liq-maxpain?limit=100 · Phản hồi thật, ghi lại lúc 2026-11-13 04:02:45 UTC. Mảng và map dài được rút gọn khi hiển thị: data có 100 phần tử.

{
- "success": true,
- "count": 100,
- "data": [
  - { … 9 },
  - { … 9 }
  ]
}

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ủ: 60s
Micro-cache biên: 10s
Tần suất cập nhật: mỗi 5 phút với top 100 coin; các coin hạng 101-300 được làm mới theo 5 lô so le (khoảng 25 phút một lần)
Khung thời gian: ảnh chụp mô hình mới nhất (suy ra từ bản đồ thanh lý 1 ngày và 7 ngày)
Nguồn dữ liệu: Ước tính theo mô hình do CoinBoss tự tính từ kline hợp đồng tương lai theo giờ của chính mình (binance, okx dự phòng), lịch sử vị thế mở tổng hợp và các lệnh thanh lý đã thu thập.
Độ phủ sàn: tối đa 300 coin crypto xếp hạng theo khối lượng danh nghĩa hợp đồng tương lai, yêu cầu >= 30 sự kiện thanh lý trong 7 ngày qua; cổ phiếu token hóa, hàng hóa, FX và chỉ số bị loại; các ước tính là kết quả mô hình, không phải mức thanh lý do sàn báo cáo
Phân trang: limit (mặc định 100, tối đa 200)
Sắp xếp: vol_usd giảm dần
Đơn vị: estimated liquidation notional in USD per price level; prices in USD; timestamps in Unix ms
Phương pháp: per coin: price levels with the largest estimated long / short liquidation notional (max pain) from the 1 d and 7 d maps
Dấu thời gian: Unix epoch tính bằng mili giây (UTC), trừ khi mô tả trường ghi khác
Định dạng phản hồi: json
Độ ổn định: Ổn định

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

Khả dụngKiểm tra lúc 2026-11-13 04:02:45 UTCHTTP 2004 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 68s

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

100% trong 411 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ử

GET/api/liq-maxpainKhả dụng

Tham số

symbol

string — Coin symbol; omitted = all.

limit

integer · mặc định 100 · tối đa 200 — Number of rows to return.

URL yêu cầuhttps://www.coinboss.com/api/liq-maxpain?limit=100

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.

Heatmap thanh lý (mô hình 1) /api/heatmap
Các ký hiệu được heatmap thanh lý hỗ trợ /api/heatmap/symbols
Heatmap thanh lý (mô hình 2 / 3) /api/liq-heatmap
Các ký hiệu được mô hình heatmap thanh lý hỗ trợ /api/liq-heatmap/symbols
Các mức cụm thanh lý /api/liq-levels
Bản đồ thanh lý /api/liq-map
Các ký hiệu được bản đồ thanh lý hỗ trợ /api/liq-map/symbols
Các mức max pain thanh lý /api/liq-maxpain