Khối lượng 24h—Vị thế mở—Thanh lý 24h$1.36B Long/Short 24h—Thống trị BTC—Thống trị ETH—

Ứng dụng

Ngôn ngữ ▾

₫ VND ▾

/api/sd/liquidity

GETMột phầnPARTIAL

Độ sâu sổ lệnh và trượt giá

Độ sâu sổ lệnh theo từng sàn trong phạm vi ±0.5 / 1 / 2 % quanh giá giữa, spread và trượt giá của một lệnh thị trường 10k / 100k / 1M USD, cùng số liệu tổng hợp theo từng loại thị trường kèm mẫu số của nó.

GET/api/sd/liquidity

Độ phủ một phần. Với những coin thanh khoản cao nhất, ảnh chụp công khai của một số sàn lớn không phủ hết dải, nên các sàn đó bị loại khỏi số liệu tổng hợp và số liệu tổng hợp thấp hơn tổng độ sâu thực tế. Các trường `lower_bound_*` bổ sung phần đã quan sát được. Luôn đọc `n_included` cùng với giá trị độ sâu.

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ả
coin	string	Bắt buộc	—	—	Ký hiệu coin, không phân biệt chữ hoa chữ thường (ví dụ `BTC`). Giá trị bị thiếu hoặc sai định dạng trả về 400. Ví dụ: BTC
market	string	Tùy chọn	all	perp, spot, all	Loại thị trường. Sổ lệnh hợp đồng vĩnh cửu và giao ngay không bao giờ được cộng chung.

Yêu cầu mẫu

curl -s "https://www.coinboss.com/api/sd/liquidity?coin=BTC"

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 }`.
schema	string	—	ID schema của phản hồi này. Nó chỉ thay đổi khi một trường hiện có đổi ý nghĩa hoặc kiểu dữ liệu.
now	number	ms	Thời gian máy chủ lúc phản hồi được dựng.
coin	string	—	Ký hiệu coin (chữ hoa).
market	string	—	`perp` hoặc `spot`.
venues	array	—	Mỗi tổ hợp sàn × thị trường × hợp đồng một dòng.
venues[]	object	—	Mỗi tổ hợp sàn × thị trường × hợp đồng một dòng.
venues[].exchange	string	—	ID sàn (viết thường).
venues[].market	string	—	`perp` hoặc `spot`.
venues[].symbol	string	—	Ký hiệu hợp đồng theo dạng lưu trữ của CoinBoss.
venues[].quote	string	—	Đồng yết giá của thị trường; USDT, USDC và USD được tính 1:1 thành USD.
venues[].multiplier	number	—	Số coin trên mỗi đơn vị yết giá (1000 với các hợp đồng kiểu `1000PEPE`). Giá đã được chia sẵn cho hệ số này.
venues[].contract_value	number	—	Quy mô của một hợp đồng: tính bằng coin với hợp đồng linear, bằng USD với hợp đồng inverse.
venues[].inverse	boolean	—	True với các hợp đồng ký quỹ bằng coin được yết theo USD trên mỗi hợp đồng.
venues[].mid	number	USD	(best bid + best ask) ÷ 2, giá của một coin.
venues[].best_bid	number	USD	Giá bid tốt nhất của một coin.
venues[].best_ask	number	USD	Giá ask tốt nhất của một coin.
venues[].spread_bps	number	bp	(best ask − best bid) ÷ giá giữa.
venues[].n_bids	number	—	Các mức giá bid trong ảnh chụp.
venues[].n_asks	number	—	Các mức giá ask trong ảnh chụp.
venues[].reach_bid_pct	number	%	Khoảng cách từ giá giữa đến mức bid xa nhất trong ảnh chụp.
venues[].reach_ask_pct	number	%	Khoảng cách từ giá giữa đến mức ask xa nhất trong ảnh chụp.
venues[].book_complete_bid	boolean	—	True khi toàn bộ phía bid của sổ lệnh đã được trả về.
venues[].book_complete_ask	boolean	—	True khi toàn bộ phía ask của sổ lệnh đã được trả về.
venues[].bands	object	—	Độ sâu theo từng dải; các khóa `0.5`, `1` và `2` là khoảng cách tính từ giá giữa, theo phần trăm.
venues[].bands.1	object	—	Dải có khoảng cách này tính từ giá giữa, theo phần trăm.
venues[].bands.1.bid_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ mua (bid) nằm giữa giá giữa và mép dưới của dải. Là cận dưới khi `complete` bằng false.
venues[].bands.1.ask_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ bán (ask) nằm giữa giá giữa và mép trên của dải. Là cận dưới khi `complete` bằng false.
venues[].bands.1.complete	boolean	—	True khi cả hai phía của ảnh chụp đều vươn tới mép dải. Các dòng chưa đầy đủ không được đưa vào số liệu tổng hợp.
venues[].bands.2	object	—	Dải có khoảng cách này tính từ giá giữa, theo phần trăm.
venues[].bands.2.bid_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ mua (bid) nằm giữa giá giữa và mép dưới của dải. Là cận dưới khi `complete` bằng false.
venues[].bands.2.ask_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ bán (ask) nằm giữa giá giữa và mép trên của dải. Là cận dưới khi `complete` bằng false.
venues[].bands.2.complete	boolean	—	True khi cả hai phía của ảnh chụp đều vươn tới mép dải. Các dòng chưa đầy đủ không được đưa vào số liệu tổng hợp.
venues[].bands.0.5	object	—	Dải có khoảng cách này tính từ giá giữa, theo phần trăm.
venues[].bands.0.5.bid_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ mua (bid) nằm giữa giá giữa và mép dưới của dải. Là cận dưới khi `complete` bằng false.
venues[].bands.0.5.ask_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ bán (ask) nằm giữa giá giữa và mép trên của dải. Là cận dưới khi `complete` bằng false.
venues[].bands.0.5.complete	boolean	—	True khi cả hai phía của ảnh chụp đều vươn tới mép dải. Các dòng chưa đầy đủ không được đưa vào số liệu tổng hợp.
venues[].slippage	object	—	Trượt giá của một lệnh thị trường; các khóa `10000`, `100000` và `1000000` là quy mô lệnh tính bằng USD.
venues[].slippage.10000	object	—	Lệnh thị trường có quy mô này, tính bằng USD.
venues[].slippage.10000.buy_bps	number	bp	Giá khớp trung bình của một lệnh mua thị trường so với giá giữa (đã gồm một nửa spread); `null` khi ảnh chụp không đủ để khớp lệnh.
venues[].slippage.10000.sell_bps	number\|null	bp	Giá khớp trung bình của một lệnh bán thị trường so với giá giữa (đã gồm một nửa spread); `null` khi ảnh chụp không đủ để khớp lệnh.
venues[].slippage.10000.buy_flag	null	—	`insufficient_book` khi lệnh không thể khớp hết từ ảnh chụp, `upper_bound` khi có dùng bucket gộp, còn lại là `null`.
venues[].slippage.10000.sell_flag	string\|null	—	`insufficient_book` khi lệnh không thể khớp hết từ ảnh chụp, `upper_bound` khi có dùng bucket gộp, còn lại là `null`.
venues[].slippage.100000	object	—	Lệnh thị trường có quy mô này, tính bằng USD.
venues[].slippage.100000.buy_bps	number\|null	bp	Giá khớp trung bình của một lệnh mua thị trường so với giá giữa (đã gồm một nửa spread); `null` khi ảnh chụp không đủ để khớp lệnh.
venues[].slippage.100000.sell_bps	number\|null	bp	Giá khớp trung bình của một lệnh bán thị trường so với giá giữa (đã gồm một nửa spread); `null` khi ảnh chụp không đủ để khớp lệnh.
venues[].slippage.100000.buy_flag	string\|null	—	`insufficient_book` khi lệnh không thể khớp hết từ ảnh chụp, `upper_bound` khi có dùng bucket gộp, còn lại là `null`.
venues[].slippage.100000.sell_flag	string\|null	—	`insufficient_book` khi lệnh không thể khớp hết từ ảnh chụp, `upper_bound` khi có dùng bucket gộp, còn lại là `null`.
venues[].slippage.1000000	object	—	Lệnh thị trường có quy mô này, tính bằng USD.
venues[].slippage.1000000.buy_bps	number\|null	bp	Giá khớp trung bình của một lệnh mua thị trường so với giá giữa (đã gồm một nửa spread); `null` khi ảnh chụp không đủ để khớp lệnh.
venues[].slippage.1000000.sell_bps	number\|null	bp	Giá khớp trung bình của một lệnh bán thị trường so với giá giữa (đã gồm một nửa spread); `null` khi ảnh chụp không đủ để khớp lệnh.
venues[].slippage.1000000.buy_flag	string\|null	—	`insufficient_book` khi lệnh không thể khớp hết từ ảnh chụp, `upper_bound` khi có dùng bucket gộp, còn lại là `null`.
venues[].slippage.1000000.sell_flag	string\|null	—	`insufficient_book` khi lệnh không thể khớp hết từ ảnh chụp, `upper_bound` khi có dùng bucket gộp, còn lại là `null`.
venues[].book_bid_usd	number	USD	Giá trị danh nghĩa của toàn bộ lệnh bid có trong ảnh chụp.
venues[].book_ask_usd	number	USD	Giá trị danh nghĩa của toàn bộ lệnh ask có trong ảnh chụp.
venues[].agg_step_bps	number\|null	bp	Bucket gộp giá rộng nhất được dùng trong phạm vi ±2 %; `null` khi chỉ dùng các mức giá gốc.
venues[].layers	number	—	Số ảnh chụp được ghép lại cho dòng này.
venues[].observed_at	number\|null	ms	Dấu thời gian do nguồn cung cấp cho dữ liệu.
venues[].received_at	number	ms	Thời điểm trình thu thập của CoinBoss nhận được dữ liệu.
venues[].lag_ms	number\|null	ms	Thời điểm nhận trừ đi dấu thời gian sổ lệnh của sàn; `null` khi sàn không cung cấp.
venues[].age_s	number	s	Số giây kể từ khi dòng được nhận.
venues[].fresh_window_s	number	s	Dòng cũ hơn ngưỡng này bị coi là quá hạn.
venues[].is_stale	boolean	—	True khi dữ liệu cũ hơn khung dữ liệu mới của nó.
venues[].tier	string	—	Bậc thu thập: `A` cho các coin được giao dịch nhiều nhất, `B` cho các coin còn lại.
venues[].period_s	number	s	Chu kỳ thu thập của dòng.
aggregate	object	—	Tổng theo từng loại thị trường. Hợp đồng vĩnh cửu và giao ngay không bao giờ được cộng chung.
aggregate.perp	object	—	Số liệu tổng hợp trên các sổ lệnh hợp đồng vĩnh cửu; `null` khi không có dòng nào. có thể vắng mặt
aggregate.perp.n_rows	number	—	Số dòng tìm thấy, kể cả dòng quá hạn. có thể vắng mặt
aggregate.perp.n_fresh	number	—	Số dòng còn mới. có thể vắng mặt
aggregate.perp.mid_median	number	USD	Trung vị giá giữa của các dòng còn mới. có thể vắng mặt
aggregate.perp.spread_bps_min	number	bp	Spread hẹp nhất trong các dòng còn mới. có thể vắng mặt
aggregate.perp.bands	object	—	Độ sâu theo từng dải; các khóa `0.5`, `1` và `2` là khoảng cách tính từ giá giữa, theo phần trăm. có thể vắng mặt
aggregate.perp.bands.1	object	—	Dải có khoảng cách này tính từ giá giữa, theo phần trăm. có thể vắng mặt
aggregate.perp.bands.1.bid_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ mua (bid) nằm giữa giá giữa và mép dưới của dải. Là cận dưới khi `complete` bằng false. có thể vắng mặt
aggregate.perp.bands.1.ask_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ bán (ask) nằm giữa giá giữa và mép trên của dải. Là cận dưới khi `complete` bằng false. có thể vắng mặt
aggregate.perp.bands.1.n_included	number	—	Số dòng được tính vào tổng độ sâu: còn mới và đầy đủ cho dải. Hãy đọc cùng với giá trị độ sâu. có thể vắng mặt
aggregate.perp.bands.1.n_fresh	number	—	Số dòng còn mới. có thể vắng mặt
aggregate.perp.bands.1.included_exchanges	array	—	Các nguồn có dữ liệu còn mới được tính. có thể vắng mặt
aggregate.perp.bands.1.included_exchanges[]	string	—	Các nguồn có dữ liệu còn mới được tính. có thể vắng mặt
aggregate.perp.bands.1.excluded_incomplete	array	—	Các dòng còn mới bị loại khỏi dải vì ảnh chụp của chúng không vươn tới mép dải. có thể vắng mặt
aggregate.perp.bands.1.excluded_incomplete[]	object	—	Các dòng còn mới bị loại khỏi dải vì ảnh chụp của chúng không vươn tới mép dải. có thể vắng mặt
aggregate.perp.bands.1.excluded_incomplete[].exchange	string	—	ID sàn (viết thường). có thể vắng mặt
aggregate.perp.bands.1.excluded_incomplete[].symbol	string	—	Ký hiệu hợp đồng theo dạng lưu trữ của CoinBoss. có thể vắng mặt
aggregate.perp.bands.1.excluded_incomplete[].reach_bid_pct	number	%	Khoảng cách từ giá giữa đến mức bid xa nhất trong ảnh chụp. có thể vắng mặt
aggregate.perp.bands.1.excluded_incomplete[].reach_ask_pct	number	%	Khoảng cách từ giá giữa đến mức ask xa nhất trong ảnh chụp. có thể vắng mặt
aggregate.perp.bands.1.lower_bound_bid_usd	number	USD	Độ sâu bid gồm cả phần đã quan sát được của các dòng chưa đầy đủ. Là mức sàn, không phải ước tính. có thể vắng mặt
aggregate.perp.bands.1.lower_bound_ask_usd	number	USD	Độ sâu ask gồm cả phần đã quan sát được của các dòng chưa đầy đủ. Là mức sàn, không phải ước tính. có thể vắng mặt
aggregate.perp.bands.1.uses_aggregated_buckets	boolean	—	True khi một dòng được tính có dùng bucket gộp theo giá, khiến tổng trở thành cận dưới. có thể vắng mặt
aggregate.perp.bands.2	object	—	Dải có khoảng cách này tính từ giá giữa, theo phần trăm. có thể vắng mặt
aggregate.perp.bands.2.bid_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ mua (bid) nằm giữa giá giữa và mép dưới của dải. Là cận dưới khi `complete` bằng false. có thể vắng mặt
aggregate.perp.bands.2.ask_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ bán (ask) nằm giữa giá giữa và mép trên của dải. Là cận dưới khi `complete` bằng false. có thể vắng mặt
aggregate.perp.bands.2.n_included	number	—	Số dòng được tính vào tổng độ sâu: còn mới và đầy đủ cho dải. Hãy đọc cùng với giá trị độ sâu. có thể vắng mặt
aggregate.perp.bands.2.n_fresh	number	—	Số dòng còn mới. có thể vắng mặt
aggregate.perp.bands.2.included_exchanges	array	—	Các nguồn có dữ liệu còn mới được tính. có thể vắng mặt
aggregate.perp.bands.2.included_exchanges[]	string	—	Các nguồn có dữ liệu còn mới được tính. có thể vắng mặt
aggregate.perp.bands.2.excluded_incomplete	array	—	Các dòng còn mới bị loại khỏi dải vì ảnh chụp của chúng không vươn tới mép dải. có thể vắng mặt
aggregate.perp.bands.2.excluded_incomplete[]	object	—	Các dòng còn mới bị loại khỏi dải vì ảnh chụp của chúng không vươn tới mép dải. có thể vắng mặt
aggregate.perp.bands.2.excluded_incomplete[].exchange	string	—	ID sàn (viết thường). có thể vắng mặt
aggregate.perp.bands.2.excluded_incomplete[].symbol	string	—	Ký hiệu hợp đồng theo dạng lưu trữ của CoinBoss. có thể vắng mặt
aggregate.perp.bands.2.excluded_incomplete[].reach_bid_pct	number	%	Khoảng cách từ giá giữa đến mức bid xa nhất trong ảnh chụp. có thể vắng mặt
aggregate.perp.bands.2.excluded_incomplete[].reach_ask_pct	number	%	Khoảng cách từ giá giữa đến mức ask xa nhất trong ảnh chụp. có thể vắng mặt
aggregate.perp.bands.2.lower_bound_bid_usd	number	USD	Độ sâu bid gồm cả phần đã quan sát được của các dòng chưa đầy đủ. Là mức sàn, không phải ước tính. có thể vắng mặt
aggregate.perp.bands.2.lower_bound_ask_usd	number	USD	Độ sâu ask gồm cả phần đã quan sát được của các dòng chưa đầy đủ. Là mức sàn, không phải ước tính. có thể vắng mặt
aggregate.perp.bands.2.uses_aggregated_buckets	boolean	—	True khi một dòng được tính có dùng bucket gộp theo giá, khiến tổng trở thành cận dưới. có thể vắng mặt
aggregate.perp.bands.0.5	object	—	Dải có khoảng cách này tính từ giá giữa, theo phần trăm. có thể vắng mặt
aggregate.perp.bands.0.5.bid_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ mua (bid) nằm giữa giá giữa và mép dưới của dải. Là cận dưới khi `complete` bằng false. có thể vắng mặt
aggregate.perp.bands.0.5.ask_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ bán (ask) nằm giữa giá giữa và mép trên của dải. Là cận dưới khi `complete` bằng false. có thể vắng mặt
aggregate.perp.bands.0.5.n_included	number	—	Số dòng được tính vào tổng độ sâu: còn mới và đầy đủ cho dải. Hãy đọc cùng với giá trị độ sâu. có thể vắng mặt
aggregate.perp.bands.0.5.n_fresh	number	—	Số dòng còn mới. có thể vắng mặt
aggregate.perp.bands.0.5.included_exchanges	array	—	Các nguồn có dữ liệu còn mới được tính. có thể vắng mặt
aggregate.perp.bands.0.5.included_exchanges[]	string	—	Các nguồn có dữ liệu còn mới được tính. có thể vắng mặt
aggregate.perp.bands.0.5.excluded_incomplete	array	—	Các dòng còn mới bị loại khỏi dải vì ảnh chụp của chúng không vươn tới mép dải. có thể vắng mặt
aggregate.perp.bands.0.5.excluded_incomplete[]	object	—	Các dòng còn mới bị loại khỏi dải vì ảnh chụp của chúng không vươn tới mép dải. có thể vắng mặt
aggregate.perp.bands.0.5.excluded_incomplete[].exchange	string	—	ID sàn (viết thường). có thể vắng mặt
aggregate.perp.bands.0.5.excluded_incomplete[].symbol	string	—	Ký hiệu hợp đồng theo dạng lưu trữ của CoinBoss. có thể vắng mặt
aggregate.perp.bands.0.5.excluded_incomplete[].reach_bid_pct	number	%	Khoảng cách từ giá giữa đến mức bid xa nhất trong ảnh chụp. có thể vắng mặt
aggregate.perp.bands.0.5.excluded_incomplete[].reach_ask_pct	number	%	Khoảng cách từ giá giữa đến mức ask xa nhất trong ảnh chụp. có thể vắng mặt
aggregate.perp.bands.0.5.lower_bound_bid_usd	number	USD	Độ sâu bid gồm cả phần đã quan sát được của các dòng chưa đầy đủ. Là mức sàn, không phải ước tính. có thể vắng mặt
aggregate.perp.bands.0.5.lower_bound_ask_usd	number	USD	Độ sâu ask gồm cả phần đã quan sát được của các dòng chưa đầy đủ. Là mức sàn, không phải ước tính. có thể vắng mặt
aggregate.perp.bands.0.5.uses_aggregated_buckets	boolean	—	True khi một dòng được tính có dùng bucket gộp theo giá, khiến tổng trở thành cận dưới. có thể vắng mặt
aggregate.spot	object	—	Số liệu tổng hợp trên các sổ lệnh giao ngay; `null` khi không có dòng nào. có thể vắng mặt
aggregate.spot.n_rows	number	—	Số dòng tìm thấy, kể cả dòng quá hạn. có thể vắng mặt
aggregate.spot.n_fresh	number	—	Số dòng còn mới. có thể vắng mặt
aggregate.spot.mid_median	number	USD	Trung vị giá giữa của các dòng còn mới. có thể vắng mặt
aggregate.spot.spread_bps_min	number	bp	Spread hẹp nhất trong các dòng còn mới. có thể vắng mặt
aggregate.spot.bands	object	—	Độ sâu theo từng dải; các khóa `0.5`, `1` và `2` là khoảng cách tính từ giá giữa, theo phần trăm. có thể vắng mặt
aggregate.spot.bands.1	object	—	Dải có khoảng cách này tính từ giá giữa, theo phần trăm. có thể vắng mặt
aggregate.spot.bands.1.bid_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ mua (bid) nằm giữa giá giữa và mép dưới của dải. Là cận dưới khi `complete` bằng false. có thể vắng mặt
aggregate.spot.bands.1.ask_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ bán (ask) nằm giữa giá giữa và mép trên của dải. Là cận dưới khi `complete` bằng false. có thể vắng mặt
aggregate.spot.bands.1.n_included	number	—	Số dòng được tính vào tổng độ sâu: còn mới và đầy đủ cho dải. Hãy đọc cùng với giá trị độ sâu. có thể vắng mặt
aggregate.spot.bands.1.n_fresh	number	—	Số dòng còn mới. có thể vắng mặt
aggregate.spot.bands.1.included_exchanges	array	—	Các nguồn có dữ liệu còn mới được tính. có thể vắng mặt
aggregate.spot.bands.1.included_exchanges[]	string	—	Các nguồn có dữ liệu còn mới được tính. có thể vắng mặt
aggregate.spot.bands.1.excluded_incomplete	array	—	Các dòng còn mới bị loại khỏi dải vì ảnh chụp của chúng không vươn tới mép dải. có thể vắng mặt
aggregate.spot.bands.1.excluded_incomplete[]	object	—	Các dòng còn mới bị loại khỏi dải vì ảnh chụp của chúng không vươn tới mép dải. có thể vắng mặt
aggregate.spot.bands.1.excluded_incomplete[].exchange	string	—	ID sàn (viết thường). có thể vắng mặt
aggregate.spot.bands.1.excluded_incomplete[].symbol	string	—	Ký hiệu hợp đồng theo dạng lưu trữ của CoinBoss. có thể vắng mặt
aggregate.spot.bands.1.excluded_incomplete[].reach_bid_pct	number	%	Khoảng cách từ giá giữa đến mức bid xa nhất trong ảnh chụp. có thể vắng mặt
aggregate.spot.bands.1.excluded_incomplete[].reach_ask_pct	number	%	Khoảng cách từ giá giữa đến mức ask xa nhất trong ảnh chụp. có thể vắng mặt
aggregate.spot.bands.1.lower_bound_bid_usd	number	USD	Độ sâu bid gồm cả phần đã quan sát được của các dòng chưa đầy đủ. Là mức sàn, không phải ước tính. có thể vắng mặt
aggregate.spot.bands.1.lower_bound_ask_usd	number	USD	Độ sâu ask gồm cả phần đã quan sát được của các dòng chưa đầy đủ. Là mức sàn, không phải ước tính. có thể vắng mặt
aggregate.spot.bands.1.uses_aggregated_buckets	boolean	—	True khi một dòng được tính có dùng bucket gộp theo giá, khiến tổng trở thành cận dưới. có thể vắng mặt
aggregate.spot.bands.2	object	—	Dải có khoảng cách này tính từ giá giữa, theo phần trăm. có thể vắng mặt
aggregate.spot.bands.2.bid_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ mua (bid) nằm giữa giá giữa và mép dưới của dải. Là cận dưới khi `complete` bằng false. có thể vắng mặt
aggregate.spot.bands.2.ask_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ bán (ask) nằm giữa giá giữa và mép trên của dải. Là cận dưới khi `complete` bằng false. có thể vắng mặt
aggregate.spot.bands.2.n_included	number	—	Số dòng được tính vào tổng độ sâu: còn mới và đầy đủ cho dải. Hãy đọc cùng với giá trị độ sâu. có thể vắng mặt
aggregate.spot.bands.2.n_fresh	number	—	Số dòng còn mới. có thể vắng mặt
aggregate.spot.bands.2.included_exchanges	array	—	Các nguồn có dữ liệu còn mới được tính. có thể vắng mặt
aggregate.spot.bands.2.included_exchanges[]	string	—	Các nguồn có dữ liệu còn mới được tính. có thể vắng mặt
aggregate.spot.bands.2.excluded_incomplete	array	—	Các dòng còn mới bị loại khỏi dải vì ảnh chụp của chúng không vươn tới mép dải. có thể vắng mặt
aggregate.spot.bands.2.excluded_incomplete[]	object	—	Các dòng còn mới bị loại khỏi dải vì ảnh chụp của chúng không vươn tới mép dải. có thể vắng mặt
aggregate.spot.bands.2.excluded_incomplete[].exchange	string	—	ID sàn (viết thường). có thể vắng mặt
aggregate.spot.bands.2.excluded_incomplete[].symbol	string	—	Ký hiệu hợp đồng theo dạng lưu trữ của CoinBoss. có thể vắng mặt
aggregate.spot.bands.2.excluded_incomplete[].reach_bid_pct	number	%	Khoảng cách từ giá giữa đến mức bid xa nhất trong ảnh chụp. có thể vắng mặt
aggregate.spot.bands.2.excluded_incomplete[].reach_ask_pct	number	%	Khoảng cách từ giá giữa đến mức ask xa nhất trong ảnh chụp. có thể vắng mặt
aggregate.spot.bands.2.lower_bound_bid_usd	number	USD	Độ sâu bid gồm cả phần đã quan sát được của các dòng chưa đầy đủ. Là mức sàn, không phải ước tính. có thể vắng mặt
aggregate.spot.bands.2.lower_bound_ask_usd	number	USD	Độ sâu ask gồm cả phần đã quan sát được của các dòng chưa đầy đủ. Là mức sàn, không phải ước tính. có thể vắng mặt
aggregate.spot.bands.2.uses_aggregated_buckets	boolean	—	True khi một dòng được tính có dùng bucket gộp theo giá, khiến tổng trở thành cận dưới. có thể vắng mặt
aggregate.spot.bands.0.5	object	—	Dải có khoảng cách này tính từ giá giữa, theo phần trăm. có thể vắng mặt
aggregate.spot.bands.0.5.bid_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ mua (bid) nằm giữa giá giữa và mép dưới của dải. Là cận dưới khi `complete` bằng false. có thể vắng mặt
aggregate.spot.bands.0.5.ask_depth_usd	number	USD	Giá trị danh nghĩa của lệnh chờ bán (ask) nằm giữa giá giữa và mép trên của dải. Là cận dưới khi `complete` bằng false. có thể vắng mặt
aggregate.spot.bands.0.5.n_included	number	—	Số dòng được tính vào tổng độ sâu: còn mới và đầy đủ cho dải. Hãy đọc cùng với giá trị độ sâu. có thể vắng mặt
aggregate.spot.bands.0.5.n_fresh	number	—	Số dòng còn mới. có thể vắng mặt
aggregate.spot.bands.0.5.included_exchanges	array	—	Các nguồn có dữ liệu còn mới được tính. có thể vắng mặt
aggregate.spot.bands.0.5.included_exchanges[]	string	—	Các nguồn có dữ liệu còn mới được tính. có thể vắng mặt
aggregate.spot.bands.0.5.excluded_incomplete	array	—	Các dòng còn mới bị loại khỏi dải vì ảnh chụp của chúng không vươn tới mép dải. có thể vắng mặt
aggregate.spot.bands.0.5.excluded_incomplete[]	object	—	Các dòng còn mới bị loại khỏi dải vì ảnh chụp của chúng không vươn tới mép dải. có thể vắng mặt
aggregate.spot.bands.0.5.excluded_incomplete[].exchange	string	—	ID sàn (viết thường). có thể vắng mặt
aggregate.spot.bands.0.5.excluded_incomplete[].symbol	string	—	Ký hiệu hợp đồng theo dạng lưu trữ của CoinBoss. có thể vắng mặt
aggregate.spot.bands.0.5.excluded_incomplete[].reach_bid_pct	number	%	Khoảng cách từ giá giữa đến mức bid xa nhất trong ảnh chụp. có thể vắng mặt
aggregate.spot.bands.0.5.excluded_incomplete[].reach_ask_pct	number	%	Khoảng cách từ giá giữa đến mức ask xa nhất trong ảnh chụp. có thể vắng mặt
aggregate.spot.bands.0.5.lower_bound_bid_usd	number	USD	Độ sâu bid gồm cả phần đã quan sát được của các dòng chưa đầy đủ. Là mức sàn, không phải ước tính. có thể vắng mặt
aggregate.spot.bands.0.5.lower_bound_ask_usd	number	USD	Độ sâu ask gồm cả phần đã quan sát được của các dòng chưa đầy đủ. Là mức sàn, không phải ước tính. có thể vắng mặt
aggregate.spot.bands.0.5.uses_aggregated_buckets	boolean	—	True khi một dòng được tính có dùng bucket gộp theo giá, khiến tổng trở thành cận dưới. có thể vắng mặt
coverage	object	—	Những gì được tính và không được tính trong các con số. Hãy so sánh phần này trước khi so sánh tổng với một nguồn khác.
coverage.included_exchanges	array	—	Các nguồn có dữ liệu còn mới được tính.
coverage.included_exchanges[]	string	—	Các nguồn có dữ liệu còn mới được tính.
coverage.unavailable	array	—	Các nguồn không thể đưa vào, mỗi nguồn kèm một lý do. Chúng không bao giờ bị tính là 0. rỗng trong các mẫu dùng để tạo bảng này
coverage.stale_excluded	array	—	Các dòng bị loại vì lần cập nhật gần nhất nằm ngoài khung dữ liệu mới. rỗng trong các mẫu dùng để tạo bảng này
coverage.no_market	array	—	Các cặp sàn × thị trường có được thu thập nhưng không có dòng nào cho coin này. rỗng trong các mẫu dùng để tạo bảng này
method	object	—	Diễn giải dạng văn bản thuần về các công thức dùng cho phản hồi này, mỗi trường một mục.
method.mid	string	—	Ghi chú công thức cho `mid`, dạng văn bản thuần.
method.spread_bps	string	—	Ghi chú công thức cho `spread_bps`, dạng văn bản thuần.
method.bid_depth_usd	string	—	Ghi chú công thức cho `bid_depth_usd`, dạng văn bản thuần.
method.ask_depth_usd	string	—	Ghi chú công thức cho `ask_depth_usd`, dạng văn bản thuần.
method.complete	string	—	Ghi chú công thức cho `complete`, dạng văn bản thuần.
method.reach_pct	string	—	Ghi chú công thức cho `reach_pct`, dạng văn bản thuần.
method.slippage_bps	string	—	Ghi chú công thức cho `slippage_bps`, dạng văn bản thuần.
method.agg_step_bps	string	—	Ghi chú công thức cho `agg_step_bps`, dạng văn bản thuần.
method.aggregate	string	—	Ghi chú công thức cho `aggregate`, dạng văn bản thuần.
method.fresh	string	—	Ghi chú công thức cho `fresh`, dạng văn bản thuần.
method.lag_ms	string	—	Ghi chú công thức cho `lag_ms`, dạng văn bản thuần.
method.no_market	string	—	Ghi chú công thức cho `no_market`, dạng văn bản thuần.
meta	object	—	Nguồn gốc dữ liệu và độ mới của phản hồi này.
meta.schema	string	—	ID schema của phản hồi này. Nó chỉ thay đổi khi một trường hiện có đổi ý nghĩa hoặc kiểu dữ liệu.
meta.source	array	—	Các endpoint công khai của nguồn (upstream) mà dữ liệu được thu thập từ đó.
meta.source[]	object	—	Các endpoint công khai của nguồn (upstream) mà dữ liệu được thu thập từ đó.
meta.source[].exchange	string	—	ID sàn (viết thường).
meta.source[].market	string	—	`perp` hoặc `spot`.
meta.source[].endpoint	string	—	Endpoint công khai của nguồn mà trình thu thập đọc (hiển thị để nêu nguồn gốc dữ liệu; client không bao giờ gọi endpoint này).
meta.observed_at	number	ms	Dấu thời gian do nguồn cung cấp cho dữ liệu.
meta.received_at	number	ms	Thời điểm trình thu thập của CoinBoss nhận được dữ liệu.
meta.fetched_at	number	ms	Thời điểm phản hồi này được dựng.
meta.window	string	—	Khung thời gian mà các con số bao phủ.
meta.quality	string	—	FRESH, PARTIAL, STALE, BROKEN hoặc UNAVAILABLE, đánh giá từ dấu thời gian của dữ liệu và độ phủ.
meta.is_stale	boolean	—	True khi dữ liệu cũ hơn khung dữ liệu mới của nó.
meta.cache_ttl_s	number	s	Thời gian sống trong cache của phản hồi này.
meta.fallback	string	—	Endpoint trả về gì khi trình thu thập hoặc một nguồn gặp lỗi.
meta.collector_heartbeat_age_s	number	s	Số giây kể từ lần gần nhất trình thu thập báo rằng nó đang chạy.

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

Phản hồi mẫu

/api/sd/liquidity?coin=BTC · Phản hồi thật, ghi lại lúc 2026-11-13 03:58:06 UTC. Mảng và map dài được rút gọn khi hiển thị: venues có 39 phần tử; meta.source có 38 phần tử; coverage.included_exchanges có 24 phần tử; aggregate.perp.bands.1.included_exchanges có 19 phần tử; aggregate.perp.bands.2.included_exchanges có 16 phần tử; aggregate.spot.bands.1.included_exchanges có 14 phần tử.

{
- "success": true,
- "schema": "coinboss.sd.liquidity/1",
- "now": 1794542286066,
- "coin": "BTC",
- "market": "all",
- "venues": [
  - { … 31 }
  ],
- "aggregate": {
  - "perp": { … 5 },
  - "spot": { … 5 }
  },
- "coverage": {
  - "included_exchanges": [ … 8 ],
  - "unavailable": [],
  - "stale_excluded": [],
  - "no_market": []
  },
- "method": {
  - "mid": "(best_bid + best_ask) / 2 of the venue order book, normalised to the USD price of ONE coin (1000PEPE / kPEPE style contr…",
  - "spread_bps": "(best_ask - best_bid) / mid * 1e4",
  - "bid_depth_usd": "sum of resting bid notional with price >= mid * (1 - band%), in USD; notional = price * size * contract_value (inverse c…",
  - "ask_depth_usd": "sum of resting ask notional with price <= mid * (1 + band%), in USD; same notional rule as bid_depth_usd",
  - "complete": "true when BOTH sides of the snapshot reach the band edge (reach_pct >= band) or the whole side of the book was returned;…",
  - "reach_pct": "distance in % between mid and the farthest price level contained in the snapshot on that side",
  - "slippage_bps": "market order of N USD walked through the book: buy = (avg_fill / mid - 1) * 1e4, sell = (1 - avg_fill / mid) * 1e4, meas…",
  - "agg_step_bps": "widest price-aggregation bucket (in bps of mid) used inside +-2% for venues whose REST only exposes a shallow raw book (…",
  - "aggregate": "per market and band: sum over rows that are fresh AND complete for that band; n_included / n_fresh is the denominator; l…",
  - "fresh": "a row is fresh when now - received_at <= max(3 * period_s, 300s); stale rows are listed in coverage.stale_excluded; rows…",
  - "lag_ms": "received_at - venue timestamp of the book (null when the venue gives none); Gate spot books deeper than 100 levels are v…",
  - "no_market": "covered venue/market pairs that are being collected but hold no row for this coin: not listed there, or the contract was…"
  },
- "meta": {
  - "schema": "coinboss.sd.liquidity/1",
  - "source": [ … 1 ],
  - "observed_at": 1794542285214,
  - "received_at": 1794542285776,
  - "fetched_at": 1794542286066,
  - "window": "latest",
  - "quality": "PARTIAL",
  - "is_stale": false,
  - "cache_ttl_s": 15,
  - "fallback": "on collector failure the last stored row is served with is_stale=true and left out of the aggregate; rows older than 24h…",
  - "collector_heartbeat_age_s": 9
  }
}

Mẫu đã xác minh

Ngoài ví dụ ở trên, trình thăm dò còn gọi endpoint này với các tham số dưới đây và kiểm tra schema ở mỗi lần gọi.

Tham số	HTTP	Độ trễ	Kết quả
coin=ETH&market=spot	200	3 ms	Đạt PARTIAL
coin=PEPE&market=perp	200	4 ms	Đạt FRESH
coin=SOL	200	4 ms	Đạt PARTIAL
—	400	1 ms	Đạt trả về lỗi như dự kiến

Kiểm tra lúc 2026-11-13 03:58:06 UTC

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ủ: 15s
Micro-cache biên: 10s
Tần suất cập nhật: Ảnh chụp mỗi 120 giây với các coin được giao dịch nhiều nhất và mỗi 600 giây với phần còn lại (một vài sàn: 300 / 1200 giây). Một dòng được coi là còn mới trong ba kỳ thu thập, tối thiểu 300 giây.
Khung thời gian: Ảnh chụp mới nhất của từng hợp đồng.
Nguồn dữ liệu: Ảnh chụp sổ lệnh REST công khai của 24 sàn (thị trường hợp đồng vĩnh cửu và giao ngay), do CoinBoss thu thập và lưu trữ (sd_book_latest, sd_book_hist). Độ sâu và trượt giá do CoinBoss tính từ các mức giá gốc.
Độ phủ sàn: 24 sàn, 38 tổ hợp sàn × thị trường. Khi ảnh chụp công khai không vươn tới ±0.5 / 1 / 2 % tính từ giá giữa (do giới hạn số mức giá của sàn), dải đó được gắn cờ `complete: false`, giá trị của nó là cận dưới và nó không được đưa vào số liệu tổng hợp; `n_included` / `n_fresh` cho biết mẫu số và `excluded_incomplete` liệt kê những gì bị loại.
Phân trang: Không phân trang; mỗi tổ hợp sàn × thị trường × hợp đồng một dòng.
Sắp xếp: Các dòng hợp đồng vĩnh cửu xếp trước, sau đó là giao ngay; trong mỗi nhóm xếp theo độ sâu ±1 % (bid + ask) giảm dần.
Đơn vị: Depth in USD notional, bid and ask side reported separately and never added. Spread and slippage in basis points (1 bp = 0.01 %). USDT / USDC / USD quotes are counted 1:1 as USD.
Phương pháp: mid = (best bid + best ask) ÷ 2. Depth = Σ price × size of all levels between mid and mid ± x %. Slippage = (average fill price of a market order of N USD − mid) ÷ mid, in bp; `null` with flag `insufficient_book` when the snapshot cannot fill the order (no extrapolation), flag `upper_bound` when an aggregated price bucket was used.
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
Có từ: 2026-11-11

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

Một phầnKiểm tra lúc 2026-11-13 03:58:06 UTCHTTP 2007 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 0s

Endpoint báo cáo chất lượng dữ liệu PARTIAL — Với những coin thanh khoản cao nhất, ảnh chụp công khai của một số sàn lớn không phủ hết dải, nên các sàn đó bị loại khỏi số liệu tổng hợp và số liệu tổng hợp thấp hơn tổng độ sâu thực tế. Các trường `lower_bound_*` bổ sung phần đã quan sát được. Luôn đọc `n_included` cùng với giá trị độ sâu.

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

100% trong 407 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/sd/liquidityMột phần

Tham số

coin Bắt buộc

string — Coin symbol, case-insensitive (for example `BTC`). Missing or malformed values return 400.

market

string · mặc định all — Market type. Perpetual and spot books are never added together.

URL yêu cầuhttps://www.coinboss.com/api/sd/liquidity?coin=BTC

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.

Độ sâu sổ lệnh và trượt giá /api/sd/liquidity
Lịch sử độ sâu sổ lệnh /api/sd/liquidity/history
Xếp hạng coin theo độ sâu sổ lệnh /api/sd/liquidity/rank
Giám sát lệnh chờ lớn /api/indicators/large-orderbook