Tài liệu API Bitcoin Intelligence

Cập nhật: 2026-10-07 · CryptoRebateHub Editorial Team

Trang tài liệu cho các endpoint công khai, chỉ đọc, không cần API key của Bitcoin Intelligence: chỉ số hiện tại, lịch sử theo tháng không dùng dữ liệu tương lai, bất thường, trạng thái, trích dẫn và snapshot nghiên cứu. Trang nêu rõ tham số, thời gian cache ở edge, giới hạn sử dụng hợp lý, mã trạng thái và yêu cầu ghi nguồn.

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.

Mở phòng nghiên cứu tương tác →

Dữ liệu đầu vào

/api/bitcoin-intelligence-history: years=1–20 (mặc định 10), limit=12–240 (mặc định 180)
/api/bitcoin-intelligence-anomalies: lookback=12–60 (mặc định 36), limit=1–60 (mặc định 24)
/api/bitcoin-research-snapshots: id=bir_… (bắt buộc)
Các endpoint hiện tại, trạng thái, trích dẫn và OpenAPI không có tham số

Kết quả hiển thị

Thẻ cho 7 endpoint: đường dẫn, dữ liệu trả về, tham số, thời gian cache edge (15 phút, 6 giờ, 5 phút, bất biến hoặc 24 giờ) và xác thực (không cần)
Ví dụ cURL có nút sao chép
Mã trạng thái: 200 thành công, 429 vượt giới hạn, 502/503 nguồn thượng nguồn hoặc lịch sử tạm không sẵn sàng
Quy tắc ghi nguồn và quản lý phiên bản (schemaVersion), cùng tài liệu máy đọc OpenAPI 3.1 tại /api/bitcoin-intelligence-openapi

Cách sử dụng

Chọn endpoint phù hợp: số liệu hiện tại, lịch sử theo tháng, bất thường, trạng thái hoặc trích dẫn.
Bấm “Open response” để xem JSON mẫu, hoặc sao chép lệnh cURL.
Cache phản hồi phía bạn khi dùng số lượng lớn và tuân thủ 429 cùng Retry-After.
Đọc schemaVersion trong phản hồi để xử lý thay đổi trường trong tương lai.
Ghi nguồn CryptoRebateHub và link tới terminal hoặc trang phương pháp khi đăng lại dữ liệu.

Ví dụ tính

Lệnh curl -s "https://cryptorebatehub.com/api/bitcoin-intelligence-history?years=5&limit=60" trả về tối đa 60 quan sát theo tháng. Giới hạn hợp lý là 120 yêu cầu hàm mỗi IP mỗi phút, tức trung bình 120 ÷ 60 = 2 yêu cầu mỗi giây; lượt trúng cache edge thường không tính vào hạn mức này.

Cách đọc kết quả

Thời gian cache cho biết dữ liệu có thể cũ tối đa bao lâu: trạng thái 5 phút, số liệu hiện tại 15 phút, lịch sử, bất thường và trích dẫn 6 giờ.
Mọi phản hồi phiên bản hóa kèm dataVersion và methodologyVersion để bạn ghi lại đúng dữ liệu đã dùng.
Trường mới được thêm theo cách tương thích ngược; thay đổi phá vỡ sẽ tăng schemaVersion và kèm ghi chú chuyển đổi.

Lưu ý và giới hạn

API miễn phí không có SLA về độ sẵn sàng; khi nguồn thượng nguồn lỗi có thể trả 502 hoặc 503.
Không trình bày các trường ước tính như dữ kiện on-chain gốc.
Tạo snapshot (POST) chỉ chấp nhận yêu cầu cùng nguồn gốc (same-origin) từ trình duyệt; bản ghi công khai vĩnh viễn và các trường nhạy cảm bị từ chối.

Câu hỏi thường gặp

Có cần đăng ký hay API key không?

Không. Mọi endpoint đọc đều công khai và không cần xác thực.

Giới hạn tốc độ là bao nhiêu?

120 yêu cầu hàm mỗi IP mỗi phút. Khi vượt, API trả 429 kèm Retry-After; lượt trúng cache edge thường không bị tính.

Có tài liệu máy đọc được không?

Có. GET /api/bitcoin-intelligence-openapi trả về tài liệu OpenAPI 3.1 dạng JSON.