Trạng thái API Bitcoin Intelligence
Trang kiểm tra theo thời gian thực độ sẵn sàng, tuổi dữ liệu và số mẫu của các đầu vào chính: giá BTC hiện tại, lịch sử, điểm chu kỳ và mô hình power law. Bạn xem trang này trước khi gọi API hoặc trích dẫn dữ liệu; nó không để lộ bất kỳ thông tin xác thực nội bộ nào.
Giao diện tương tác của phòng nghiên cứu này hiện bằng tiếng Anh; phần hướng dẫn bên dưới mô tả đầy đủ dữ liệu đầu vào, phương pháp và giới hạn.
Dữ liệu đầu vào
- Không cần nhập; nút “Check again” để kiểm tra lại
- Dữ liệu từ /api/bitcoin-intelligence-status
Kết quả hiển thị
- Trạng thái chung: operational, degraded hoặc unavailable, kèm thời điểm kiểm tra, thời gian phản hồi (ms) và phiên bản dữ liệu
- Thẻ cho 4 thành phần: ticker, weekly-history, cycle-score, power-law-model
- Mỗi thẻ có trạng thái, mô tả và tuổi dữ liệu so với ngưỡng (giờ), hoặc “No timestamp”
- Link JSON trạng thái và tài liệu API
Cách sử dụng
- Mở trang và đọc trạng thái chung ở đầu trang.
- Xem từng thành phần để biết thành phần nào cũ hoặc không sẵn sàng.
- So tuổi dữ liệu với ngưỡng của thành phần đó.
- Bấm “Check again” sau ít phút nếu trạng thái là degraded.
- Ghi lại phiên bản dữ liệu khi trích dẫn số liệu.
Công thức
Ngưỡng độ mới: ticker 1 giờ, lịch sử 240 giờ, điểm chu kỳ 72 giờ, mô hình power law 240 giờ. Thành phần = unavailable nếu kiểm tra thất bại (lịch sử cần ít nhất 60 quan sát tháng hợp lệ; mô hình cần ít nhất 100 mẫu tuần), stale nếu tuổi > ngưỡng, ngược lại operational. Trạng thái chung = unavailable nếu ≥ 2 thành phần unavailable (HTTP 503); degraded nếu có 1 thành phần unavailable hoặc bất kỳ thành phần stale; còn lại operational.
Ví dụ tính
Ticker 0,4 h / 1 h, lịch sử 100 h / 240 h và mô hình power law 100 h / 240 h đều đạt, nhưng điểm chu kỳ có tuổi 80 h trong khi ngưỡng là 72 h. Vì 80 > 72, cycle-score là stale và trạng thái chung là degraded, không phải unavailable.
Cách đọc kết quả
- operational nghĩa là mọi thành phần sẵn sàng và nằm trong ngưỡng độ mới.
- degraded thường do một nguồn trễ; dữ liệu vẫn dùng được nhưng nên ghi chú thời điểm.
- unavailable (HTTP 503) nghĩa là ít nhất 2 thành phần không sẵn sàng; nên chờ trước khi gọi API hàng loạt.
Lưu ý và giới hạn
- Đây là kiểm tra tại thời điểm yêu cầu, không phải SLA.
- Phản hồi được cache (tối đa 5 phút ở edge), nên trạng thái có thể trễ một chút so với thực tế.
- Trễ ngắn từ nguồn thượng nguồn hoặc lỗi mạng có thể làm trạng thái tạm thời degraded.
Câu hỏi thường gặp
Trang có để lộ khóa hay địa chỉ nội bộ không?
Không. Phản hồi chỉ chứa trạng thái, tuổi dữ liệu và số mẫu; không có bí mật, địa chỉ nội bộ, dữ liệu người đăng ký hay thông tin xác thực của nhà cung cấp.
“No timestamp” nghĩa là gì?
Thành phần không có mốc thời gian nguồn để tính tuổi; nếu kiểm tra sẵn sàng đạt, nó vẫn được tính là operational.
Có kiểm tra trạng thái bằng API được không?
Có. GET /api/bitcoin-intelligence-status trả JSON với HTTP 200 khi operational hoặc degraded và HTTP 503 khi unavailable.