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/basis

GETSuy giảmSTALE

Basis hợp đồng tương lai (mọi sàn)

Basis hợp đồng vĩnh cửu (giá đánh dấu so với giá chỉ số), basis hợp đồng vĩnh cửu so với giao ngay trên cùng một sàn và basis hợp đồng giao sau có kỳ hạn kèm tỷ lệ quy năm, theo từng hợp đồng, cùng các số liệu tổng hợp trọng số theo OI, trọng số theo khối lượng và trung vị.

GET/api/sd/basis

Suy giảm. Endpoint báo cáo chất lượng dữ liệu STALE

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

Yêu cầu mẫu

curl -s "https://www.coinboss.com/api/sd/basis?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).
perp	object	—	Basis hợp đồng vĩnh cửu: giá đánh dấu so với giá chỉ số của cùng một sàn.
perp.unit	string	—	Đơn vị của các giá trị basis (phần trăm).
perp.aggregate	object	—	Số liệu tổng hợp đa sàn của phần này.
perp.aggregate.oi_weighted_pct	number	%	Basis tính trọng số theo vị thế mở; các dòng không có trọng số OI bị loại.
perp.aggregate.oi_weight_usd	number	USD	Tổng các trọng số vị thế mở đã dùng.
perp.aggregate.n_oi_weighted	number	—	Số dòng có trọng số OI.
perp.aggregate.vol_weighted_pct	number	%	Basis tính trọng số theo khối lượng danh nghĩa 24h.
perp.aggregate.vol_weight_usd	number	USD	Tổng các trọng số khối lượng đã dùng.
perp.aggregate.n_vol_weighted	number	—	Số dòng có trọng số khối lượng.
perp.aggregate.median_pct	number	%	Trung vị basis, mỗi sàn lấy một hợp đồng chính.
perp.aggregate.mean_pct	number	%	Trung bình cộng trên cùng tập dùng cho trung vị.
perp.aggregate.n_exchanges	number	—	Số sàn trong số liệu tổng hợp.
perp.aggregate.n_contracts	number	—	Số hợp đồng trong số liệu tổng hợp.
perp.aggregate.min	object	—	Sàn và hợp đồng có basis thấp nhất.
perp.aggregate.min.exchange	string	—	ID sàn (viết thường).
perp.aggregate.min.symbol	string	—	Ký hiệu hợp đồng theo dạng lưu trữ của CoinBoss.
perp.aggregate.min.basis_pct	number	%	(mark − index) ÷ index × 100 với hợp đồng vĩnh cửu và hợp đồng giao sau có kỳ hạn; trong các bảng xếp hạng là trung vị đa sàn.
perp.aggregate.max	object	—	Sàn và hợp đồng có basis cao nhất.
perp.aggregate.max.exchange	string	—	ID sàn (viết thường).
perp.aggregate.max.symbol	string	—	Ký hiệu hợp đồng theo dạng lưu trữ của CoinBoss.
perp.aggregate.max.basis_pct	number	%	(mark − index) ÷ index × 100 với hợp đồng vĩnh cửu và hợp đồng giao sau có kỳ hạn; trong các bảng xếp hạng là trung vị đa sàn.
perp.aggregate.median_last_pct	number	%	Trung vị của basis theo giá khớp gần nhất.
perp.aggregate.n_exchanges_last	number	—	Số sàn trong trung vị theo giá khớp gần nhất.
perp.aggregate.weights	object	—	Các trọng số lấy từ đâu, khung dữ liệu mới của chúng và tuổi của trọng số cũ nhất.
perp.aggregate.weights.oi	object	—	Vị thế mở.
perp.aggregate.weights.oi.source	string	—	Các endpoint công khai của nguồn (upstream) mà dữ liệu được thu thập từ đó.
perp.aggregate.weights.oi.fresh_window_s	number	s	Trọng số cũ hơn mức này sẽ không được dùng.
perp.aggregate.weights.oi.oldest_age_s	number	s	Tuổi của trọng số cũ nhất đã dùng.
perp.aggregate.weights.oi.side	string	—	Trọng số vị thế mở có phải là một chiều hay không.
perp.aggregate.weights.vol	object	—	Khối lượng.
perp.aggregate.weights.vol.source	string	—	Các endpoint công khai của nguồn (upstream) mà dữ liệu được thu thập từ đó.
perp.aggregate.weights.vol.fresh_window_s	number	s	Trọng số cũ hơn mức này sẽ không được dùng.
perp.aggregate.weights.vol.oldest_age_s	number	s	Tuổi của trọng số cũ nhất đã dùng.
perp.contracts	array	—	Mỗi hợp đồng một dòng.
perp.contracts[]	object	—	Mỗi hợp đồng một dòng.
perp.contracts[].exchange	string	—	ID sàn (viết thường).
perp.contracts[].symbol	string	—	Ký hiệu hợp đồng theo dạng lưu trữ của CoinBoss.
perp.contracts[].native_symbol	string	—	Ký hiệu hợp đồng đúng như cách sàn viết.
perp.contracts[].quote	string	—	Đồng yết giá của hợp đồng.
perp.contracts[].margin_type	string	—	Loại ký quỹ của hợp đồng (ví dụ ký quỹ USDT, ký quỹ bằng coin).
perp.contracts[].multiplier	number	—	Số coin trên mỗi đơn vị yết giá (1000 với các hợp đồng kiểu `1000PEPE`). Basis không bị ảnh hưởng.
perp.contracts[].mark_price	number\|null	—	Giá đánh dấu do sàn công bố.
perp.contracts[].index_price	number\|null	—	Giá chỉ số do sàn công bố.
perp.contracts[].last_price	number\|null	—	Giá khớp gần nhất.
perp.contracts[].index_kind	string\|null	—	Chỉ số này là gì: `exchange_index`, `oracle`, hoặc một loại khác được hiển thị nhưng không đưa vào số liệu tổng hợp.
perp.contracts[].basis_pct	number\|null	%	(mark − index) ÷ index × 100 với hợp đồng vĩnh cửu và hợp đồng giao sau có kỳ hạn; trong các bảng xếp hạng là trung vị đa sàn.
perp.contracts[].basis_abs	number\|null	—	mark − index, tính bằng đồng yết giá.
perp.contracts[].basis_last_pct	number\|null	%	(last − index) ÷ index × 100; `null` khi không có giao dịch gần đây.
perp.contracts[].basis_last_reason	string\|null	—	Vì sao `basis_last_pct` là null.
perp.contracts[].index_lag_s	number\|null	s	Số giây giữa dấu thời gian của giá đánh dấu và dấu thời gian của giá chỉ số trong dòng.
perp.contracts[].oi_usd	number\|null	USD	Vị thế mở của hợp đồng, một chiều; dùng làm trọng số.
perp.contracts[].vol_usd_24h	number\|null	USD	Khối lượng danh nghĩa 24h của hợp đồng; dùng làm trọng số.
perp.contracts[].primary	boolean	—	True với hợp đồng đại diện cho sàn của nó trong trung vị và trung bình.
perp.contracts[].in_aggregate	boolean	—	True khi dòng đạt các quy tắc đưa vào số liệu tổng hợp.
perp.contracts[].excluded_reason	string\|null	—	Vì sao dòng không nằm trong số liệu tổng hợp.
perp.contracts[].last_ts	number\|null	ms	Thời điểm của giao dịch gần nhất.
perp.contracts[].observed_at	number\|null	ms	Dấu thời gian do nguồn cung cấp cho dữ liệu.
perp.contracts[].received_at	number	ms	Thời điểm trình thu thập của CoinBoss nhận được dữ liệu.
perp.contracts[].age_s	number	s	Số giây kể từ khi dòng được nhận.
spot_perp	object	—	Giá hợp đồng vĩnh cửu so với giá giao ngay của cùng một sàn.
spot_perp.unit	string	—	Đơn vị của các giá trị basis (phần trăm).
spot_perp.aggregate	object	—	Số liệu tổng hợp đa sàn của phần này.
spot_perp.aggregate.oi_weighted_pct	number	%	Basis tính trọng số theo vị thế mở; các dòng không có trọng số OI bị loại.
spot_perp.aggregate.oi_weight_usd	number	USD	Tổng các trọng số vị thế mở đã dùng.
spot_perp.aggregate.n_oi_weighted	number	—	Số dòng có trọng số OI.
spot_perp.aggregate.vol_weighted_pct	number	%	Basis tính trọng số theo khối lượng danh nghĩa 24h.
spot_perp.aggregate.vol_weight_usd	number	USD	Tổng các trọng số khối lượng đã dùng.
spot_perp.aggregate.n_vol_weighted	number	—	Số dòng có trọng số khối lượng.
spot_perp.aggregate.median_pct	number	%	Trung vị basis, mỗi sàn lấy một hợp đồng chính.
spot_perp.aggregate.mean_pct	number	%	Trung bình cộng trên cùng tập dùng cho trung vị.
spot_perp.aggregate.n_exchanges	number	—	Số sàn trong số liệu tổng hợp.
spot_perp.aggregate.n_contracts	number	—	Số hợp đồng trong số liệu tổng hợp.
spot_perp.aggregate.min	object	—	Sàn và hợp đồng có basis thấp nhất.
spot_perp.aggregate.min.exchange	string	—	ID sàn (viết thường).
spot_perp.aggregate.min.symbol	string	—	Ký hiệu hợp đồng theo dạng lưu trữ của CoinBoss.
spot_perp.aggregate.min.basis_pct	number	%	(mark − index) ÷ index × 100 với hợp đồng vĩnh cửu và hợp đồng giao sau có kỳ hạn; trong các bảng xếp hạng là trung vị đa sàn.
spot_perp.aggregate.max	object	—	Sàn và hợp đồng có basis cao nhất.
spot_perp.aggregate.max.exchange	string	—	ID sàn (viết thường).
spot_perp.aggregate.max.symbol	string	—	Ký hiệu hợp đồng theo dạng lưu trữ của CoinBoss.
spot_perp.aggregate.max.basis_pct	number	%	(mark − index) ÷ index × 100 với hợp đồng vĩnh cửu và hợp đồng giao sau có kỳ hạn; trong các bảng xếp hạng là trung vị đa sàn.
spot_perp.pairs	array	—	Mỗi cặp hợp đồng vĩnh cửu / giao ngay của cùng một sàn một dòng.
spot_perp.pairs[]	object	—	Mỗi cặp hợp đồng vĩnh cửu / giao ngay của cùng một sàn một dòng.
spot_perp.pairs[].exchange	string	—	ID sàn (viết thường).
spot_perp.pairs[].symbol	string	—	Ký hiệu hợp đồng theo dạng lưu trữ của CoinBoss.
spot_perp.pairs[].spot_symbol	string	—	Thị trường giao ngay được dùng làm vế giao ngay.
spot_perp.pairs[].quote	string	—	Đồng yết giá của hợp đồng.
spot_perp.pairs[].spot_mult	number	—	Hệ số áp dụng cho giá giao ngay để cả hai vế yết giá cho cùng một số lượng.
spot_perp.pairs[].futures_price	number\|null	—	Giá hợp đồng vĩnh cửu được dùng; xem `price_kind`.
spot_perp.pairs[].price_kind	string\|null	—	Giá hợp đồng vĩnh cửu nào đã được dùng: `last` hoặc `mark`.
spot_perp.pairs[].spot_price	number	—	Giá khớp gần nhất của giao ngay, sau khi áp dụng `spot_mult`.
spot_perp.pairs[].basis_pct	number\|null	%	(mark − index) ÷ index × 100 với hợp đồng vĩnh cửu và hợp đồng giao sau có kỳ hạn; trong các bảng xếp hạng là trung vị đa sàn.
spot_perp.pairs[].basis_last_pct	number\|null	%	(last − index) ÷ index × 100; `null` khi không có giao dịch gần đây.
spot_perp.pairs[].basis_mark_pct	number\|null	%	(mark − spot) ÷ spot × 100.
spot_perp.pairs[].leg_gap_s	number	s	Số giây giữa dấu thời gian của hai vế.
spot_perp.pairs[].spot_time_kind	string	—	Dấu thời gian giao ngay là gì (thời điểm giao dịch hay thời điểm nhận).
spot_perp.pairs[].spot_vol_24h	number\|null	—	Giá trị giao dịch 24h của thị trường giao ngay, tính bằng đồng yết giá của nó.
spot_perp.pairs[].oi_usd	number\|null	USD	Vị thế mở của hợp đồng, một chiều; dùng làm trọng số.
spot_perp.pairs[].vol_usd_24h	number\|null	USD	Khối lượng danh nghĩa 24h của hợp đồng; dùng làm trọng số.
spot_perp.pairs[].primary	boolean	—	True với hợp đồng đại diện cho sàn của nó trong trung vị và trung bình.
spot_perp.pairs[].in_aggregate	boolean	—	True khi dòng đạt các quy tắc đưa vào số liệu tổng hợp.
spot_perp.pairs[].excluded_reason	string\|null	—	Vì sao dòng không nằm trong số liệu tổng hợp.
spot_perp.pairs[].received_at	number	ms	Thời điểm trình thu thập của CoinBoss nhận được dữ liệu.
spot_perp.pairs[].spot_received_at	number	ms	Thời điểm nhận được vế giao ngay.
delivery	object	—	Basis hợp đồng giao sau có kỳ hạn (delivery).
delivery.unit	string	—	Đơn vị của các giá trị basis (phần trăm).
delivery.contracts	array	—	Mỗi hợp đồng một dòng.
delivery.contracts[]	object	—	Mỗi hợp đồng một dòng.
delivery.contracts[].exchange	string	—	ID sàn (viết thường).
delivery.contracts[].symbol	string	—	Ký hiệu hợp đồng theo dạng lưu trữ của CoinBoss.
delivery.contracts[].native_symbol	string	—	Ký hiệu hợp đồng đúng như cách sàn viết.
delivery.contracts[].quote	string	—	Đồng yết giá của hợp đồng.
delivery.contracts[].margin_type	string	—	Loại ký quỹ của hợp đồng (ví dụ ký quỹ USDT, ký quỹ bằng coin).
delivery.contracts[].expiry_ts	number	ms	Thời điểm đáo hạn của hợp đồng giao sau có kỳ hạn.
delivery.contracts[].days_to_expiry	number	days	Số ngày đến đáo hạn.
delivery.contracts[].mark_price	number	—	Giá đánh dấu do sàn công bố.
delivery.contracts[].last_price	number\|null	—	Giá khớp gần nhất.
delivery.contracts[].index_price	number	—	Giá chỉ số do sàn công bố.
delivery.contracts[].index_kind	string	—	Chỉ số này là gì: `exchange_index`, `oracle`, hoặc một loại khác được hiển thị nhưng không đưa vào số liệu tổng hợp.
delivery.contracts[].basis_pct	number	%	(mark − index) ÷ index × 100 với hợp đồng vĩnh cửu và hợp đồng giao sau có kỳ hạn; trong các bảng xếp hạng là trung vị đa sàn.
delivery.contracts[].annualized_pct	number\|null	% per year	basis_pct × 365 ÷ số ngày đến đáo hạn, lãi đơn; `null` trong ngày cuối cùng.
delivery.contracts[].basis_reason	null	—	Vì sao `basis_pct` là null.
delivery.contracts[].index_lag_s	number	s	Số giây giữa dấu thời gian của giá đánh dấu và dấu thời gian của giá chỉ số trong dòng.
delivery.contracts[].basis_last_pct	number\|null	%	(last − index) ÷ index × 100; `null` khi không có giao dịch gần đây.
delivery.contracts[].annualized_last_pct	number\|null	% per year	Basis quy năm tính theo giá khớp gần nhất.
delivery.contracts[].spot_symbol	string\|null	—	Thị trường giao ngay được dùng làm vế giao ngay.
delivery.contracts[].spot_price	number\|null	—	Giá khớp gần nhất của giao ngay, sau khi áp dụng `spot_mult`.
delivery.contracts[].spot_price_kind	string\|null	—	Giá hợp đồng tương lai nào đã được so với giao ngay.
delivery.contracts[].basis_spot_pct	number\|null	%	(futures − giao ngay cùng sàn) ÷ spot × 100.
delivery.contracts[].annualized_spot_pct	number\|null	% per year	Basis quy năm so với giao ngay cùng sàn.
delivery.contracts[].annualized_reason	string\|null	—	Vì sao giá trị quy năm là null (ví dụ `expiry_lt_1d`).
delivery.contracts[].oi_usd	number\|null	USD	Vị thế mở của hợp đồng, một chiều; dùng làm trọng số.
delivery.contracts[].vol_usd_24h	number\|null	USD	Khối lượng danh nghĩa 24h của hợp đồng; dùng làm trọng số.
delivery.contracts[].last_ts	number\|null	ms	Thời điểm của giao dịch gần nhất.
delivery.contracts[].observed_at	number\|null	ms	Dấu thời gian do nguồn cung cấp cho dữ liệu.
delivery.contracts[].received_at	number	ms	Thời điểm trình thu thập của CoinBoss nhận được dữ liệu.
delivery.contracts[].age_s	number	s	Số giây kể từ khi dòng được nhận.
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.
coverage.unavailable[]	object	—	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.
coverage.unavailable[].exchange	string	—	ID sàn (viết thường).
coverage.unavailable[].reason	string	—	Mã lý do máy đọc được.
coverage.unavailable[].detail	string	—	Giải thích lý do cho người đọc.
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.missing_fields	array	—	Các sàn không công bố một trong các loại giá.
coverage.excluded_from_aggregate	array	—	Các dòng được hiển thị nhưng bị loại khỏi số liệu tổng hợp, mỗi dòng kèm lý do.
coverage.excluded_from_aggregate[]	object	—	Các dòng được hiển thị nhưng bị loại khỏi số liệu tổng hợp, mỗi dòng kèm lý do.
coverage.excluded_from_aggregate[].exchange	string	—	ID sàn (viết thường).
coverage.excluded_from_aggregate[].symbol	string	—	Ký hiệu hợp đồng theo dạng lưu trữ của CoinBoss.
coverage.excluded_from_aggregate[].section	string	—	Phần mà dòng thuộc về.
coverage.excluded_from_aggregate[].reason	string	—	Mã lý do máy đọc được.
coverage.stock_excluded	array	—	Các hợp đồng vĩnh cửu cổ phiếu trùng ticker và đã bị loại bỏ. rỗng trong các mẫu dùng để tạo bảng này
coverage.dropped_delisted_rows	number	—	Các dòng bị loại vì hợp đồng đã ngừng cập nhật.
coverage.delivery_unavailable	array	—	Các sàn có hợp đồng giao sau có kỳ hạn không được thu thập.
coverage.delivery_unavailable[]	object	—	Các sàn có hợp đồng giao sau có kỳ hạn không được thu thập.
coverage.delivery_unavailable[].exchange	string	—	ID sàn (viết thường).
coverage.delivery_unavailable[].reason	string	—	Mã lý do máy đọc được.
coverage.delivery_unavailable[].detail	string	—	Giải thích lý do cho người đọc.
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.perp.basis_pct	string	—	Ghi chú công thức cho `perp.basis_pct`, dạng văn bản thuần.
method.perp.basis_last_pct	string	—	Ghi chú công thức cho `perp.basis_last_pct`, dạng văn bản thuần.
method.perp.aggregate.oi_weighted_pct	string	—	Ghi chú công thức cho `perp.aggregate.oi_weighted_pct`, dạng văn bản thuần.
method.perp.aggregate.vol_weighted_pct	string	—	Ghi chú công thức cho `perp.aggregate.vol_weighted_pct`, dạng văn bản thuần.
method.perp.aggregate.median_pct	string	—	Ghi chú công thức cho `perp.aggregate.median_pct`, dạng văn bản thuần.
method.perp.aggregate.inclusion	string	—	Ghi chú công thức cho `perp.aggregate.inclusion`, dạng văn bản thuần.
method.spot_perp.basis_pct	string	—	Ghi chú công thức cho `spot_perp.basis_pct`, dạng văn bản thuần.
method.spot_perp.aggregate.inclusion	string	—	Ghi chú công thức cho `spot_perp.aggregate.inclusion`, dạng văn bản thuần.
method.delivery.basis_pct	string	—	Ghi chú công thức cho `delivery.basis_pct`, dạng văn bản thuần.
method.delivery.annualized_pct	string	—	Ghi chú công thức cho `delivery.annualized_pct`, dạng văn bản thuần.
method.index_lag_s	string	—	Ghi chú công thức cho `index_lag_s`, dạng văn bản thuần.
method.multiplier	string	—	Ghi chú công thức cho `multiplier`, 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[].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.
coverage.missing_fields[]	object	—	Các sàn không công bố một trong các loại giá.
coverage.missing_fields[].exchange	string	—	ID sàn (viết thường).
coverage.missing_fields[].symbol	string	—	Ký hiệu hợp đồng theo dạng lưu trữ của CoinBoss.
coverage.missing_fields[].missing	string	—	Loại giá mà sàn không công bố (`mark` hoặc `index`).

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

Phản hồi mẫu

/api/sd/basis?coin=BTC · Phản hồi thật, ghi lại lúc 2026-11-13 03:52:48 UTC. Mảng và map dài được rút gọn khi hiển thị: meta.source có 20 phần tử; perp.contracts có 37 phần tử; spot_perp.pairs có 22 phần tử; delivery.contracts có 53 phần tử; coverage.unavailable có 4 phần tử; coverage.included_exchanges có 20 phần tử.

{
- "success": true,
- "schema": "coinboss.sd.basis/1",
- "now": 1794541956692,
- "coin": "BTC",
- "perp": {
  - "unit": "percent",
  - "aggregate": { … 15 },
  - "contracts": [ … 1 ]
  },
- "spot_perp": {
  - "unit": "percent",
  - "aggregate": { … 12 },
  - "pairs": [ … 1 ]
  },
- "delivery": {
  - "unit": "percent",
  - "contracts": [ … 1 ]
  },
- "coverage": {
  - "included_exchanges": [ … 8 ],
  - "unavailable": [ … 1 ],
  - "stale_excluded": [],
  - "missing_fields": [],
  - "excluded_from_aggregate": [ … 1 ],
  - "stock_excluded": [],
  - "dropped_delisted_rows": 0,
  - "delivery_unavailable": [ … 1 ]
  },
- "method": {
  - "perp.basis_pct": "(mark_price - index_price) / index_price * 100, percent; mark and index are both published by the same exchange for that…",
  - "perp.basis_last_pct": "(last_price - index_price) / index_price * 100; null when the exchange gives no last-trade price or the last trade is mo…",
  - "perp.aggregate.oi_weighted_pct": "sum(basis_pct * oi_usd) / sum(oi_usd) over all included perpetual contracts that have an open-interest weight; oi_usd fr…",
  - "perp.aggregate.vol_weighted_pct": "same with 24h notional volume (market_tickers.volume_usd / sd_contract_latest.vol_usd_24h, <= 1 h old) as weight",
  - "perp.aggregate.median_pct": "median of basis_pct over one primary contract per exchange (largest OI, then volume, then USDT-margined); mean_pct is th…",
  - "perp.aggregate.inclusion": "row is fresh (<= 180 s), basis_pct is not null, index_kind is exchange_index or oracle, the contract traded within 24 h …",
  - "spot_perp.basis_pct": "(perp last_price, or mark_price when last is unusable - spot last price * spot_mult) / (spot last price * spot_mult) * 1…",
  - "spot_perp.aggregate.inclusion": "as perp, plus spot 24h turnover >= 10000 (quote currency) when the exchange reports it",
  - "delivery.basis_pct": "(F - S) / S * 100 with F = mark_price and S = the exchange index price of the underlying; basis_last_pct uses F = last_p…",
  - "delivery.annualized_pct": "basis_pct * 365 / days_to_expiry, simple (not compounded); null when days_to_expiry < 1; days_to_expiry = (expiry_ts - p…",
  - "index_lag_s": "seconds between the mark timestamp and the index timestamp of the row; 0 when the exchange returns both in one response;…",
  - "multiplier": "contract units per coin (1000PEPE, kPEPE = 1000); mark and index carry the same multiplier so basis_pct is unaffected; s…"
  },
- "meta": {
  - "schema": "coinboss.sd.basis/1",
  - "source": [ … 1 ],
  - "observed_at": 1794539247345,
  - "received_at": 1794539247425,
  - "fetched_at": 1794541956692,
  - "window": "latest",
  - "quality": "STALE",
  - "is_stale": true,
  - "cache_ttl_s": 20,
  - "fallback": "rows older than 180 s are excluded; if no exchange is fresh the last stored rows (<= 1 h old) are served with is_stale=t…",
  - "collector_heartbeat_age_s": 2759
  }
}

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	200	28 ms	Đạt STALE
coin=SOL	200	26 ms	Đạt STALE
coin=PEPE	200	26 ms	Đạt STALE
—	400	2 ms	Đạt trả về lỗi như dự kiến

Kiểm tra lúc 2026-11-13 03:28: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ủ: 20s
Micro-cache biên: 10s
Tần suất cập nhật: Trình thu thập chạy một vòng mỗi 60 giây; một dòng được coi là còn mới trong 180 giây. Các ảnh chụp theo giờ là nguồn cho dữ liệu lịch sử.
Khung thời gian: Giá trị mới nhất của từng hợp đồng.
Nguồn dữ liệu: Giá đánh dấu, giá chỉ số và giá khớp gần nhất do 21 sàn phái sinh công bố, cùng giá giao ngay của chính sàn đó, do CoinBoss thu thập và lưu trữ (sd_px_latest, sd_px_hourly).
Độ phủ sàn: 21 sàn. Các sàn không công bố giá chỉ số hoặc giá đánh dấu được liệt kê trong `coverage.unavailable`; các dòng có hai vế giá cách nhau hơn 60 giây trả về `null`. Các dòng bị loại khỏi số liệu tổng hợp được liệt kê trong `coverage.excluded_from_aggregate` kèm lý do.
Phân trang: Không phân trang.
Sắp xếp: Hợp đồng có vị thế mở lớn nhất xếp trước.
Đơn vị: All basis values in percent. Prices in the quote currency of the contract (USDT / USDC / USD). `oi_usd` single-sided.
Phương pháp: Perpetual: basis_pct = (mark − index) ÷ index × 100. Spot-perp: (perpetual price − spot price) ÷ spot price × 100, same exchange and quote currency. Delivery: basis_pct = (futures − index) ÷ index × 100; annualized_pct = basis_pct × 365 ÷ days to expiry (simple interest; `null` inside the last day). Aggregates use one primary contract per exchange; a row enters only if it is fresh, traded within 24 hours and |basis| ≤ 10 %.
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

Suy giảmKiểm tra lúc 2026-11-13 03:52:48 UTCHTTP 2001 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 45m

Endpoint báo cáo chất lượng dữ liệu STALE

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

100% trong 406 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/basisSuy giảm

Tham số

coin Bắt buộc

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

URL yêu cầuhttps://www.coinboss.com/api/sd/basis?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.

Basis hợp đồng tương lai (mọi sàn) /api/sd/basis
Lịch sử basis (theo giờ) /api/sd/basis/history
Xếp hạng coin theo basis /api/sd/basis/rank
Danh sách basis giữa hợp đồng tương lai và giao ngay /api/derivatives/basis
Chênh lệch giá BTC hằng ngày giữa Coinbase và Kraken /api/p3/cb-kr-spread
Chỉ số premium Bitcoin của Coinbase /api/p3/coinbase-premium
Danh sách chỉ số premium hợp đồng vĩnh cửu /api/p3/premium-index
Lịch sử chỉ số premium của một coin /api/p3/premium-index/history
Nến chỉ số premium /api/p3/premium-index/klines
Premium OTC của USDT so với tỷ giá tiền pháp định /api/usdt-premium
Danh sách đầy đủ basis giữa hợp đồng tương lai và giao ngay /api/basis/list