Trạng thái dịch vụ

Trạng thái tổng thể, các instance API và kho lưu trữ, endpoint đang lỗi, các phân vị độ trễ, độ khả dụng 30 ngày, sức khỏe trình thu thập theo từng nhóm dữ liệu và các sự cố đang mở.

GET/api/meta/status

Yê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/meta/status"

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 (`coinboss.meta.status/1`).
now	number	ms	Thời gian máy chủ lúc phản hồi được dựng.
overall	string	—	Trạng thái tổng thể của dịch vụ: `operational`, `degraded`, `partial_outage`, `major_outage` hoặc `unknown`; xem `legend`.
api_version	string	—	Phiên bản của API công khai (`v1`).
catalog_version	string	—	Phiên bản của danh mục endpoint, là một ngày phát hành như `2026.11.11`.
components	array	—	Các thành phần dịch vụ kèm trạng thái: REST API, luồng WebSocket, cơ sở dữ liệu, cache, kho chuỗi thời gian, lượt thăm dò endpoint và thu thập dữ liệu.
components[]	object	—	Một thành phần: `id`, `title`, `status` và một object `detail` có các trường phụ thuộc vào thành phần.
components[].id	string	—	Định danh.
components[].title	string	—	Tên hiển thị của thành phần.
components[].status	string	—	Trạng thái.
components[].detail	object	—	Chi tiết.
components[].detail.instances_healthy	number	count	Số instance máy chủ API vừa trả lời phép kiểm tra sức khỏe. có thể vắng mặt
components[].detail.instances_total	number	count	Số instance máy chủ API đã được kiểm tra. có thể vắng mặt
components[].detail.health_latency_ms	number	ms	Phản hồi kiểm tra sức khỏe chậm nhất trong các instance API. có thể vắng mặt
components[].detail.last_check_at	number	ms	Dấu thời gian. có thể vắng mặt
components[].detail.first_frame_ms	number	ms	Thời gian từ lúc kết nối tới luồng WebSocket cho đến khi frame đầu tiên đến trong lượt thăm dò gần nhất; null khi chưa được thăm dò. có thể vắng mặt
components[].detail.ping_ms	number	ms	Thời gian khứ hồi của một truy vấn đơn giản tới thành phần (cơ sở dữ liệu, cache hoặc kho chuỗi thời gian), đo từ host API. có thể vắng mặt
components[].detail.note	null	—	Ghi chú. có thể vắng mặt
components[].detail.last_run_at	number	ms	Dấu thời gian. có thể vắng mặt
components[].detail.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
components[].detail.interval_s	number	s	Chu kỳ dự kiến giữa hai lượt thăm dò (300). có thể vắng mặt
components[].detail.took_ms	number	ms	Thời lượng của lượt thăm dò hoàn chỉnh gần nhất; null khi không được ghi lại. có thể vắng mặt
components[].detail.families_total	number	count	Số nhóm dữ liệu được đánh giá cho việc thu thập dữ liệu. có thể vắng mặt
components[].detail.families_degraded	number	count	Số nhóm dữ liệu có trạng thái thu thập là `degraded` hoặc `outage`. có thể vắng mặt
components[].detail.judged_by	string	—	Trạng thái được đánh giá từ dấu thời gian nào. có thể vắng mặt
endpoints	object	—	Số endpoint có tài liệu ở từng trạng thái trực tiếp, kèm danh sách các endpoint đang lỗi.
endpoints.total	number	—	Tổng.
endpoints.available	number	—	Dữ liệu có khả dụng hay không.
endpoints.partial	number	—	true khi chỉ có một phần dữ liệu dự kiến.
endpoints.degraded	number	count	Số endpoint có trạng thái trực tiếp là `degraded`.
endpoints.down	number	count	Số endpoint có trạng thái trực tiếp là `down`.
endpoints.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.
endpoints.unknown	number	count	Số endpoint có trạng thái trực tiếp là `unknown` (không có kết quả thăm dò gần đây).
endpoints.failing	array	—	Các endpoint hiện đang `down` hoặc `degraded`, mỗi endpoint kèm `id`, `path`, `status`, `reason`, mã trạng thái HTTP gần nhất, thời điểm thành công gần nhất và chuỗi thất bại.
endpoints.failing[]	object	—	Một endpoint hiện đang ngừng hoạt động hoặc suy giảm.
endpoints.failing[].id	string	—	Định danh.
endpoints.failing[].path	string	—	Đường dẫn endpoint.
endpoints.failing[].status	string	—	Trạng thái.
endpoints.failing[].reason	string	—	Mã lý do.
endpoints.failing[].http	number	—	Mã trạng thái HTTP của lượt thăm dò gần nhất; `null` khi chưa từng được thăm dò.
endpoints.failing[].last_ok_at	number	ms	Dấu thời gian.
endpoints.failing[].fail_streak	number	count	Số lượt thăm dò thất bại liên tiếp.
latency_ms	object	—	Phân phối thời gian phản hồi của lệnh gọi thăm dò thành công mới nhất của từng endpoint, đo trên host API.
latency_ms.p50	number	ms	Trung vị thời gian phản hồi trên các endpoint; null khi không có mẫu còn mới.
latency_ms.p95	number	ms	Thời gian phản hồi ở phân vị thứ 95 trên các endpoint; null khi không có mẫu còn mới.
latency_ms.max	number	—	Tối đa.
latency_ms.sample	number	count	Số endpoint được đưa vào các số liệu độ trễ.
latency_ms.measured	string	—	Ghi chú dạng văn bản thuần về nơi đo độ trễ: ở phía máy chủ, không tính thời gian truyền qua mạng.
uptime	object	—	Các lượt kiểm tra thăm dò của toàn bộ endpoint gộp lại trong khung thời gian: các tổng, phần trăm thành công và phân tách theo ngày.
uptime.window_days	number	days	Độ dài của khung thời gian uptime (30).
uptime.checks	number	count	Số lượt kiểm tra thăm dò trong khung thời gian, gộp toàn bộ endpoint.
uptime.ok	number	count	Số lượt kiểm tra thành công trong số đó.
uptime.pct	number	%	Phần trăm.
uptime.tracking_since	string	—	Ngày đầu tiên có dữ liệu thăm dò trong khung thời gian, `YYYY-MM-DD`; null khi chưa có dữ liệu.
uptime.days	array	—	Giá trị theo ngày hoặc số ngày.
uptime.days[]	object	—	Giá trị theo ngày hoặc số ngày.
uptime.days[].day	string	—	Ngày theo lịch (UTC).
uptime.days[].checks	number	count	Số yêu cầu thăm dò trong ngày đó.
uptime.days[].ok	number	count	Số yêu cầu thăm dò thành công trong ngày đó.
uptime.days[].pct	number	%	Phần trăm.
uptime.days[].schema_pct	number	%	Tỷ trọng các phản hồi được thăm dò trong ngày đó khớp với bảng trường trong tài liệu.
uptime.days[].avg_ms	number	ms	Thời gian phản hồi trung bình trong ngày đó.
collectors	object	—	Tình trạng thu thập dữ liệu sàn, đánh giá từ các dấu thời gian dữ liệu trong kho lưu trữ: số đếm theo nhóm dữ liệu, các phép kiểm tra bộ dữ liệu và sức khỏe của lượt tuần tra; null khi không đánh giá được.
collectors.families	array	—	Trạng thái thu thập theo từng nhóm dữ liệu.
collectors.families[]	object	—	Một nhóm dữ liệu: `family`, `title`, số sàn ở từng trạng thái và `status` kết quả.
collectors.families[].family	string	—	ID nhóm dữ liệu, ví dụ `ticker`, `oi`, `funding`, `liquidation`, `options`.
collectors.families[].title	string	—	Tiêu đề hiển thị của nhóm dữ liệu.
collectors.families[].exchanges_collected	number	count	Các sàn mà nhóm dữ liệu được thu thập: fresh + partial + stale + broken.
collectors.families[].fresh	number	count	Các sàn có dữ liệu mới nhất của nhóm nằm trong khung dữ liệu mới.
collectors.families[].partial	number	—	true khi chỉ có một phần dữ liệu dự kiến.
collectors.families[].stale	number	—	Các dòng hoặc cờ dành cho dữ liệu cũ hơn khung dữ liệu mới.
collectors.families[].broken	number	count	Các sàn có nguồn liên tục lỗi hoặc có phần lớn các dòng của nhóm không vượt qua kiểm tra hợp lý.
collectors.families[].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.
collectors.families[].status	string	—	Trạng thái.
collectors.datasets	array	—	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.
collectors.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).
collectors.datasets[].family	string	—	ID bộ dữ liệu, ví dụ `etf` hoặc `cme`.
collectors.datasets[].id	string	—	Định danh.
collectors.datasets[].title	string	—	Tên hiển thị của bộ dữ liệu.
collectors.datasets[].source	string	—	Giá trị này đến từ đâu.
collectors.datasets[].endpoint	string	—	Endpoint công khai cung cấp bộ dữ liệu.
collectors.datasets[].status	string	—	Trạng thái.
collectors.datasets[].lag_s	number	s	Tuổ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.
collectors.datasets[].source_at	number	ms	Dấu thời gian.
collectors.datasets[].fetched_at	number	ms	Thời điểm CoinBoss lấy dữ liệu từ nguồn.
collectors.datasets[].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.
collectors.datasets[].coverage	object	—	Những gì được tính và những gì bị thiếu.
collectors.datasets[].coverage.funds_total	number	count	Số quỹ được theo dõi. có thể vắng mặt
collectors.datasets[].coverage.funds_covered	number	count	Số quỹ có công bố dùng được. có thể vắng mặt
collectors.datasets[].coverage.funds_unavailable	number	count	Số 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
collectors.datasets[].coverage.funds_failing	number	count	Số 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
collectors.datasets[].coverage.as_of	string	—	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
collectors.datasets[].coverage.as_of_min	string	—	Ngày công bố cũ nhất trong các quỹ được bao phủ (YYYY-MM-DD). có thể vắng mặt
collectors.datasets[].reason	string\|null	—	Mã lý do.
collectors.datasets[].coverage.contracts	number	—	Các dòng theo từng hợp đồng. có thể vắng mặt
collectors.datasets[].coverage.report_date	string	—	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
collectors.datasets[].coverage.products	number	count	Số sản phẩm CME được bao phủ. có thể vắng mặt
collectors.datasets[].coverage.trade_date	string	—	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
collectors.patrol_ok	boolean	—	true khi lượt tuần tra chất lượng dữ liệu đã chạy trong vòng 15 phút qua.
collectors.patrol_age_s	number	s	Số giây kể từ sự kiện.
collectors.evaluated_at	number	ms	Dấu thời gian.
incidents	object	—	Các cảnh báo chất lượng dữ liệu đang mở hoặc đã được xử lý trong 7 ngày qua: số đếm `open` và `items` (tối đa 100).
incidents.open	number	—	Giá mở cửa của kỳ.
incidents.items	array	—	Các mục kết quả.
incidents.items[]	object	—	Các mục kết quả.
incidents.items[].level	string	—	Mức.
incidents.items[].exchange	string	—	ID sàn, viết thường (ví dụ `binance`).
incidents.items[].family	string	—	Nhóm dữ liệu mà cảnh báo đề cập.
incidents.items[].code	string	—	Mã.
incidents.items[].detail	string	—	Chi tiết.
incidents.items[].opened_at	number	ms	Dấu thời gian.
incidents.items[].last_seen_at	number	ms	Dấu thời gian.
incidents.items[].resolved_at	number\|null	ms	Dấu thời gian.
incidents.items[].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ở.
incidents.items[].open	boolean	—	Giá mở cửa của kỳ.
probe	object	—	Tình trạng của lượt thăm dò endpoint đứng sau các trạng thái trực tiếp: thời điểm chạy gần nhất, tuổi của nó, chu kỳ và việc nó có còn mới hay không.
probe.last_run_at	number	ms	Dấu thời gian.
probe.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.
probe.interval_s	number	s	Chu kỳ dự kiến giữa hai lượt thăm dò (300).
probe.fresh	boolean	—	true khi lượt thăm dò gần nhất chưa quá 20 phút; khi là false, trạng thái của các endpoint được báo là `unknown`.
probe.error	null	—	Thông báo lỗi (chỉ có khi thất bại).
probe.endpoints_checked	number	count	Số endpoint được kiểm tra trong vòng thăm dò gần nhất.
probe.ok	number	count	Số endpoint trả lời đúng trong vòng thăm dò gần nhất.
probe.failed	number	count	Số endpoint bị lỗi trong vòng thăm dò gần nhất.
probe.schema_mismatch	number	count	Số endpoint có phản hồi không khớp với bảng trường trong tài liệu.
probe.alt_samples_failed	null	count	Số yêu cầu mẫu bổ sung bị lỗi; `null` khi vòng gần nhất không chạy chúng.
legend	object	—	Định nghĩa dạng văn bản thuần của từng giá trị của `overall`.
legend.operational	string	—	Định nghĩa của `operational`.
legend.degraded	string	—	Định nghĩa của `degraded`.
legend.partial_outage	string	—	Định nghĩa của `partial_outage`.
legend.major_outage	string	—	Định nghĩa của `major_outage`.
legend.unknown	string	—	Định nghĩa của `unknown`.
meta	object	—	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.schema	string	—	ID schema của phản hồi này; cùng giá trị với `schema` ở cấp cao nhất.
meta.source	array	—	Giá trị này đến từ đâu.
meta.source[]	object	—	Giá trị này đến từ đâu.
meta.source[].system	string	—	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[].component	string	—	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_at	null	—	Dấu thời gian.
meta.received_at	number	ms	Dấu thời gian.
meta.fetched_at	number	ms	Thời điểm CoinBoss lấy dữ liệu từ nguồn.
meta.window	string	—	Khung thời gian.
meta.cache_ttl_s	number	s	Thời gian sống của cache phía máy chủ cho phản hồi này.
meta.quality	string	—	`FRESH` khi lượt thăm dò endpoint đã báo cáo trong vòng 20 phút qua, còn lại là `STALE`.
meta.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.
meta.fallback	string	—	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ừ 1 phản hồi thật.

Phản hồi mẫu

/api/meta/status · Phản hồi thật, ghi lại lúc 2026-11-13 03:53:47 UTC. Mảng và map dài được rút gọn khi hiển thị: components có 7 phần tử; uptime.days có 3 phần tử; incidents.items có 11 phần tử; endpoints.failing có 25 phần tử; collectors.datasets có 12 phần tử; collectors.families có 12 phần tử.

{
- "success": true,
- "schema": "coinboss.meta.status/1",
- "now": 1794542027137,
- "overall": "partial_outage",
- "api_version": "v1",
- "catalog_version": "2026.11.12",
- "components": [
  - { … 4 },
  - { … 4 }
  ],
- "endpoints": {
  - "total": 299,
  - "available": 256,
  - "partial": 17,
  - "degraded": 17,
  - "down": 8,
  - "unavailable": 1,
  - "unknown": 0,
  - "failing": [ … 2 ]
  },
- "latency_ms": {
  - "p50": 7,
  - "p95": 839,
  - "max": 10047,
  - "sample": 289,
  - "measured": "server-side, from the probe on the API host (excludes network transit)"
  },
- "uptime": {
  - "window_days": 30,
  - "checks": 119504,
  - "ok": 118277,
  - "pct": 98.97,
  - "tracking_since": "2026-11-11",
  - "days": [ … 2 ]
  },
- "collectors": {
  - "families": [ … 2 ],
  - "datasets": [ … 2 ],
  - "patrol_ok": true,
  - "patrol_age_s": 282,
  - "evaluated_at": 1794542027976
  },
- "incidents": {
  - "open": 2,
  - "items": [ … 2 ]
  },
- "probe": {
  - "last_run_at": 1794541726312,
  - "age_s": 301,
  - "interval_s": 300,
  - "fresh": true,
  - "error": null,
  - "endpoints_checked": 290,
  - "ok": 289,
  - "failed": 1,
  - "schema_mismatch": 0,
  - "alt_samples_failed": null
  },
- "legend": {
  - "operational": "all checks pass",
  - "degraded": "serving, with stale data, schema drift or reduced redundancy",
  - "partial_outage": "at least one endpoint or API instance is failing",
  - "major_outage": "database down, no API instance healthy, or 20%+ of endpoints failing",
  - "unknown": "the probe has not reported within 20 minutes — status cannot be asserted"
  },
- "meta": {
  - "schema": "coinboss.meta.status/1",
  - "source": [ … 1 ],
  - "observed_at": null,
  - "received_at": 1794541726312,
  - "fetched_at": 1794542027137,
  - "window": "latest",
  - "cache_ttl_s": 15,
  - "quality": "FRESH",
  - "is_stale": false,
  - "fallback": "status is \"unknown\" whenever the probe is stale; process liveness is never used as evidence"
  }
}

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: Được đánh giá theo yêu cầu; kết quả endpoint lấy từ trình thăm dò API chạy mỗi 5 phút, tình trạng trình thu thập lấy từ dấu thời gian dữ liệu.
Nguồn dữ liệu: Kết quả của trình thăm dò API, kiểm tra tình trạng theo từng instance, ma trận chất lượng dữ liệu, log cảnh báo.
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:53:47 UTCHTTP 200872 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 5m

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

99.75% trong 407 lần kiểm tra đạt

Lỗi

Lệnh gọi thất bại có chung một cấu trúc trên mọi endpoint. Danh sách đầy đủ nằm ở trang lỗi. Lỗi và giới hạn tần suất →

Mã	HTTP	Ý nghĩa	Cách xử lý
INVALID_PARAM	400	Thiếu một tham số bắt buộc hoặc một giá trị không được chấp nhận. `param` nêu tên tham số khi xác định được.	Đừng thử lại với yêu cầu y nguyên; hãy sửa yêu cầu.
UNAUTHORIZED	401	Header `CB-API-KEY` đã được gửi nhưng khóa không tồn tại hoặc đã bị thu hồi. Dữ liệu công khai không cần khóa — hãy bỏ header hoặc dùng một khóa hợp lệ.	Đừng thử lại với yêu cầu y nguyên.
FORBIDDEN	403	Route này không thuộc API công khai (nội bộ hoặc chỉ dành cho tài khoản).	Đừng thử lại.
NOT_FOUND	404	Route không xác định, hoặc coin / sàn / quỹ được yêu cầu không tồn tại.	Đừng thử lại; hãy đối chiếu đường dẫn và các mã định danh với danh mục.
RATE_LIMITED	429	Số yêu cầu vượt quá giới hạn mỗi phút. `Retry-After` cho biết số giây cần chờ.	Chờ theo `Retry-After`, rồi thử lại có backoff.
INTERNAL	500	Lỗi máy chủ không mong đợi. Thông báo được cố ý viết chung chung; hãy trích dẫn `request_id` khi báo lỗi.	Thử lại một lần sau vài giây; nếu lỗi vẫn tiếp diễn, hãy báo cáo kèm ID yêu cầu.
UPSTREAM_FAILED	503	Nguồn dữ liệu đứng sau endpoint này không trả lời kịp thời. Không có số liệu quá hạn hay số liệu thay thế nào được trả về thay cho nó.	Thử lại có backoff; xem trang trạng thái.
UNAVAILABLE	501 / 503	Bộ dữ liệu tạm thời chưa sẵn sàng (cache đang được làm nóng) hoặc endpoint chưa có nguồn công khai hợp pháp.	Thử lại sau; danh mục có đánh dấu những endpoint không khả dụng theo thiết kế.
REQUEST_FAILED	200	Một số endpoint cũ hơn trả về HTTP 200 với `success: false`. Hãy luôn kiểm tra `success`, không chỉ trạng thái HTTP.	Tùy vào thông báo; hãy coi là một yêu cầu thất bại.

Dùng thử

GET/api/meta/statusKhả dụng

Tham số

Không có tham số.

URL yêu cầuhttps://www.coinboss.com/api/meta/status

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.

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