GETKhả dụng
Gói dữ liệu coin trong một lần gọi (OI, funding, thanh lý, khối lượng, long/short)
Lớp dữ liệu tự thu thập: gói dữ liệu coin trong một lần gọi (OI / funding / thanh lý / khối lượng / long-short, cô lập lỗi theo từng khối)
GET
/api/sd/coinYê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; 400 khi thiếu. Bí danh: `base`. Ví dụ: BTC |
Yêu cầu mẫu
curl -s "https://www.coinboss.com/api/sd/coin?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 }`. |
| coin | string | — | Ký hiệu coin, viết hoa (ví dụ BTC). |
| now | number | ms | Thời gian máy chủ lúc phản hồi được dựng. |
| oi | object | — | Cùng object mà `/api/sd/oi` trả về cho coin này. |
| oi.coin | string | — | Ký hiệu coin, viết hoa (ví dụ BTC). |
| oi.now | number | ms | Thời gian máy chủ lúc phản hồi được dựng. |
| oi.total_usd | number | USD | Vị thế mở trên mọi sàn và hợp đồng được tính, đúng như từng sàn báo cáo (giá trị danh nghĩa USD). |
| oi.n_exchanges | number | — | Số sàn trong tổng. |
| oi.n_contracts | number | — | Số hợp đồng trong tổng. |
| oi.asof | number | ms | Thời điểm cập nhật mới nhất trong các dòng được tính. |
| oi.total_usd_single_adjusted | number | USD | `total_usd` sau khi chia đôi số liệu của những sàn báo cáo cả hai chiều (`double_sided.exchanges`), để mọi sàn đều chỉ tính một chiều. |
| oi.double_sided | object | — | Các sàn được biết là công bố vị thế mở long + short gộp thành một con số. |
| oi.double_sided.exchanges | array | — | Các sàn. |
| oi.double_sided.exchanges[] | string | — | Các sàn. |
| oi.double_sided.oi_usd | number | USD | Vị thế mở do các sàn đó báo cáo, trước khi chia đôi. |
| oi.by_kind | object | — | Tách theo linear / inverse. |
| oi.by_kind.linear_usd | number | USD | Vị thế mở của hợp đồng linear (ký quỹ và thanh toán bằng stablecoin hoặc USD). |
| oi.by_kind.inverse_usd | number | USD | Vị thế mở của hợp đồng inverse (ký quỹ bằng coin), quy đổi sang USD theo giá hợp đồng. |
| oi.by_margin | object | — | Tách theo đồng ký quỹ. |
| oi.by_margin.other | number | USD | Các đồng ký quỹ khác (ví dụ những sàn thanh toán bằng USD như CME). |
| oi.by_margin.usdt | number | USD | Hợp đồng ký quỹ USDT. |
| oi.by_margin.usdc | number | USD | Hợp đồng ký quỹ USDC. có thể vắng mặt |
| oi.by_margin.coin | number | USD | Hợp đồng ký quỹ bằng coin. có thể vắng mặt |
| oi.by_contract_type | object | — | Tách theo hợp đồng vĩnh cửu / hợp đồng giao sau có kỳ hạn. |
| oi.by_contract_type.perpetual_usd | number | USD | Hợp đồng vĩnh cửu. |
| oi.by_contract_type.delivery_usd | number | USD | Hợp đồng giao sau có kỳ hạn (delivery). |
| oi.change | object | — | Thay đổi vị thế mở trong 1h / 4h / 24h, tính trên cùng một tập hợp đồng ở cả hai đầu. khóa động: h1,h4,h24 |
| oi.change.{*} | object | — | Thay đổi trong kỳ đã nêu. |
| oi.change.{*}.pct | number | % | Phần trăm thay đổi giữa `prev` và `cur`. |
| oi.change.{*}.cur | number | USD | Tổng hiện tại trên các hợp đồng đã khớp. |
| oi.change.{*}.prev | number | USD | Tổng trên chính các hợp đồng đó tại `prev_ts`. |
| oi.change.{*}.n_matched | number | — | Số hợp đồng (hoặc sàn) có mặt ở cả hai đầu. |
| oi.change.{*}.n_total | number | — | Số hợp đồng (hoặc sàn) có mặt hiện tại. |
| oi.change.{*}.matched_share_pct | number | % | Tỷ trọng vị thế mở hiện tại được tập đã khớp bao phủ. có thể vắng mặt |
| oi.change.{*}.prev_ts | number | ms | Thời điểm của ảnh chụp mốc so sánh. |
| oi.change.{*}.span_min | number | min | Khoảng cách thực tế giữa mốc so sánh và hiện tại. |
| oi.change.{*}.basis | string | — | Mốc so sánh lấy từ chuỗi ảnh chụp nào. |
| oi.change.{*}.frozen_excluded | object | — | Các dòng bị loại khỏi phép tính thay đổi vì giá trị không dịch chuyển giữa hai ảnh chụp (nguồn không cập nhật). có thể vắng mặt |
| oi.change.{*}.frozen_excluded.n_baseline | number | — | Số mục trong ảnh chụp mốc so sánh. có thể vắng mặt |
| oi.change.{*}.frozen_excluded.n_current | number | — | Số mục trong ảnh chụp hiện tại. có thể vắng mặt |
| oi.change.{*}.frozen_excluded.cur_usd | number | USD | Giá trị hiện tại. có thể vắng mặt |
| oi.change.{*}.frozen_excluded.prev_usd | number | USD | Giá trị mốc so sánh. có thể vắng mặt |
| oi.by_exchange | array | — | Phần tách theo từng sàn. |
| oi.by_exchange[] | object | — | Phần tách theo từng sàn. |
| oi.by_exchange[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| oi.by_exchange[].oi_usd | number | USD | Vị thế mở tính theo giá trị danh nghĩa USD. |
| oi.by_exchange[].share_pct | number | % | Tỷ trọng trong tổng. |
| oi.by_exchange[].n_contracts | number | — | Số hợp đồng. |
| oi.by_exchange[].linear_usd | number | USD | Hợp đồng linear. |
| oi.by_exchange[].inverse_usd | number | USD | Hợp đồng inverse (ký quỹ bằng coin). |
| oi.by_exchange[].perpetual_usd | number | USD | Hợp đồng vĩnh cửu. |
| oi.by_exchange[].delivery_usd | number | USD | Hợp đồng giao sau có kỳ hạn. |
| oi.by_exchange[].oi_side | string | — | `double` khi sàn báo cáo cả hai chiều trong một con số, `single` khi sàn báo cáo một chiều, `unstated` khi sàn không nêu trong tài liệu. |
| oi.by_exchange[].oi_usd_single_adjusted | number|null | USD | Giá trị quy đổi một chiều; null khi quy ước về chiều không được nêu. |
| oi.by_exchange[].updated_at | number | ms | Thời điểm dòng này được cập nhật lần cuối. |
| oi.by_exchange[].age_s | number | s | Số giây kể từ lần cập nhật gần nhất của dòng này. |
| oi.by_exchange[].is_stale | boolean | — | true khi dòng cũ hơn khung dữ liệu mới; dòng quá hạn không được dùng trong các tổng. |
| oi.contracts | array | — | Các dòng theo từng hợp đồng. |
| oi.contracts[] | object | — | Các dòng theo từng hợp đồng. |
| oi.contracts[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| oi.contracts[].symbol | string | — | Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT). |
| oi.contracts[].native_symbol | string|null | — | Ký hiệu đúng như cách sàn viết. |
| oi.contracts[].oi_usd | number | USD | Vị thế mở tính theo giá trị danh nghĩa USD. |
| oi.contracts[].oi_side | string | — | `double`, `single` hoặc `unstated`: sàn có báo cáo cả hai chiều của vị thế mở trong một con số hay không. |
| oi.contracts[].oi_usd_single | number|null | USD | Giá trị quy đổi một chiều của `oi_usd`; null khi quy ước về chiều không được nêu. |
| oi.contracts[].margin | string | — | Nhóm đồng ký quỹ: `usdt`, `usdc`, `coin` hoặc `other`. |
| oi.contracts[].kind | string | — | `linear` hoặc `inverse`. |
| oi.contracts[].contract_type | string | — | `perpetual` hoặc `delivery`. |
| oi.contracts[].expiry_ts | number|null | ms | Ngày đáo hạn của hợp đồng giao sau có kỳ hạn; null với hợp đồng vĩnh cửu hoặc khi không được công bố. |
| oi.contracts[].margin_basis | string | — | Cách xác định nhóm ký quỹ (từ đặc tả hợp đồng hoặc mặc định của sàn). |
| oi.contracts[].updated_at | number | ms | Thời điểm dòng này được cập nhật lần cuối. |
| oi.contracts[].age_s | number | s | Số giây kể từ lần cập nhật gần nhất của dòng này. |
| oi.contracts[].is_stale | boolean | — | true khi dòng cũ hơn khung dữ liệu mới; dòng quá hạn không được dùng trong các tổng. |
| oi.contracts[].collector | string | — | Trình thu thập nội bộ đã tạo ra dòng này. |
| oi.contracts[].included_since | number|null | ms | Thời điểm hợp đồng này được đưa vào các tổng; null với tập cơ sở. |
| oi.coverage | object | — | Những gì được tính và không được tính trong các con số ở trên. 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. |
| oi.coverage.included_exchanges | array | — | Các sàn có dữ liệu được tính vào các tổng. |
| oi.coverage.included_exchanges[] | string | — | Các sàn được tính vào các tổng. |
| oi.coverage.pending | array | — | Các hợp đồng đã được thu thập nhưng chưa được tính vào tổng (ví dụ khi lịch sử 25 giờ của riêng chúng còn đang được tích lũy). Được liệt kê kèm giá trị hiện tại để thấy rõ phần chênh. |
| oi.coverage.pending[] | object | — | Các mục đã thu thập nhưng chưa được tính. |
| oi.coverage.pending[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| oi.coverage.pending[].symbol | string | — | Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT). |
| oi.coverage.pending[].native_symbol | string | — | Ký hiệu đúng như cách sàn viết. |
| oi.coverage.pending[].margin | string | — | Nhóm đồng ký quỹ. |
| oi.coverage.pending[].contract_type | string | — | `perpetual` hoặc `delivery`. |
| oi.coverage.pending[].oi_usd | number | USD | Vị thế mở tính theo giá trị danh nghĩa USD. |
| oi.coverage.pending[].age_s | number | s | Số giây kể từ lần cập nhật gần nhất của dòng này. |
| oi.coverage.pending[].reason | string | — | Mã lý do. |
| oi.coverage.pending[].detail | string|null | — | Chi tiết. |
| oi.coverage.pending_usd | number|null | USD | Tổng của các hợp đồng đang chờ, không nằm trong `total_usd`. |
| oi.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 còn dùng được. rỗng trong các mẫu dùng để tạo bảng này |
| oi.coverage.unavailable | array | — | Các cặp sàn / hợp đồng không thể đưa vào, mỗi cặp kèm một lý do. Chúng không bao giờ bị tính là 0. |
| oi.coverage.unavailable[] | object | — | Các mục không có dữ liệu, kèm lý do. Không bao giờ được báo là 0. |
| oi.coverage.unavailable[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| oi.coverage.unavailable[].symbol | string | — | Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT). |
| oi.coverage.unavailable[].native_symbol | string | — | Ký hiệu đúng như cách sàn viết. |
| oi.coverage.unavailable[].margin | string | — | Nhóm đồng ký quỹ. |
| oi.coverage.unavailable[].contract_type | string | — | `perpetual` hoặc `delivery`. |
| oi.coverage.unavailable[].reason | string | — | Mã lý do. |
| oi.coverage.unavailable[].detail | string | — | Chi tiết. |
| oi.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. |
| oi.method.total | string | — | Tổng. |
| oi.method.usd | string | USD | Giá trị. |
| oi.method.change_h1_h4 | string | — | Định nghĩa dạng văn bản thuần của thay đổi vị thế mở 1h và 4h: mỗi hợp đồng được so với ảnh chụp của chính nó gần đầu khung thời gian nhất. |
| oi.method.change_h24 | string | — | Định nghĩa dạng văn bản thuần của thay đổi vị thế mở 24h: ghép cặp theo cùng sàn với ảnh chụp theo giờ gần mốc 24 giờ trước nhất, loại các mốc so sánh đứng yên. |
| oi.method.oi_side | string | — | `double`, `single` hoặc `unstated`: sàn có báo cáo cả hai chiều của vị thế mở trong một con số hay không. |
| funding | object | — | Cùng object mà `/api/sd/funding` trả về cho coin này. |
| funding.coin | string | — | Ký hiệu coin, viết hoa (ví dụ BTC). |
| funding.now | number | ms | Thời gian máy chủ lúc phản hồi được dựng. |
| funding.unit | string | — | Đơn vị của mọi trường tỷ lệ trong phản hồi này: `fraction` (0.0001 = 0.01 %). |
| funding.avg_8h | number | fraction per 8h | Trung bình cộng của các tỷ lệ đã chuẩn hóa 8h, mỗi sàn một hợp đồng. |
| funding.oi_weighted_8h | number | fraction per 8h | Trung bình trọng số theo vị thế mở của các tỷ lệ đã chuẩn hóa 8h. |
| funding.apr_pct | number | % per year | Quy năm đơn giản: tỷ lệ 8h × 3 × 365 × 100. |
| funding.apr_basis | string | — | `apr_pct` chính dựa trên số liệu tổng hợp nào. |
| funding.n_exchanges | number | — | Số sàn đóng góp dữ liệu. |
| funding.n_normalized | number | — | Các sàn đã biết chu kỳ funding và có thể chuẩn hóa về 8h. |
| funding.n_unknown_interval | number | — | Các sàn bị loại khỏi số liệu tổng hợp vì không rõ chu kỳ funding. |
| funding.settled_cum_7d | object | — | Tổng các tỷ lệ funding đã thực sự thanh toán trong 7 ngày qua, lấy trung bình trên các sàn có lịch sử thanh toán. |
| funding.settled_cum_7d.avg | number | fraction | Trung bình cộng trên các sàn. |
| funding.settled_cum_7d.oi_weighted | number | fraction | Trung bình trọng số theo vị thế mở. |
| funding.settled_cum_7d.n | number | — | Các sàn có đủ dữ liệu cho cả khung thời gian. |
| funding.settled_cum_30d | object | — | Tương tự, trong 30 ngày. |
| funding.settled_cum_30d.avg | number | fraction | Trung bình cộng trên các sàn. |
| funding.settled_cum_30d.oi_weighted | number | fraction | Trung bình trọng số theo vị thế mở. |
| funding.settled_cum_30d.n | number | — | Các sàn có đủ dữ liệu cho cả khung thời gian. |
| funding.by_exchange | array | — | Mỗi sàn một dòng: hợp đồng chính của sàn cho coin này (hợp đồng có vị thế mở lớn nhất). |
| funding.by_exchange[] | object | — | Phần tách theo từng sàn. |
| funding.by_exchange[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| funding.by_exchange[].symbol | string | — | Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT). |
| funding.by_exchange[].margin | string | — | Nhóm đồng ký quỹ. |
| funding.by_exchange[].kind | string | — | Loại. |
| funding.by_exchange[].primary | boolean | — | True đối với hợp đồng đại diện cho sàn của nó trong các số liệu tổng hợp (hợp đồng có vị thế mở lớn nhất); luôn là true trong danh sách này. |
| funding.by_exchange[].rate | number | — | Tỷ lệ. |
| funding.by_exchange[].interval_h | number | h | Chu kỳ. |
| funding.by_exchange[].rate_8h | number | — | Tỷ lệ được chuẩn hóa về chu kỳ 8 giờ. |
| funding.by_exchange[].apr_pct | number | % per year | Phần trăm quy năm. |
| funding.by_exchange[].next_funding_time | number|null | ms | Dấu thời gian. |
| funding.by_exchange[].next_derived | boolean | — | True khi `next_funding_time` không được sàn công bố mà được suy ra là giờ tròn UTC kế tiếp (chỉ với các sàn thanh toán theo giờ). |
| funding.by_exchange[].predicted_rate | null | — | Tỷ lệ tham khảo của kỳ tiếp theo; null khi không được công bố. |
| funding.by_exchange[].oi_usd | number|null | USD | Vị thế mở tính theo giá trị danh nghĩa USD. |
| funding.by_exchange[].updated_at | number | ms | Thời điểm dòng này được cập nhật lần cuối. |
| funding.by_exchange[].age_s | number | s | Số giây kể từ lần cập nhật gần nhất của dòng này. |
| funding.by_exchange[].is_stale | boolean | — | true khi dòng cũ hơn khung dữ liệu mới; dòng quá hạn không được dùng trong các tổng. |
| funding.by_exchange[].settled | object|null | — | Các bản ghi thanh toán thực tế; null khi không có lịch sử công khai. |
| funding.by_exchange[].settled.last_rate | number | fraction | Tỷ lệ funding thực tế đã áp dụng ở kỳ thanh toán gần nhất (`last_time`), lấy từ lịch sử funding của sàn (0.0001 = 0.01 %). có thể vắng mặt |
| funding.by_exchange[].settled.last_time | number | ms | Dấu thời gian. có thể vắng mặt |
| funding.by_exchange[].settled.interval_h | number | h | Chu kỳ. có thể vắng mặt |
| funding.by_exchange[].settled.cum_7d | number | fraction | Tổng các tỷ lệ funding đã thanh toán trên hợp đồng này trong 7 ngày qua (0.0015 = 0.15 %); null khi không ghi nhận kỳ thanh toán nào. có thể vắng mặt |
| funding.by_exchange[].settled.n_7d | number | count | Số bản ghi thanh toán thu thập được trong 7 ngày qua. có thể vắng mặt |
| funding.by_exchange[].settled.n_7d_expected | number | count | Số kỳ thanh toán mà một khung 7 ngày đầy đủ phải có: 168 ÷ chu kỳ thanh toán tính bằng giờ; null khi không rõ chu kỳ. có thể vắng mặt |
| funding.by_exchange[].settled.cum_7d_complete | boolean | — | True khi lịch sử phủ tới đầu khung 7 ngày và có ít nhất 90 % số kỳ thanh toán dự kiến. có thể vắng mặt |
| funding.by_exchange[].settled.cum_30d | number | fraction | Tổng các tỷ lệ funding đã thanh toán trên hợp đồng này trong 30 ngày qua (0.006 = 0.6 %). có thể vắng mặt |
| funding.by_exchange[].settled.n_30d | number | count | Số bản ghi thanh toán thu thập được trong 30 ngày qua. có thể vắng mặt |
| funding.by_exchange[].settled.n_30d_expected | number | count | Số kỳ thanh toán mà một khung 30 ngày đầy đủ phải có: 720 ÷ chu kỳ thanh toán tính bằng giờ; null khi không rõ chu kỳ. có thể vắng mặt |
| funding.by_exchange[].settled.cum_30d_complete | boolean | — | True khi lịch sử phủ tới đầu khung 30 ngày và có ít nhất 90 % số kỳ thanh toán dự kiến. có thể vắng mặt |
| funding.by_exchange[].settled.history_from | number | ms | Bản ghi sớm nhất đang lưu. có thể vắng mặt |
| funding.other_contracts | array | — | Các hợp đồng khác của cùng coin (USDC, ký quỹ bằng coin, …). Không nằm trong số liệu tổng hợp. |
| funding.other_contracts[] | object | — | Một hợp đồng funding bổ sung của sàn (ký quỹ bằng coin, USDC, …), không phải hợp đồng chính của sàn và bị loại khỏi các số liệu tổng hợp. |
| funding.other_contracts[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| funding.other_contracts[].symbol | string | — | Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT). |
| funding.other_contracts[].margin | string | — | Nhóm đồng ký quỹ. |
| funding.other_contracts[].kind | string | — | Loại. |
| funding.other_contracts[].primary | boolean | — | False ở mọi dòng của danh sách này: hợp đồng không phải là hợp đồng đại diện cho sàn của nó trong các số liệu tổng hợp. |
| funding.other_contracts[].rate | number | — | Tỷ lệ. |
| funding.other_contracts[].interval_h | number|null | h | Chu kỳ. |
| funding.other_contracts[].rate_8h | number|null | — | Tỷ lệ được chuẩn hóa về chu kỳ 8 giờ. |
| funding.other_contracts[].apr_pct | number|null | % per year | Phần trăm quy năm. |
| funding.other_contracts[].next_funding_time | number|null | ms | Dấu thời gian. |
| funding.other_contracts[].next_derived | boolean | — | True khi `next_funding_time` không được sàn công bố mà được suy ra là giờ tròn UTC kế tiếp (chỉ với các sàn thanh toán theo giờ). |
| funding.other_contracts[].predicted_rate | number|null | — | Tỷ lệ tham khảo của kỳ tiếp theo; null khi không được công bố. |
| funding.other_contracts[].oi_usd | number|null | USD | Vị thế mở tính theo giá trị danh nghĩa USD. |
| funding.other_contracts[].updated_at | number | ms | Thời điểm dòng này được cập nhật lần cuối. |
| funding.other_contracts[].age_s | number | s | Số giây kể từ lần cập nhật gần nhất của dòng này. |
| funding.other_contracts[].is_stale | boolean | — | true khi dòng cũ hơn khung dữ liệu mới; dòng quá hạn không được dùng trong các tổng. |
| funding.other_contracts[].settled | object|null | — | Các bản ghi thanh toán thực tế; null khi không có lịch sử công khai. |
| funding.other_contracts[].settled.last_rate | number | fraction | Tỷ lệ funding thực tế đã áp dụng ở kỳ thanh toán gần nhất (`last_time`), lấy từ lịch sử funding của sàn (0.0001 = 0.01 %). có thể vắng mặt |
| funding.other_contracts[].settled.last_time | number | ms | Dấu thời gian. có thể vắng mặt |
| funding.other_contracts[].settled.interval_h | number | h | Chu kỳ. có thể vắng mặt |
| funding.other_contracts[].settled.cum_7d | number | fraction | Tổng các tỷ lệ funding đã thanh toán trên hợp đồng này trong 7 ngày qua (0.0015 = 0.15 %); null khi không ghi nhận kỳ thanh toán nào. có thể vắng mặt |
| funding.other_contracts[].settled.n_7d | number | count | Số bản ghi thanh toán thu thập được trong 7 ngày qua. có thể vắng mặt |
| funding.other_contracts[].settled.n_7d_expected | number | count | Số kỳ thanh toán mà một khung 7 ngày đầy đủ phải có: 168 ÷ chu kỳ thanh toán tính bằng giờ; null khi không rõ chu kỳ. có thể vắng mặt |
| funding.other_contracts[].settled.cum_7d_complete | boolean | — | True khi lịch sử phủ tới đầu khung 7 ngày và có ít nhất 90 % số kỳ thanh toán dự kiến. có thể vắng mặt |
| funding.other_contracts[].settled.cum_30d | number | fraction | Tổng các tỷ lệ funding đã thanh toán trên hợp đồng này trong 30 ngày qua (0.006 = 0.6 %). có thể vắng mặt |
| funding.other_contracts[].settled.n_30d | number | count | Số bản ghi thanh toán thu thập được trong 30 ngày qua. có thể vắng mặt |
| funding.other_contracts[].settled.n_30d_expected | number | count | Số kỳ thanh toán mà một khung 30 ngày đầy đủ phải có: 720 ÷ chu kỳ thanh toán tính bằng giờ; null khi không rõ chu kỳ. có thể vắng mặt |
| funding.other_contracts[].settled.cum_30d_complete | boolean | — | True khi lịch sử phủ tới đầu khung 30 ngày và có ít nhất 90 % số kỳ thanh toán dự kiến. có thể vắng mặt |
| funding.other_contracts[].settled.history_from | number | ms | Bản ghi sớm nhất đang lưu. có thể vắng mặt |
| funding.coverage | object | — | Những gì được tính và không được tính trong các con số ở trên. 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. |
| funding.coverage.settle_history_exchanges | array | — | Các sàn được thu thập bản ghi thanh toán thực tế. |
| funding.coverage.settle_history_exchanges[] | string | — | ID của sàn có bản ghi thanh toán funding thực tế được thu thập cho coin này. |
| funding.coverage.no_settle_history | array | — | Các sàn không có nguồn lịch sử thanh toán công khai; `settled` của chúng là null. |
| funding.coverage.no_settle_history[] | string | — | ID sàn của một hợp đồng chính không có lịch sử thanh toán được thu thập, nên khối `settled` của nó là null. |
| funding.coverage.unknown_interval | array | — | Các dòng không xác định được chu kỳ funding. rỗng trong các mẫu dùng để tạo bảng này |
| funding.coverage.no_liveness_excluded | array | — | Các dòng bị loại vì hợp đồng không có dấu hiệu giao dịch (không có ticker, vị thế mở hay báo giá gần đây). rỗng trong các mẫu dùng để tạo bảng này |
| funding.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. |
| funding.method.rate | string | — | Tỷ lệ. |
| funding.method.rate_8h | string | — | Tỷ lệ được chuẩn hóa về chu kỳ 8 giờ. |
| funding.method.apr_pct | string | % per year | Phần trăm quy năm. |
| funding.method.aggregate | string | — | Số liệu tổng hợp trên các sàn. |
| funding.method.settled | string | — | Các bản ghi thanh toán thực tế; null khi không có lịch sử công khai. |
| funding.method.predicted_rate | string | — | Tỷ lệ tham khảo của kỳ tiếp theo; null khi không được công bố. |
| funding.method.liveness | string | — | Quy tắc dạng văn bản thuần để loại hợp đồng không còn hoạt động: một dòng funding chỉ được tính khi có ticker trong vòng 1h, vị thế mở trong vòng 3h hoặc báo giá riêng trong vòng 3h. |
| liquidations | object | — | Cùng object mà `/api/sd/liquidations` trả về cho coin này. |
| liquidations.coin | string | — | Ký hiệu coin, viết hoa (ví dụ BTC). |
| liquidations.now | number | ms | Thời gian máy chủ lúc phản hồi được dựng. |
| liquidations.windows | object | — | Tổng cho từng khung thời gian (các khóa như `1h`, `4h`, `12h`, `24h`). khóa động: 1h,4h,12h,24h |
| liquidations.windows.{*} | object | — | Giá trị theo từng khung thời gian. |
| liquidations.windows.{*}.long_usd | number | USD | Vị thế long bị thanh lý; null khi không nguồn nào phủ khung thời gian này. |
| liquidations.windows.{*}.short_usd | number | USD | Vị thế short bị thanh lý; null khi không nguồn nào phủ khung thời gian này. |
| liquidations.windows.{*}.total_usd | number | USD | Long + short. |
| liquidations.windows.{*}.count | number | — | Số lệnh thanh lý. |
| liquidations.windows.{*}.long_pct | number | % | Tỷ trọng của long trong tổng. |
| liquidations.windows.{*}.max_order | object | — | Lệnh thanh lý đơn lẻ lớn nhất trong khung thời gian. |
| liquidations.windows.{*}.max_order.exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| liquidations.windows.{*}.max_order.symbol | string | — | Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT). |
| liquidations.windows.{*}.max_order.side | string | — | `long` / `short` hoặc `buy` / `sell`. |
| liquidations.windows.{*}.max_order.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). |
| liquidations.windows.{*}.max_order.qty | number | — | Số lượng. |
| liquidations.windows.{*}.max_order.contract_multiplier | number | x | Số coin trên mỗi đơn vị yết giá của hợp đồng thuộc lệnh lớn nhất (1000 với các hợp đồng kiểu 1000PEPE); `price` và `qty` đã được quy đổi về từng coin. |
| liquidations.windows.{*}.max_order.value_usd | number | USD | Giá trị. |
| liquidations.windows.{*}.max_order.timestamp | number | ms | Dấu thời gian. |
| liquidations.by_exchange | object | — | Phần tách theo từng sàn cho mỗi khung thời gian. khóa động: 1h,4h,12h,24h |
| liquidations.by_exchange.{*} | array | — | Phần tách theo từng sàn. |
| liquidations.by_exchange.{*}[] | object | — | Phần tách theo từng sàn. |
| liquidations.by_exchange.{*}[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| liquidations.by_exchange.{*}[].long_usd | number | USD | Phía long. |
| liquidations.by_exchange.{*}[].short_usd | number | USD | Phía short. |
| liquidations.by_exchange.{*}[].total_usd | number | USD | Tổng. |
| liquidations.by_exchange.{*}[].count | number | — | Số mục. |
| liquidations.by_exchange.{*}[].share_pct | number | % | Tỷ trọng trong tổng. |
| liquidations.last_event_at | number | ms | Thời điểm của lần thanh lý gần nhất của coin này. |
| liquidations.last_event_age_s | number | s | Số giây kể từ sự kiện đó. |
| liquidations.sources | array | — | Trạng thái của từng feed thanh lý: được thu thập bằng cách nào và lần gần nhất có dữ liệu là khi nào. |
| liquidations.sources[] | object | — | Nguồn dữ liệu. |
| liquidations.sources[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| liquidations.sources[].via | string | — | Phương thức thu thập (`ws`, `rest`, …). |
| liquidations.sources[].status | string | — | Trạng thái feed, đánh giá từ thời gian sự kiện và heartbeat của chính nó. |
| liquidations.sources[].feed_last_event_age_s | number|null | s | Số giây kể từ sự kiện. |
| liquidations.sources[].ws_heartbeat_age_s | number|null | s | Số giây kể từ sự kiện. |
| liquidations.sources[].judged_by | string | — | Trạng thái được đánh giá từ dấu thời gian nào. |
| liquidations.sources[].coin_last_event_age_s | number|null | s | Số giây kể từ sự kiện. |
| liquidations.sources[].min_event_usd | number | USD | Quy mô lệnh nhỏ nhất mà feed công bố; các lệnh thanh lý nhỏ hơn không hiển thị trên sàn này. |
| liquidations.sources[].note | string|null | — | Ghi chú. |
| liquidations.sources[].node_heartbeat_age_s | number | s | Số giây kể từ sự kiện. có thể vắng mặt |
| liquidations.sources[].pipeline_last_event_age_s | number | s | Số giây kể từ sự kiện. có thể vắng mặt |
| liquidations.coverage | object | — | Những gì được tính và không được tính trong các con số ở trên. 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. |
| liquidations.coverage.collected_exchanges | array | — | Các sàn có feed thanh lý công khai mà CoinBoss thu thập. |
| liquidations.coverage.collected_exchanges[] | string | — | Các sàn được thu thập. |
| liquidations.coverage.unavailable | array | — | Các cặp sàn / hợp đồng không thể đưa vào, mỗi cặp kèm một lý do. Chúng không bao giờ bị tính là 0. |
| liquidations.coverage.unavailable[] | object | — | Các mục không có dữ liệu, kèm lý do. Không bao giờ được báo là 0. |
| liquidations.coverage.unavailable[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| liquidations.coverage.unavailable[].reason | string | — | Mã lý do. |
| liquidations.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. |
| liquidations.method.event | string | — | Ghi chú dạng văn bản thuần về việc một sự kiện thanh lý là gì: một lệnh thanh lý do luồng của sàn đẩy về hoặc do API REST công khai của sàn trả về. |
| liquidations.method.side | string | — | `long` / `short` hoặc `buy` / `sell`. |
| liquidations.method.value_usd | string | USD | Giá trị. |
| liquidations.method.dedupe | string | — | Ghi chú dạng văn bản thuần về khử trùng lặp: sự kiện là duy nhất theo sàn, ký hiệu, chiều, giá, giá trị và dấu thời gian, cộng thêm ID lệnh của sàn nếu có. |
| liquidations.method.null_rule | string | — | Ghi chú dạng văn bản thuần cho biết khung thời gian không có sự kiện nào được thu thập sẽ trả về null chứ không phải 0, và nơi liệt kê các sàn không có feed công khai. |
| liquidations.method.binance_note | string | — | Lưu ý dạng văn bản thuần rằng Binance đẩy tối đa một lệnh thanh lý cho mỗi ký hiệu mỗi giây, nên các tổng của Binance là cận dưới. |
| liquidations.method.min_event_usd | string | USD | Lệnh nhỏ nhất mà feed công bố. |
| volume | object | — | Cùng object mà `/api/sd/volume` trả về cho coin này. |
| volume.coin | string | — | Ký hiệu coin, viết hoa (ví dụ BTC). |
| volume.now | number | ms | Thời gian máy chủ lúc phản hồi được dựng. |
| volume.futures | object | — | Khối hoặc giá trị của thị trường hợp đồng tương lai. |
| volume.futures.total_usd | number | USD | Khối lượng hợp đồng tương lai 24h trên các sàn (giá trị danh nghĩa USD). |
| volume.futures.n_exchanges | number | — | Số sàn đóng góp dữ liệu. |
| volume.futures.by_exchange | array | — | Phần tách theo từng sàn. |
| volume.futures.by_exchange[] | object | — | Phần tách theo từng sàn. |
| volume.futures.by_exchange[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| volume.futures.by_exchange[].vol_usd | number | USD | Khối lượng tính theo giá trị danh nghĩa USD. |
| volume.futures.by_exchange[].legacy_usd | number | USD | Phần khối lượng đến từ tập ticker hợp đồng vĩnh cửu USDT. |
| volume.futures.by_exchange[].sd_usd | number | USD | Phần đến từ các hợp đồng bổ sung (USDC, ký quỹ bằng coin, giao sau có kỳ hạn) đã được tính. |
| volume.futures.by_exchange[].share_pct | number | % | Tỷ trọng trong tổng. |
| volume.futures.change_24h | object | — | Thay đổi 24h. |
| volume.futures.change_24h.pct | number | % | Phần trăm. |
| volume.futures.change_24h.cur | number | — | Giá trị hiện tại. |
| volume.futures.change_24h.prev | number | — | Giá trị trước đó (mốc so sánh). |
| volume.futures.change_24h.n_matched | number | — | Số mục có mặt ở cả hai đầu của phép so sánh. |
| volume.futures.change_24h.n_total | number | — | Số mục có mặt hiện tại. |
| volume.futures.change_24h.prev_ts | number | ms | Thời điểm của ảnh chụp mốc so sánh. |
| volume.futures.change_24h.basis | string | — | Giá hợp đồng tương lai trừ giá giao ngay, hoặc khối basis. |
| volume.futures.selfdata_contracts | object | — | Các hợp đồng bổ sung: những gì đã được tính và những gì còn đang chờ. |
| volume.futures.selfdata_contracts.included_usd | null | USD | Khối lượng 24h của các hợp đồng được thu thập bổ sung (ký quỹ bằng coin, USDC, giao sau có kỳ hạn) đã được tính vào tổng hợp đồng tương lai; null khi chưa có hợp đồng nào được tính. |
| volume.futures.selfdata_contracts.n_included | number | count | Số hợp đồng được thu thập bổ sung đã tính vào tổng hợp đồng tương lai (những hợp đồng có ảnh chụp riêng từ khoảng 24 giờ trước). |
| volume.futures.selfdata_contracts.pending_usd | number|null | USD | Tổng của các mục đang chờ, không nằm trong tổng. |
| volume.futures.selfdata_contracts.n_pending | number | count | Số hợp đồng được thu thập bổ sung chưa được tính vì thiếu mốc so sánh 24 giờ trước của riêng chúng; các hợp đồng lớn nhất được liệt kê trong `pending`. |
| volume.futures.selfdata_contracts.pending | array | — | Các mục đã thu thập nhưng chưa được tính. |
| volume.futures.selfdata_contracts.pending[] | object | — | Các mục đã thu thập nhưng chưa được tính. |
| volume.futures.selfdata_contracts.pending[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| volume.futures.selfdata_contracts.pending[].symbol | string | — | Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT). |
| volume.futures.selfdata_contracts.pending[].margin | string | — | Nhóm đồng ký quỹ. |
| volume.futures.selfdata_contracts.pending[].contract_type | string | — | `perpetual` hoặc `delivery`. |
| volume.futures.selfdata_contracts.pending[].vol_usd | number | USD | Khối lượng tính theo giá trị danh nghĩa USD. |
| volume.futures.selfdata_contracts.pending[].reason | string | — | Mã lý do. |
| volume.spot | object | — | Khối hoặc giá trị của thị trường giao ngay. |
| volume.spot.total_usd | number | USD | Khối lượng giao ngay 24h trên các sàn. |
| volume.spot.n_exchanges | number | — | Số sàn đóng góp dữ liệu. |
| volume.spot.asof | number | ms | Thời điểm của dữ liệu mới nhất được dùng. |
| volume.spot.by_exchange | array | — | Phần tách theo từng sàn. |
| volume.spot.by_exchange[] | object | — | Phần tách theo từng sàn. |
| volume.spot.by_exchange[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| volume.spot.by_exchange[].vol_usd | number | USD | Khối lượng tính theo giá trị danh nghĩa USD. |
| volume.spot.by_exchange[].quote | string | — | Các đồng yết giá được tính cho sàn này. |
| volume.spot.by_exchange[].ts | number | ms | Dấu thời gian. |
| volume.spot.by_exchange[].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). |
| volume.spot.by_exchange[].age_s | number | s | Số giây kể từ lần cập nhật gần nhất của dòng này. |
| volume.spot.by_exchange[].share_pct | number | % | Tỷ trọng trong tổng. |
| volume.spot.change_24h | object | — | Thay đổi 24h. |
| volume.spot.change_24h.pct | number | % | Phần trăm. |
| volume.spot.change_24h.cur | number | — | Giá trị hiện tại. |
| volume.spot.change_24h.prev | number | — | Giá trị trước đó (mốc so sánh). |
| volume.spot.change_24h.n_matched | number | — | Số mục có mặt ở cả hai đầu của phép so sánh. |
| volume.spot.change_24h.n_total | number | — | Số mục có mặt hiện tại. |
| volume.spot.change_24h.prev_ts | number | ms | Thời điểm của ảnh chụp mốc so sánh. |
| volume.spot.change_24h.basis | string | — | Giá hợp đồng tương lai trừ giá giao ngay, hoặc khối basis. |
| volume.ratios | object | — | Các tỷ lệ khối lượng: `futures_to_spot` (khối lượng hợp đồng tương lai 24h ÷ khối lượng giao ngay 24h) và `oi_to_futures_volume`; mỗi tỷ lệ là null khi thiếu một đầu vào. |
| volume.ratios.futures_to_spot | number | — | Khối lượng hợp đồng tương lai chia cho khối lượng giao ngay. |
| volume.ratios.oi_to_futures_volume | number | — | Vị thế mở chia cho khối lượng hợp đồng tương lai 24h. |
| volume.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. |
| volume.method.futures | string | — | Khối hoặc giá trị của thị trường hợp đồng tương lai. |
| volume.method.spot | string | — | Khối hoặc giá trị của thị trường giao ngay. |
| volume.method.change | string | — | Thay đổi trong kỳ đã nêu. |
| volume.method.oi_to_futures_volume | string | — | Định nghĩa dạng văn bản thuần của `ratios.oi_to_futures_volume`: tổng vị thế mở tính bằng USD ÷ khối lượng hợp đồng tương lai 24h tính bằng USD. |
| ls | object | — | Cùng object mà `/api/sd/ls` trả về cho coin này. |
| ls.coin | string | — | Ký hiệu coin, viết hoa (ví dụ BTC). |
| ls.now | number | ms | Thời gian máy chủ lúc phản hồi được dựng. |
| ls.account | object | — | Tỷ trọng tài khoản đang long ròng so với short ròng trên tổng số tài khoản. |
| ls.account.long_pct | number | % | Tỷ trọng long. |
| ls.account.short_pct | number | % | Tỷ trọng short. |
| ls.account.ratio | number | — | Tỷ lệ. |
| ls.account.n_exchanges | number | — | Số sàn đóng góp dữ liệu. |
| ls.account.by_exchange | array | — | Phần tách theo từng sàn. |
| ls.account.by_exchange[] | object | — | Phần tách theo từng sàn. |
| ls.account.by_exchange[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| ls.account.by_exchange[].symbol | string | — | Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT). |
| ls.account.by_exchange[].long_pct | number | % | Tỷ trọng long. |
| ls.account.by_exchange[].short_pct | number | % | Tỷ trọng short. |
| ls.account.by_exchange[].ratio | number | — | Tỷ lệ. |
| ls.account.by_exchange[].updated_at | number | ms | Thời điểm dòng này được cập nhật lần cuối. |
| ls.account.by_exchange[].age_s | number | s | Số giây kể từ lần cập nhật gần nhất của dòng này. |
| ls.account.by_exchange[].is_stale | boolean | — | true khi dòng cũ hơn khung dữ liệu mới; dòng quá hạn không được dùng trong các tổng. |
| ls.account.by_exchange[].source | string | — | Giá trị này đến từ đâu. |
| ls.account.by_exchange[].period | string | — | Kỳ. |
| ls.top_account | object | — | Tương tự, nhưng chỉ tính nhóm trader hàng đầu do sàn định nghĩa. |
| ls.top_account.long_pct | number|null | % | Tỷ trọng long. |
| ls.top_account.short_pct | number|null | % | Tỷ trọng short. |
| ls.top_account.ratio | number|null | — | Tỷ lệ. |
| ls.top_account.n_exchanges | number | — | Số sàn đóng góp dữ liệu. |
| ls.top_account.by_exchange | array | — | Phần tách theo từng sàn. |
| ls.top_account.by_exchange[] | object | — | Phần tách theo từng sàn. |
| ls.top_account.by_exchange[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| ls.top_account.by_exchange[].symbol | string | — | Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT). |
| ls.top_account.by_exchange[].long_pct | number | % | Tỷ trọng long. |
| ls.top_account.by_exchange[].short_pct | number | % | Tỷ trọng short. |
| ls.top_account.by_exchange[].ratio | number | — | Tỷ lệ. |
| ls.top_account.by_exchange[].updated_at | number | ms | Thời điểm dòng này được cập nhật lần cuối. |
| ls.top_account.by_exchange[].age_s | number | s | Số giây kể từ lần cập nhật gần nhất của dòng này. |
| ls.top_account.by_exchange[].is_stale | boolean | — | true khi dòng cũ hơn khung dữ liệu mới; dòng quá hạn không được dùng trong các tổng. |
| ls.top_account.by_exchange[].source | string | — | Giá trị này đến từ đâu. |
| ls.top_account.by_exchange[].period | string | — | Kỳ. |
| ls.top_position | object | — | Tỷ trọng long so với short trong các vị thế do trader hàng đầu nắm giữ. |
| ls.top_position.long_pct | number|null | % | Tỷ trọng long. |
| ls.top_position.short_pct | number|null | % | Tỷ trọng short. |
| ls.top_position.ratio | number|null | — | Tỷ lệ. |
| ls.top_position.n_exchanges | number | — | Số sàn đóng góp dữ liệu. |
| ls.top_position.by_exchange | array | — | Phần tách theo từng sàn. |
| ls.top_position.by_exchange[] | object | — | Phần tách theo từng sàn. |
| ls.top_position.by_exchange[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| ls.top_position.by_exchange[].symbol | string | — | Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT). |
| ls.top_position.by_exchange[].long_pct | number | % | Tỷ trọng long. |
| ls.top_position.by_exchange[].short_pct | number | % | Tỷ trọng short. |
| ls.top_position.by_exchange[].ratio | number | — | Tỷ lệ. |
| ls.top_position.by_exchange[].updated_at | number | ms | Thời điểm dòng này được cập nhật lần cuối. |
| ls.top_position.by_exchange[].age_s | number | s | Số giây kể từ lần cập nhật gần nhất của dòng này. |
| ls.top_position.by_exchange[].is_stale | boolean | — | true khi dòng cũ hơn khung dữ liệu mới; dòng quá hạn không được dùng trong các tổng. |
| ls.top_position.by_exchange[].source | string | — | Giá trị này đến từ đâu. |
| ls.top_position.by_exchange[].period | string | — | Kỳ. |
| ls.position_all | object | — | Tỷ trọng long so với short trên toàn bộ vị thế (ở các sàn có công bố). |
| ls.position_all.long_pct | number|null | % | Tỷ trọng long. |
| ls.position_all.short_pct | number|null | % | Tỷ trọng short. |
| ls.position_all.ratio | number|null | — | Tỷ lệ. |
| ls.position_all.n_exchanges | number | — | Số sàn đóng góp dữ liệu. |
| ls.position_all.by_exchange | array | — | Phần tách theo từng sàn. |
| ls.position_all.by_exchange[] | object | — | Phần tách theo từng sàn. |
| ls.position_all.by_exchange[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| ls.position_all.by_exchange[].symbol | string | — | Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT). |
| ls.position_all.by_exchange[].long_pct | number | % | Tỷ trọng long. |
| ls.position_all.by_exchange[].short_pct | number | % | Tỷ trọng short. |
| ls.position_all.by_exchange[].ratio | number | — | Tỷ lệ. |
| ls.position_all.by_exchange[].updated_at | number | ms | Thời điểm dòng này được cập nhật lần cuối. |
| ls.position_all.by_exchange[].age_s | number | s | Số giây kể từ lần cập nhật gần nhất của dòng này. |
| ls.position_all.by_exchange[].is_stale | boolean | — | true khi dòng cũ hơn khung dữ liệu mới; dòng quá hạn không được dùng trong các tổng. |
| ls.position_all.by_exchange[].source | string | — | Giá trị này đến từ đâu. |
| ls.position_all.by_exchange[].period | string | — | Kỳ. |
| ls.taker | object | — | Tỷ trọng khối lượng taker mua so với taker bán. |
| ls.taker.long_pct | number|null | % | Tỷ trọng long. |
| ls.taker.short_pct | number|null | % | Tỷ trọng short. |
| ls.taker.ratio | number|null | — | Tỷ lệ. |
| ls.taker.n_exchanges | number | — | Số sàn đóng góp dữ liệu. |
| ls.taker.by_exchange | array | — | Phần tách theo từng sàn. |
| ls.definitions | object | — | Định nghĩa của từng thước đo. Năm thước đo trả lời những câu hỏi khác nhau và không bao giờ được trộn lẫn. có thể vắng mặt |
| ls.definitions.account | string | — | Thước đo theo tài khoản. có thể vắng mặt |
| ls.definitions.top_account | string | — | Thước đo theo tài khoản của trader hàng đầu. có thể vắng mặt |
| ls.definitions.top_position | string | — | Thước đo theo vị thế của trader hàng đầu. có thể vắng mặt |
| ls.definitions.position_all | string | — | Thước đo trên toàn bộ vị thế. có thể vắng mặt |
| ls.definitions.taker | string | — | Thước đo taker mua / bán. có thể vắng mặt |
| ls.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. có thể vắng mặt |
| ls.method.normalize | string | — | Ghi chú dạng văn bản thuần về chuẩn hóa: giá trị của mỗi sàn được quy đổi lại sao cho % long + % short = 100, và tỷ lệ = % long ÷ % short. có thể vắng mặt |
| ls.method.aggregate | string | — | Số liệu tổng hợp trên các sàn. có thể vắng mặt |
| ls.method.freshness | string | — | Quy tắc độ mới dạng văn bản thuần: các dòng được cập nhật trong vòng 24 giờ được hiển thị và `is_stale` đánh dấu các dòng cũ hơn 2 giờ. có thể vắng mặt |
| errors | object | — | Các phần của gói dữ liệu không dựng được, với khóa là tên phần; rỗng khi mọi phần đều có mặt. có thể vắng mặt |
Tạo lúc 2026-11-11 23:00 UTC từ 4 phản hồi thật.
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.
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 | 73 ms | Đạt |
| coin=SOL | 200 | 59 ms | Đạt |
| coin=ARKM | 200 | 59 ms | Đạt |
| — | 400 | 2 ms | Đạt trả về lỗi như dự kiến |
Kiểm tra lúc 2026-11-13 03:57:35 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
- xem /api/sd/oi, /api/sd/funding, /api/sd/liquidations, /api/sd/volume, /api/sd/ls (polling 60 s đến 5 phút; thanh lý theo thời gian thực; giao ngay mỗi 10 phút)
- Khung thời gian
- ảnh chụp mới nhất của từng khối, cùng các khung thời gian trượt riêng của mỗi khối
- Nguồn dữ liệu
- Các khối vị thế mở, funding, thanh lý, khối lượng và long/short của một coin được gộp lại, tất cả dựng từ các trình thu thập của chính CoinBoss, vốn polling API công khai của khoảng 30 sàn (ví dụ binance, okx, bybit, bitget, gate, hyperliquid).
- Độ phủ sàn
- giống năm endpoint đơn khối; danh sách hợp đồng bị cắt còn 60 dòng
- Đơn vị
- USD notional for OI / volume / liquidations; funding as fraction; long/short in percent
- Phương pháp
- same builders as the five single-block endpoints
- 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
Khả dụngKiểm tra lúc 2026-11-13 03:57:35 UTCHTTP 200875 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 0s
Độ khả dụng, 30 ngày qua
100% trong 411 lần kiểm tra đạt
Lần thăm dò gần nhất phát hiện schema bị lệch
- Được trả về nhưng chưa có trong tài liệu: oi.coverage.stale_excluded[], oi.coverage.stale_excluded[].exchange, oi.coverage.stale_excluded[].symbol, oi.coverage.stale_excluded[].oi_usd, oi.coverage.stale_excluded[].age_s, oi.coverage.stale_excluded[].reason, ls.taker.by_exchange[], ls.taker.by_exchange[].exchange, ls.taker.by_exchange[].symbol, ls.taker.by_exchange[].long_pct
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/coinKhả dụngTham số
string — Coin symbol; 400 when missing. Alias: `base`.
URL yêu cầu
https://www.coinboss.com/api/sd/coin?coin=BTCChọ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.
Endpoint khác trong danh mục này
- Gói dữ liệu coin trong một lần gọi (OI, funding, thanh lý, khối lượng, long/short) /api/sd/coin
- Khối lượng hợp đồng tương lai của một coin /api/sd/volume
- Bộ lọc coin phái sinh /api/derivatives/coins
- Bảng coin phái sinh đầy đủ /api/derivatives/coins-full
- Nến phái sinh của một coin /api/derivatives/kline
- Danh sách RSI theo coin /api/derivatives/rsi
- Chuỗi MACD của một coin /api/indicators/ta/macd/:coin
- Chuỗi lịch sử của một coin /api/market/history
- Ticker phái sinh tổng hợp theo coin /api/market/tickers
- Xếp hạng khối lượng phái sinh /api/market/volume-rank