Khối lượng 24h—Vị thế mở—Thanh lý 24h$1.36BLong/Short 24h—Thống trị BTC—Thống trị ETH—
Ứng dụng
Ngôn ngữ ▾
₫ VND ▾
/api/meta/quality
GETKhả dụngFRESH

Ma trận chất lượng dữ liệu

Ma trận sàn × nhóm dữ liệu với FRESH / PARTIAL / STALE / BROKEN / UNAVAILABLE, dấu thời gian của nguồn và của lần lấy, độ trễ dữ liệu, độ phủ và lý do của từng khoảng trống.

GET/api/meta/quality

Yêu cầu

Tham số truy vấn

TênKiểuBắt buộcMặc địnhGiá trị hợp lệMô tả
exchangestringTùy chọn——Chỉ trả về sàn này (id viết thường, ví dụ `binance`).
familystringTùy chọn——Chỉ trả về nhóm dữ liệu này (ví dụ `oi`, `funding`, `liquidation`).

Yêu cầu mẫu

curl -s "https://www.coinboss.com/api/meta/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ườngKiểuĐơn vịMô tả
successboolean—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 }`.
schemastring—ID schema của phản hồi này (`coinboss.meta.quality/1`).
nownumbermsThời gian máy chủ lúc phản hồi được dựng.
familiesarray—Các nhóm dữ liệu được đánh giá theo từng sàn (ticker, vị thế mở, funding, thanh lý, sổ lệnh, quyền chọn và các nhóm khác).
families[]object—Một nhóm dữ liệu: `id`, `scope`, `title`, `what`, `table`, `cadence` và `fresh_within_s`.
families[].idstring—Định danh.
families[].scopestring—`exchange` với các nhóm dữ liệu được đánh giá theo từng sàn trong `matrix`.
families[].titlestring—Tiêu đề hiển thị của nhóm dữ liệu.
families[].whatstring—Mô tả ngắn về dữ liệu mà nhóm bao quát.
families[].tablestring—Tên của bộ dữ liệu nội bộ dùng để đánh giá nhóm; chỉ mang tính tham khảo.
families[].cadencestring—Lịch thu thập của nhóm dữ liệu, dạng văn bản thuần; null khi không được nêu.
families[].fresh_within_snumbersKhung dữ liệu mới: dữ liệu mới hơn mốc này được tính là còn mới.
exchangesarray—Các sàn.
exchanges[]string—Các sàn.
matrixobject—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.{*}.{*}object—Ma trận có khóa theo hàng và cột.
matrix.{*}.{*}.statusstring—Trạng thái.
matrix.{*}.{*}.lag_snumber|nullsHiện tại trừ đi dấu thời gian dữ liệu mới nhất được lưu của sàn đó (khóa thứ nhất) và nhóm dữ liệu đó (khóa thứ hai); null khi nhóm không khả dụng ở sàn đó.
matrix.{*}.{*}.source_atnumber|nullmsDấu thời gian.
matrix.{*}.{*}.fetched_atnumber|nullmsThời điểm CoinBoss lấy dữ liệu từ nguồn.
matrix.{*}.{*}.fresh_within_snumber|nullsKhung dữ liệu mới: dữ liệu mới hơn mốc này được tính là còn mới.
matrix.{*}.{*}.coverageobject|null—Những gì được tính và những gì bị thiếu.
matrix.{*}.{*}.coverage.rowsnumber—Các dòng kết quả. có thể vắng mặt
matrix.{*}.{*}.coverage.rows_freshnumber—Các dòng được cập nhật trong khung dữ liệu mới. có thể vắng mặt
matrix.{*}.{*}.coverage.rows_usablenumber—Các dòng nằm trong khung còn dùng được. có thể vắng mặt
matrix.{*}.{*}.coverage.rows_orphannumber—Các dòng có hợp đồng không còn được niêm yết. có thể vắng mặt
matrix.{*}.{*}.coverage.rows_invalidnumber—Các dòng bị loại khi kiểm tra hợp lệ. có thể vắng mặt
matrix.{*}.{*}.reasonstring|null—Mã lý do.
matrix.{*}.{*}.coverage.rows_no_livenessnumbercountCác dòng funding 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.{*}.{*}.coverage.rows_unknown_intervalnumbercountCác dòng funding được cập nhật gần đây mà chu kỳ thanh toán không xác định, nên không thể chuẩn hóa về 8 giờ. có thể vắng mặt
matrix.{*}.{*}.coverage.symbolsnumber—Các ký hiệu. có thể vắng mặt
matrix.{*}.{*}.coverage.events_1hnumbercountSố lệnh thanh lý được lưu từ sàn trong một giờ qua; kích thước lệnh tối thiểu khác nhau giữa các sàn. có thể vắng mặt
matrix.{*}.{*}.coverage.events_24hnumbercountSố lệnh thanh lý được lưu từ sàn trong 24 giờ qua; kích thước lệnh tối thiểu khác nhau giữa các sàn. có thể vắng mặt
matrix.{*}.{*}.viastring—Đường thu thập. có thể vắng mặt
matrix.{*}.{*}.coverage.booksnumbercountSố sổ lệnh được theo dõi. có thể vắng mặt
matrix.{*}.{*}.coverage.books_freshnumbercountSố sổ lệnh được cập nhật trong khung dữ liệu mới. có thể vắng mặt
matrix.{*}.{*}.coverage.books_reaching_2pctnumbercountSố sổ lệnh đủ sâu để bao phủ ±2 % quanh giá giữa. có thể vắng mặt
matrix.{*}.{*}.coverage.contractsnumber—Các dòng theo từng hợp đồng. có thể vắng mặt
matrix.{*}.{*}.coverage.contracts_freshnumbercountSố hợp đồng được cập nhật trong khung dữ liệu mới. có thể vắng mặt
matrix.{*}.{*}.coverage.with_mark_and_indexnumbercountSố hợp đồng có cả giá đánh dấu lẫn giá chỉ số. có thể vắng mặt
matrix.{*}.{*}.coverage.delivery_contractsnumbercountSố hợp đồng giao sau có kỳ hạn. có thể vắng mặt
matrix.{*}.{*}.notestring—Ghi chú. có thể vắng mặt
matrix.{*}.{*}.coverage.coinsnumber—Các coin. có thể vắng mặt
matrix.{*}.{*}.coverage.rows_without_oinumbercountCác dòng hợp đồng ký quỹ bằng coin, ký quỹ USDC hoặc hợp đồng giao sau có kỳ hạn không mang giá trị vị thế mở tính bằng USD. có thể vắng mặt
matrix.{*}.{*}.coverage.with_mark_ivnumbercountSố hợp đồng quyền chọn có biến động ngụ ý theo giá đánh dấu. có thể vắng mặt
matrix.{*}.{*}.coverage.with_greeksnumbercountSố hợp đồng quyền chọn có các chỉ số Greeks. có thể vắng mặt
datasetsarray—Các phép kiểm tra chất lượng của những bộ dữ liệu không theo từng sàn (ví dụ dữ liệu ngày của ETF giao ngay và CME), mỗi phép kèm trạng thái, độ trễ, độ phủ và lý do.
datasets[]object—Một bộ dữ liệu toàn thị trường không gắn với một sàn riêng lẻ (quyền chọn, ETF giao ngay, CME, sổ lệnh, basis).
datasets[].familystring—ID bộ dữ liệu, ví dụ `etf` hoặc `cme`.
datasets[].idstring—Định danh.
datasets[].titlestring—Tên hiển thị của bộ dữ liệu.
datasets[].sourcestring—Giá trị này đến từ đâu.
datasets[].endpointstring—Endpoint công khai cung cấp bộ dữ liệu.
datasets[].statusstring—Trạng thái.
datasets[].lag_snumbersTuổi của điểm dữ liệu mới nhất tại thời điểm phản hồi được dựng.
datasets[].source_atnumbermsDấu thời gian.
datasets[].fetched_atnumbermsThời điểm CoinBoss lấy dữ liệu từ nguồn.
datasets[].fresh_within_snumbersKhung dữ liệu mới: dữ liệu mới hơn mốc này được tính là còn mới.
datasets[].coverageobject—Những gì được tính và những gì bị thiếu.
datasets[].coverage.funds_totalnumbercountSố quỹ được theo dõi. có thể vắng mặt
datasets[].coverage.funds_coverednumbercountSố quỹ có công bố dùng được. có thể vắng mặt
datasets[].coverage.funds_unavailablenumbercountSố quỹ mà tổ chức phát hành không công bố thông tin ở dạng máy đọc được. có thể vắng mặt
datasets[].coverage.funds_failingnumbercountSố quỹ mà công bố không đọc được trong vòng thu thập gần nhất. có thể vắng mặt
datasets[].coverage.as_ofstring—Ngày công bố mới nhất trong các quỹ được bao phủ (YYYY-MM-DD). có thể vắng mặt
datasets[].coverage.as_of_minstring—Ngày công bố cũ nhất trong các quỹ được bao phủ (YYYY-MM-DD). có thể vắng mặt
datasets[].reasonstring|null—Mã lý do.
datasets[].coverage.contractsnumber—Các dòng theo từng hợp đồng. có thể vắng mặt
datasets[].coverage.report_datestring—Ngày của báo cáo Commitments of Traders mới nhất của CFTC (YYYY-MM-DD). có thể vắng mặt
datasets[].coverage.productsnumbercountSố sản phẩm CME được bao phủ. có thể vắng mặt
datasets[].coverage.trade_datestring—Ngày giao dịch của báo cáo ngày mới nhất của CME (YYYY-MM-DD). có thể vắng mặt
summaryobject—Khối tóm tắt. khóa động: FRESH,PARTIAL,STALE,BROKEN,UNAVAILABLE
summary.{*}number—Khối tóm tắt.
by_familyobject—Số sàn ở từng trạng thái, theo từng nhóm dữ liệu. Khóa ngoài là ID nhóm dữ liệu. khóa động: ticker,oi,funding,funding_settle,liquidation,ls
by_family.{*}object—Số đếm trạng thái của một nhóm dữ liệu, có khóa là trạng thái (`FRESH`, `PARTIAL`, `STALE`, `BROKEN`, `UNAVAILABLE`). khóa động: FRESH,PARTIAL,STALE,BROKEN,UNAVAILABLE
by_family.{*}.{*}numbercountSố sàn có trạng thái đó ở nhóm dữ liệu đó.
alertsarray—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 7 ngày qua, cảnh báo đang mở xếp trước; được lọc theo các tham số yêu cầu.
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[].levelstring—Mức.
alerts[].exchangestring—ID sàn, viết thường (ví dụ `binance`).
alerts[].familystring—Nhóm dữ liệu mà cảnh báo đề cập.
alerts[].codestring—Mã.
alerts[].detailstring—Chi tiết.
alerts[].opened_atnumbermsDấu thời gian.
alerts[].last_seen_atnumbermsDấu thời gian.
alerts[].resolved_atnumber|nullmsDấu thời gian.
alerts[].hitsnumbercountSố 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[].openboolean—Giá mở cửa của kỳ.
monitorobject—Sức khỏe của chính hệ thống giám sát: thời điểm và tuổi của lượt tuần tra gần nhất, `patrol_ok` và tuổi của heartbeat trình thu thập.
monitor.patrol_last_run_atnumbermsDấu thời gian.
monitor.patrol_age_snumbersSố giây kể từ sự kiện.
monitor.patrol_okboolean—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 trong khi ma trận vẫn là dữ liệu trực tiếp.
monitor.collector_heartbeat_age_snumbersSố giây kể từ sự kiện.
errorsnull—Map từ ID nhóm dữ liệu sang mã lỗi cho những nhóm mà chính phép kiểm tra chất lượng bị lỗi; null khi mọi phép kiểm tra đều chạy được.
legendobject—Định nghĩa dạng văn bản thuần của từng trạng thái ô. khóa động: FRESH,PARTIAL,STALE,BROKEN,UNAVAILABLE
legend.{*}string—Định nghĩa của trạng thái nêu ở khóa (`FRESH`, `PARTIAL`, `STALE`, `BROKEN`, `UNAVAILABLE`).
methodobject—Ghi chú về công thức / phương pháp.
method.statusstring—Trạng thái.
method.lag_sstring—Phát biểu dạng văn bản thuần về cách tính `lag_s`.
method.source_atstring—Chuỗi ngày giờ.
method.fetched_atstring—Chuỗi ngày giờ.
metaobject—Phong bì của phản hồi này: ID schema, hệ thống tạo ra, các dấu thời gian, thời gian sống của cache và độ mới.
meta.schemastring—ID schema của phản hồi này; cùng giá trị với `schema` ở cấp cao nhất.
meta.sourcearray—Giá trị này đến từ đâu.
meta.source[]object—Giá trị này đến từ đâu.
meta.source[].systemstring—Hệ thống tạo ra dữ liệu; luôn là `coinboss` với các endpoint của trung tâm nhà phát triển.
meta.source[].componentstring—Thành phần đứng sau dữ liệu: lượt thăm dò endpoint và lượt tuần tra chất lượng dữ liệu.
meta.observed_atnull—Dấu thời gian.
meta.received_atnumbermsDấu thời gian.
meta.fetched_atnumbermsThời điểm CoinBoss lấy dữ liệu từ nguồn.
meta.windowstring—Khung thời gian.
meta.cache_ttl_snumbersThời gian sống của cache phía máy chủ cho phản hồi này.
meta.qualitystring—Bình thường là `FRESH`; `PARTIAL` khi lượt tuần tra chất lượng chưa chạy trong vòng 15 phút (chỉ danh sách cảnh báo bị ảnh hưởng).
meta.is_staleboolean—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.
meta.fallbackstring—Ghi chú dạng văn bản thuần về những gì endpoint này trả về khi dữ liệu đầu vào của nó quá hạn hoặc bị thiếu.

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

Phản hồi mẫu

/api/meta/quality · Phản hồi thật, ghi lại lúc 2026-11-13 03:59:28 UTC. Mảng và map dài được rút gọn khi hiển thị: alerts có 11 phần tử; legend có 5 phần tử; matrix có 30 phần tử; summary có 5 phần tử; datasets có 12 phần tử; families có 12 phần tử.

  • {
    • "success": true,
    • "schema": "coinboss.meta.quality/1",
    • "now": 1794542368785,
    • "families": [
      • { … 7 },
      • { … 7 }
      ],
    • "exchanges": [
      • "aster",
      • "backpack",
      • "binance",
      • "bingx",
      • "bitfinex",
      • "bitget",
      • "bitstamp",
      • "bitunix"
      ],
    • "matrix": {
      • "aster": { … 2 },
      • "backpack": { … 2 }
      },
    • "datasets": [
      • { … 12 },
      • { … 12 }
      ],
    • "summary": {
      • "FRESH": 161,
      • "PARTIAL": 7
      },
    • "by_family": {
      • "ticker": { … 2 },
      • "oi": { … 2 }
      },
    • "alerts": [
      • { … 10 },
      • { … 10 }
      ],
    • "monitor": {
      • "patrol_last_run_at": 1794542347666,
      • "patrol_age_s": 22,
      • "patrol_ok": true,
      • "collector_heartbeat_age_s": 18
      },
    • "errors": null,
    • "legend": {
      • "FRESH": "newest stored data point is inside the fresh window for this family",
      • "PARTIAL": "some contracts / rows are outside the fresh window or miss a required field"
      },
    • "method": {
      • "status": "judged from data timestamps in CoinBoss storage every request (30 s in-process cache); a running collector process is not treated as evidence",
      • "lag_s": "now − newest stored data timestamp for the exchange / family",
      • "source_at": "newest stored data timestamp (exchange timestamp when the exchange provides one, otherwise collector receive time)",
      • "fetched_at": "last successful upstream call recorded by the collector health log; null for WebSocket feeds and collectors that do not log per-call health"
      },
    • "meta": {
      • "schema": "coinboss.meta.quality/1",
      • "source": [ … 1 ],
      • "observed_at": null,
      • "received_at": 1794542369610,
      • "fetched_at": 1794542368785,
      • "window": "latest",
      • "cache_ttl_s": 20,
      • "quality": "FRESH",
      • "is_stale": false,
      • "fallback": "matrix is always computed from storage; when the 5-minute patrol itself stops (monitor.patrol_ok=false) only the alerts list may be outdated"
      }
    }

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ả
exchange=binance2001 msĐạt FRESH
family=funding2001 msĐạt FRESH

Kiểm tra lúc 2026-11-13 03:59:28 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
Được đánh giá theo yêu cầu từ dấu thời gian dữ liệu mới nhất của mọi cặp sàn × nhóm dữ liệu.
Nguồn dữ liệu
Các bảng thô của CoinBoss (dấu thời gian của dòng mới nhất), log tình trạng trình thu thập. Một tiến trình đang chạy không bao giờ được tính là dữ liệu khỏe mạnh.
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:28 UTCHTTP 200856 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 408 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ĩaCách xử lý
INVALID_PARAM400Thiế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.
UNAUTHORIZED401Header `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.
FORBIDDEN403Route 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_FOUND404Route 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_LIMITED429Số 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.
INTERNAL500Lỗ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_FAILED503Nguồ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.
UNAVAILABLE501 / 503Bộ 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_FAILED200Mộ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/meta/qualityKhả dụng
Tham số

string — Return only this exchange (lower-case id, for example `binance`).

string — Return only this data family (for example `oi`, `funding`, `liquidation`).

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