GETKhả dụng
Ma trận chất lượng dữ liệu (góc nhìn trình thu thập)
Lớp dữ liệu tự thu thập: ma trận chất lượng dữ liệu (sàn × nhóm dữ liệu)
GET
/api/sd/qualityYêu cầu
Endpoint này không nhận tham số nào.
Yêu cầu mẫu
curl -s "https://www.coinboss.com/api/sd/quality"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 }`. |
| now | number | ms | Thời gian máy chủ lúc phản hồi được dựng. |
| families | array | — | Các nhóm dữ liệu được kiểm tra cho mọi sàn, theo thứ tự hiển thị. |
| families[] | string | — | ID nhóm dữ liệu: `ticker`, `oi`, `funding`, `funding_settle`, `liquidation`, `ls`, `spot` hoặc `sd_contracts`. |
| exchanges | array | — | Các sàn. |
| exchanges[] | string | — | Các sàn. |
| matrix | object | — | Ma trận có khóa theo hàng và cột. khóa động: aster,backpack,binance,bingx,bitfinex,bitget |
| matrix.{*} | object | — | Ma trận có khóa theo hàng và cột. khóa động: ticker,oi,funding,funding_settle,liquidation,ls |
| matrix.{*}.ticker | object | — | Độ mới của các ticker hợp đồng tương lai của sàn: `status`, số dòng, `age_s` và các khung dữ liệu mới / dùng được. Khóa của map là ID sàn. có thể vắng mặt |
| matrix.{*}.ticker.status | string | — | Trạng thái. có thể vắng mặt |
| matrix.{*}.ticker.rows | number | — | Các dòng kết quả. có thể vắng mặt |
| matrix.{*}.ticker.rows_fresh | number | — | Các dòng được cập nhật trong khung dữ liệu mới. có thể vắng mặt |
| matrix.{*}.ticker.rows_usable | number | — | Các dòng nằm trong khung còn dùng được. có thể vắng mặt |
| matrix.{*}.ticker.rows_orphan | number | — | Các dòng có hợp đồng không còn được niêm yết. có thể vắng mặt |
| matrix.{*}.ticker.rows_invalid | number | — | Các dòng bị loại khi kiểm tra hợp lệ. có thể vắng mặt |
| matrix.{*}.ticker.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. có thể vắng mặt |
| matrix.{*}.ticker.fresh_within_s | number | s | Khung dữ liệu mới: dữ liệu mới hơn mốc này được tính là còn mới. có thể vắng mặt |
| matrix.{*}.ticker.usable_within_s | number | s | Dữ liệu cũ hơn mốc này hoàn toàn không được dùng. có thể vắng mặt |
| matrix.{*}.oi | object | — | Vị thế mở. có thể vắng mặt |
| matrix.{*}.oi.status | string | — | Trạng thái. có thể vắng mặt |
| matrix.{*}.oi.rows | number | — | Các dòng kết quả. có thể vắng mặt |
| matrix.{*}.oi.rows_fresh | number | — | Các dòng được cập nhật trong khung dữ liệu mới. có thể vắng mặt |
| matrix.{*}.oi.rows_usable | number | — | Các dòng nằm trong khung còn dùng được. có thể vắng mặt |
| matrix.{*}.oi.rows_orphan | number | — | Các dòng có hợp đồng không còn được niêm yết. có thể vắng mặt |
| matrix.{*}.oi.rows_invalid | number | — | Các dòng bị loại khi kiểm tra hợp lệ. có thể vắng mặt |
| matrix.{*}.oi.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. có thể vắng mặt |
| matrix.{*}.oi.fresh_within_s | number | s | Khung dữ liệu mới: dữ liệu mới hơn mốc này được tính là còn mới. có thể vắng mặt |
| matrix.{*}.oi.usable_within_s | number | s | Dữ liệu cũ hơn mốc này hoàn toàn không được dùng. có thể vắng mặt |
| matrix.{*}.funding | object | — | Khối hoặc giá trị tỷ lệ funding. có thể vắng mặt |
| matrix.{*}.funding.status | string | — | Trạng thái. có thể vắng mặt |
| matrix.{*}.funding.rows | number | — | Các dòng kết quả. có thể vắng mặt |
| matrix.{*}.funding.rows_fresh | number | — | Các dòng được cập nhật trong khung dữ liệu mới. có thể vắng mặt |
| matrix.{*}.funding.rows_usable | number | — | Các dòng nằm trong khung còn dùng được. có thể vắng mặt |
| matrix.{*}.funding.rows_orphan | number | — | Các dòng có hợp đồng không còn được niêm yết. có thể vắng mặt |
| matrix.{*}.funding.rows_invalid | number | — | Các dòng bị loại khi kiểm tra hợp lệ. có thể vắng mặt |
| matrix.{*}.funding.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. có thể vắng mặt |
| matrix.{*}.funding.fresh_within_s | number | s | Khung dữ liệu mới: dữ liệu mới hơn mốc này được tính là còn mới. có thể vắng mặt |
| matrix.{*}.funding.usable_within_s | number | s | Dữ liệu cũ hơn mốc này hoàn toàn không được dùng. có thể vắng mặt |
| matrix.{*}.funding.rows_unknown_interval | number | count | Các dòng funding được cập nhật trong 4 giờ qua mà chu kỳ thanh toán không xác định, nên không thể chuẩn hóa về 8 giờ; chỉ cần một dòng như vậy là ô thành `partial`. có thể vắng mặt |
| matrix.{*}.funding.rows_no_next_time | number | ms | Dấu thời gian. có thể vắng mặt |
| matrix.{*}.funding.rows_no_liveness | number | count | Các dòng funding mới được cập nhật gần đây trên những hợp đồng không có bằng chứng đang giao dịch thực (đã hủy niêm yết hoặc không có khối lượng); bị loại khỏi phép đếm độ mới. có thể vắng mặt |
| matrix.{*}.funding_settle | object | — | Độ mới của lịch sử thanh toán funding của sàn: `status`, `age_s` của kỳ thanh toán mới nhất, `symbols` và `history_from`. có thể vắng mặt |
| matrix.{*}.funding_settle.status | string | — | Trạng thái. có thể vắng mặt |
| matrix.{*}.funding_settle.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. có thể vắng mặt |
| matrix.{*}.funding_settle.symbols | number | — | Các ký hiệu. có thể vắng mặt |
| matrix.{*}.funding_settle.history_from | number | ms | Bản ghi sớm nhất đang lưu. có thể vắng mặt |
| matrix.{*}.funding_settle.fresh_within_s | number | s | Khung dữ liệu mới: dữ liệu mới hơn mốc này được tính là còn mới. có thể vắng mặt |
| matrix.{*}.liquidation | object | — | Khối thanh lý. có thể vắng mặt |
| matrix.{*}.liquidation.status | string | — | Trạng thái. có thể vắng mặt |
| matrix.{*}.liquidation.via | string | — | Đường thu thập. có thể vắng mặt |
| matrix.{*}.liquidation.last_event_age_s | number|null | s | Số giây kể từ sự kiện. có thể vắng mặt |
| matrix.{*}.liquidation.events_1h | number | count | Số lệnh thanh lý được lưu từ sàn này trong một giờ qua; kích thước lệnh tối thiểu khác nhau giữa các sàn, nên các số đếm không so sánh được với nhau. có thể vắng mặt |
| matrix.{*}.liquidation.events_24h | number | count | Số lệnh thanh lý được lưu từ sàn này trong 24 giờ qua; kích thước lệnh tối thiểu khác nhau giữa các sàn, nên các số đếm không so sánh được với nhau. có thể vắng mặt |
| matrix.{*}.liquidation.ws_heartbeat_age_s | number|null | s | Số giây kể từ sự kiện. có thể vắng mặt |
| matrix.{*}.liquidation.judged_by | string | — | Trạng thái được đánh giá từ dấu thời gian nào. có thể vắng mặt |
| matrix.{*}.liquidation.idle_ok_s | number | s | Khoảng trống dài nhất không có lệnh thanh lý mà vẫn được coi là bình thường với sàn này; khoảng trống dài hơn sẽ đánh dấu feed là `stale`. có thể vắng mặt |
| matrix.{*}.ls | object | — | Độ mới của các dòng tỷ lệ long/short của sàn: `status`, số dòng, `age_s` và các khung dữ liệu mới / dùng được. có thể vắng mặt |
| matrix.{*}.ls.status | string | — | Trạng thái. có thể vắng mặt |
| matrix.{*}.ls.reason | string | — | Mã lý do. có thể vắng mặt |
| matrix.{*}.spot | object | — | Khối hoặc giá trị của thị trường giao ngay. có thể vắng mặt |
| matrix.{*}.spot.status | string | — | Trạng thái. có thể vắng mặt |
| matrix.{*}.spot.reason | string | — | Mã lý do. có thể vắng mặt |
| matrix.{*}.sd_contracts | object | — | Độ mới của các dòng hợp đồng ký quỹ bằng coin, ký quỹ USDC và hợp đồng giao sau có kỳ hạn của sàn: `status`, số dòng và `age_s`. có thể vắng mặt |
| matrix.{*}.sd_contracts.status | string | — | Trạng thái. có thể vắng mặt |
| matrix.{*}.sd_contracts.reason | string | — | Mã lý do. có thể vắng mặt |
| matrix.{*}.funding_settle.reason | string | — | Mã lý do. có thể vắng mặt |
| matrix.{*}.liquidation.reason | string | — | Mã lý do. có thể vắng mặt |
| matrix.{*}.liquidation.note | string | — | Ghi chú. có thể vắng mặt |
| matrix.{*}.ls.rows | number | — | Các dòng kết quả. có thể vắng mặt |
| matrix.{*}.ls.rows_fresh | number | — | Các dòng được cập nhật trong khung dữ liệu mới. có thể vắng mặt |
| matrix.{*}.ls.rows_usable | number | — | Các dòng nằm trong khung còn dùng được. có thể vắng mặt |
| matrix.{*}.ls.rows_orphan | number | — | Các dòng có hợp đồng không còn được niêm yết. có thể vắng mặt |
| matrix.{*}.ls.rows_invalid | number | — | Các dòng bị loại khi kiểm tra hợp lệ. có thể vắng mặt |
| matrix.{*}.ls.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. có thể vắng mặt |
| matrix.{*}.ls.fresh_within_s | number | s | Khung dữ liệu mới: dữ liệu mới hơn mốc này được tính là còn mới. có thể vắng mặt |
| matrix.{*}.ls.usable_within_s | number | s | Dữ liệu cũ hơn mốc này hoàn toàn không được dùng. có thể vắng mặt |
| matrix.{*}.spot.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. có thể vắng mặt |
| matrix.{*}.spot.coins | number | — | Các coin. có thể vắng mặt |
| matrix.{*}.spot.fresh_within_s | number | s | Khung dữ liệu mới: dữ liệu mới hơn mốc này được tính là còn mới. có thể vắng mặt |
| matrix.{*}.spot.note | string | — | Ghi chú. có thể vắng mặt |
| matrix.{*}.sd_contracts.rows | number | — | Các dòng kết quả. có thể vắng mặt |
| matrix.{*}.sd_contracts.rows_fresh | number | — | Các dòng được cập nhật trong khung dữ liệu mới. có thể vắng mặt |
| matrix.{*}.sd_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. có thể vắng mặt |
| matrix.{*}.sd_contracts.rows_without_oi | number | count | Các dòng hợp đồng không mang giá trị vị thế mở tính bằng USD. có thể vắng mặt |
| matrix.{*}.sd_contracts.rows_oi_promoted | number | count | Các dòng hợp đồng mà vị thế mở cũng được tính vào tổng vị thế mở toàn trang. có thể vắng mặt |
| matrix.{*}.sd_contracts.fresh_within_s | number | s | Khung dữ liệu mới: dữ liệu mới hơn mốc này được tính là còn mới. có thể vắng mặt |
| matrix.{*}.{*} | object | — | Ma trận có khóa theo hàng và cột. |
| matrix.{*}.{*}.status | string | — | Trạng thái. |
| matrix.{*}.{*}.reason | string | — | Mã lý do. có thể vắng mặt |
| matrix.{*}.{*}.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. có thể vắng mặt |
| matrix.{*}.{*}.coins | number | — | Các coin. có thể vắng mặt |
| matrix.{*}.{*}.fresh_within_s | number | s | Khung dữ liệu mới: dữ liệu mới hơn mốc này được tính là còn mới. có thể vắng mặt |
| matrix.{*}.{*}.note | string | — | Ghi chú. có thể vắng mặt |
| matrix.{*}.oi.reason | string | — | Mã lý do. có thể vắng mặt |
| matrix.{*}.{*}.rows | number | — | Các dòng kết quả. có thể vắng mặt |
| matrix.{*}.{*}.rows_fresh | number | — | Các dòng được cập nhật trong khung dữ liệu mới. có thể vắng mặt |
| matrix.{*}.{*}.rows_usable | number | — | Các dòng nằm trong khung còn dùng được. có thể vắng mặt |
| matrix.{*}.{*}.rows_orphan | number | — | Các dòng có hợp đồng không còn được niêm yết. có thể vắng mặt |
| matrix.{*}.{*}.rows_invalid | number | — | Các dòng bị loại khi kiểm tra hợp lệ. có thể vắng mặt |
| matrix.{*}.{*}.usable_within_s | number | s | Dữ liệu cũ hơn mốc này hoàn toàn không được dùng. có thể vắng mặt |
| matrix.{*}.ticker.dead | boolean | — | Chỉ có khi `status` là `stale`: true khi cũng không có dòng nào nằm trong khung dùng được, nên sàn bị loại khỏi các số tổng hợp. có thể vắng mặt |
| matrix.{*}.funding.reason | string | — | Mã lý do. có thể vắng mặt |
| matrix.{*}.liquidation.pipeline_last_event_age_s | number | s | Số giây kể từ sự kiện. có thể vắng mặt |
| matrix.{*}.liquidation.node_heartbeat_age_s | number | s | Số giây kể từ sự kiện. có thể vắng mặt |
| summary | object | — | Khối tóm tắt. |
| summary.fresh | number | count | Số ô sàn × nhóm dữ liệu có trạng thái `fresh`. |
| summary.partial | number | — | true khi chỉ có một phần dữ liệu dự kiến. |
| summary.stale | number | — | Các dòng hoặc cờ dành cho dữ liệu cũ hơn khung dữ liệu mới. |
| summary.invalid | number | count | Số ô sàn × nhóm dữ liệu có trạng thái `invalid`. |
| summary.unavailable | number | — | Các mục không có dữ liệu, kèm lý do. Không bao giờ được báo là 0. |
| sources | array | — | Nguồn dữ liệu. |
| sources[] | object | — | Nguồn dữ liệu. |
| sources[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| sources[].family | string | — | Nhóm dữ liệu của tác vụ thu thập mà bản ghi sức khỏe thuộc về, ví dụ `oi`, `funding`, `ticker`. |
| sources[].endpoint | string | — | Nhãn của lệnh gọi tới nguồn đang được theo dõi: host và đường dẫn của API công khai được thăm dò định kỳ, hoặc tên của một phép kiểm tra nội bộ. |
| sources[].ok | boolean | — | false khi lần thử gần nhất thất bại, tức lỗi gần nhất mới hơn lần thành công gần nhất. |
| sources[].last_ok_age_s | number|null | s | Số giây kể từ sự kiện. |
| sources[].last_err_age_s | number|null | s | Số giây kể từ sự kiện. |
| sources[].last_status | number | — | Mã trạng thái HTTP của lệnh gọi gần nhất. |
| sources[].last_error | string|null | — | Nội dung lỗi của lần thất bại gần nhất, cắt còn 160 ký tự; null khi không có lỗi nào được ghi nhận. |
| sources[].last_ms | number | ms | Thời lượng của lệnh gọi gần nhất; null khi không được đo. |
| sources[].fail_streak | number | count | Số lệnh gọi thất bại liên tiếp tính đến hiện tại; 0 sau một lần thành công. |
| sources[].ok_count | number | count | Số lệnh gọi thành công được ghi trong nhật ký sức khỏe. |
| sources[].err_count | number | count | Số lệnh gọi thất bại được ghi trong nhật ký sức khỏe. |
| sources[].http_429 | number | count | Số lệnh gọi thất bại nhận phản hồi HTTP 429 (bị giới hạn tần suất). |
| sources[].http_403 | number | count | Số lệnh gọi thất bại nhận phản hồi HTTP 403 (bị từ chối truy cập). |
| sources[].http_5xx | number | count | Số lệnh gọi thất bại nhận phản hồi với mã trạng thái HTTP 5xx. |
| sources[].timeouts | number | count | Số lệnh gọi thất bại do hết thời gian chờ. |
| errors | object | — | Map từ ID nhóm dữ liệu sang thông báo lỗi cho những nhóm mà chính phép kiểm tra bị lỗi; rỗng khi mọi phép kiểm tra đều chạy được. |
| alerts | array | — | Các cảnh báo của lượt tuần tra chất lượng dữ liệu đang mở hoặc đã được xử lý trong 24 giờ qua, cảnh báo đang mở xếp trước (tối đa 200). |
| alerts[] | object | — | Một cảnh báo: `level`, `exchange`, `family`, `code`, `detail`, các thời điểm mở / thấy lần cuối / xử lý xong, `hits` và `open`. |
| alerts[].level | string | — | Mức. |
| alerts[].exchange | string | — | ID sàn, viết thường (ví dụ `binance`). |
| alerts[].family | string | — | Nhóm dữ liệu mà cảnh báo đề cập. |
| alerts[].code | string | — | Mã. |
| alerts[].detail | string | — | Chi tiết. |
| alerts[].opened_at | number | ms | Dấu thời gian. |
| alerts[].last_seen_at | number | ms | Dấu thời gian. |
| alerts[].resolved_at | number|null | ms | Dấu thời gian. |
| alerts[].hits | number | count | Số lượt tuần tra (5 phút một lượt) đã quan sát thấy tình trạng này kể từ khi cảnh báo được mở. |
| alerts[].open | boolean | — | Giá mở cửa của kỳ. |
| monitor | object | — | Sức khỏe của chính hệ thống giám sát: tuổi của lượt tuần tra gần nhất, tuổi của heartbeat trình thu thập và `patrol_ok`. |
| monitor.alert_job_age_s | number | s | Số giây kể từ sự kiện. |
| monitor.collector_heartbeat_age_s | number | s | Số giây kể từ sự kiện. |
| monitor.patrol_ok | boolean | — | true khi lượt tuần tra đã chạy trong vòng 15 phút qua; khi là false, danh sách `alerts` có thể đã lỗi thời. |
| legend | object | — | Định nghĩa dạng văn bản thuần của từng trạng thái ô. |
| legend.fresh | string | — | Định nghĩa của trạng thái `fresh`. |
| legend.partial | string | — | true khi chỉ có một phần dữ liệu dự kiến. |
| legend.stale | string | — | Các dòng hoặc cờ dành cho dữ liệu cũ hơn khung dữ liệu mới. |
| legend.invalid | string | — | Định nghĩa của trạng thái `invalid`. |
| legend.unavailable | string | — | Các mục không có dữ liệu, kèm lý do. Không bao giờ được báo là 0. |
Tạo lúc 2026-11-11 23:01 UTC từ 1 phản hồi thật.
Phản hồi mẫu
/api/sd/quality · Phản hồi thật, ghi lại lúc 2026-11-13 03:59:27 UTC. Mảng và map dài được rút gọn khi hiển thị: alerts có 3 phần tử; matrix có 29 phần tử; sources có 262 phần tử; exchanges có 29 phần tử.
- "success"true
- "now"1794542357043
- "families"
- "ticker"
- "oi"
- "funding"
- "funding_settle"
- "liquidation"
- "ls"
- "spot"
- "sd_contracts"
- "exchanges"
- "aster"
- "backpack"
- "binance"
- "bingx"
- "bitfinex"
- "bitget"
- "bitstamp"
- "bitunix"
- "matrix"
- "aster"
- "backpack"
- "summary"
- "fresh"123
- "partial"7
- "stale"1
- "invalid"0
- "unavailable"101
- "sources"
- "errors"
- "alerts"
- "monitor"
- "alert_job_age_s"20
- "collector_heartbeat_age_s"17
- "patrol_ok"true
- "legend"
- "fresh""data timestamps within the fresh window"
- "partial""some rows outside the fresh window or missing a required field"
- "stale""no row within the fresh window (dead=true: also outside the usable window, excluded from aggregates)"
- "invalid""more than half of usable rows fail sanity checks"
- "unavailable""no public source or not collected; shown as —, never 0"
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
- ma trận được tính theo yêu cầu (ghi nhớ trong tiến trình 20 s); tác vụ cảnh báo mỗi 5 phút
- Khung thời gian
- trạng thái mới nhất; các cảnh báo đang mở hoặc đã được xử lý trong 24 h qua
- Nguồn dữ liệu
- Ma trận độ mới của dữ liệu (sàn x nhóm dữ liệu), do CoinBoss tự tính từ dấu thời gian của các bảng do chính CoinBoss thu thập.
- Độ phủ sàn
- mọi sàn có mặt trong bất kỳ nhóm dữ liệu nào được thu thập; nguồn bị thiếu được báo là không khả dụng kèm lý do
- Phân trang
- cảnh báo giới hạn ở 200
- Đơn vị
- status per cell: fresh | partial | stale | invalid | unavailable; ages in seconds
- Phương pháp
- fresh = >= 90% of live rows inside the family's freshness window (tickers 5 min, OI 15 min / cme 36 h, funding 15 min, long/short 90 min); liquidation feeds judged by WebSocket heartbeat or time since last event; funding settlements fresh within 9 h; spot snapshots within 30 min
- 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:59:27 UTCHTTP 2006 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 20s
Độ khả dụng, 30 ngày qua
100% trong 408 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: matrix.{*}.{*}.rows_unknown_interval, matrix.{*}.{*}.rows_no_next_time, matrix.{*}.{*}.rows_no_liveness, matrix.{*}.{*}.symbols, matrix.{*}.{*}.history_from, matrix.{*}.{*}.via, matrix.{*}.{*}.last_event_age_s, matrix.{*}.{*}.events_1h, matrix.{*}.{*}.events_24h, matrix.{*}.{*}.ws_heartbeat_age_s, matrix.{*}.{*}.judged_by, matrix.{*}.{*}.idle_ok_s
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/qualityKhả dụngTham số
Không có tham số.
URL yêu cầu
https://www.coinboss.com/api/sd/qualityChọ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
- Ma trận chất lượng dữ liệu (góc nhìn trình thu thập) /api/sd/quality
- Danh mục API /api/meta/catalog
- Nhật ký thay đổi và chính sách phiên bản /api/meta/changelog
- Tài liệu endpoint /api/meta/endpoint
- Tài liệu OpenAPI /api/meta/openapi
- Ma trận chất lượng dữ liệu /api/meta/quality
- Trạng thái dịch vụ /api/meta/status
- Kiểm tra một ký hiệu coin có được nền tảng nhận biết hay không /api/coin-exists
- Bảng ánh xạ từ ký hiệu coin sang đường dẫn icon lưu cục bộ /api/coin-icons
- Tóm tắt tổng hợp của trang coin /api/content/coin
- Tóm tắt các chuyên mục toàn trang /api/content/summary
- Bảng tỷ giá tiền pháp định /api/currency/fx
- Bảng ánh xạ từ id sàn sang đường dẫn icon lưu cục bộ /api/exchange-icons
- Kiểm tra liveness /api/health
- Thống kê trang nghiên cứu /api/research/stats