/api/indicators/halving
GETMột phần

Đếm ngược và lịch sử halving Bitcoin

Đếm ngược và lịch sử halving Bitcoin

GET/api/indicators/halving
Độ phủ một phần. Chiều cao khối là dữ liệu trực tiếp. `current_difficulty` mang độ khó của mạng kèm dấu thời gian và nguồn; `difficulty` (tiến độ điều chỉnh độ khó) là `null` khi nguồn của nó không khả dụng.

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/indicators/halving"

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 }`.
fetched_atnumbermsThời điểm CoinBoss lấy dữ liệu từ nguồn.
heightnumber—Chiều cao khối.
halvingobject—Đếm ngược tới halving của Bitcoin, tính từ chiều cao khối hiện tại.
halving.epochnumbercountSố lần halving đã diễn ra: floor(chiều cao ÷ 210,000).
halving.last_halving_heightnumberblocksChiều cao khối của lần halving gần nhất.
halving.next_halving_heightnumberblocksChiều cao khối mà tại đó lần halving tiếp theo diễn ra.
halving.remaining_blocksnumberblocksSố khối còn lại cho tới lần halving tiếp theo.
halving.progress_pctnumber%Tiến độ trong kỷ nguyên 210,000 khối hiện tại: (chiều cao − `last_halving_height`) ÷ 210,000 × 100.
halving.avg_block_msnumbermsKhoảng cách khối trung bình gần đây từ một nguồn dữ liệu blockchain công khai; dùng 600000 khi nguồn không khả dụng.
halving.eta_msnumbermsThời điểm ước tính của lần halving tiếp theo: hiện tại + `remaining_blocks` × `avg_block_ms`. Là ước tính thay đổi theo khoảng cách khối.
halving.current_rewardnumberBTCTrợ cấp khối hiện tại: 50 ÷ 2^`epoch`.
halving.next_rewardnumberBTCTrợ cấp khối sau lần halving tiếp theo: một nửa của `current_reward`.
halving.historyarray—Các điểm lịch sử, cũ nhất trước nếu không nêu khác.
halving.history[]object—Các điểm lịch sử, cũ nhất trước nếu không nêu khác.
halving.history[].heightnumber—Chiều cao khối.
halving.history[].datestring—Ngày theo lịch (UTC).
halving.history[].rewardnumberBTCTrợ cấp khối áp dụng kể từ lần halving đó.
difficultynull—Luôn là null: không cung cấp ước tính cho lần điều chỉnh độ khó tiếp theo.
current_difficultyobject—Độ khó đào Bitcoin hiện tại kèm thời điểm đọc.
current_difficulty.valuenumber—Giá trị.
current_difficulty.as_ofnumbermsThời điểm độ khó được đọc.
current_difficulty.sourcestring—Giá trị này đến từ đâu.
sourcesobject—Nguồn dữ liệu.
sources.heightstring—Chiều cao khối.
sources.block_intervalstring—Tên nguồn của `avg_block_ms`; null khi dùng giá trị mặc định 10 phút.
sources.current_difficultystring—Nguồn gốc của giá trị độ khó.

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/indicators/halving · Phản hồi thật, ghi lại lúc 2026-11-13 03:59:14 UTC. Mảng và map dài được rút gọn khi hiển thị: halving.history có 4 phần tử.

  • {
    • "success": true,
    • "fetched_at": 1794542355398,
    • "height": 975627,
    • "halving": {
      • "epoch": 4,
      • "last_halving_height": 840000,
      • "next_halving_height": 1050000,
      • "remaining_blocks": 74373,
      • "progress_pct": 64.58,
      • "avg_block_ms": 776283,
      • "eta_ms": 1852276850957,
      • "current_reward": 3.125,
      • "next_reward": 1.5625,
      • "history": [ … 2 ]
      },
    • "difficulty": null,
    • "current_difficulty": {
      • "value": 148364561003867,
      • "as_of": 1794542355398,
      • "source": "blockchain.info"
      },
    • "sources": {
      • "height": "blockchain.info",
      • "block_interval": "blockchain.info",
      • "current_difficulty": "blockchain.info"
      }
    }

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ủ
2m
Micro-cache biên
10s
Tần suất cập nhật
theo yêu cầu, cache 2 phút
Khung thời gian
ảnh chụp mới nhất
Nguồn dữ liệu
Đếm ngược halving của Bitcoin, do CoinBoss tự tính từ chiều cao khối hiện tại do các API blockchain công khai báo cáo.
Độ phủ sàn
Chỉ Bitcoin; `difficulty` luôn là null.
Đơn vị
blocks; milliseconds (avg_block_ms, eta_ms); BTC (block reward); percent (progress)
Phương pháp
Next halving height = (epoch + 1) x 210000; ETA = now + remaining blocks x average block interval (600 s fallback); reward = 50 / 2^epoch.
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

Trạng thái trực tiếp

Một phầnKiểm tra lúc 2026-11-13 03:59:14 UTCHTTP 2001066 msSchema khớp

Chiều cao khối là dữ liệu trực tiếp. `current_difficulty` mang độ khó của mạng kèm dấu thời gian và nguồn; `difficulty` (tiến độ điều chỉnh độ khó) là `null` khi nguồn của nó không khả dụng.

Độ 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/indicators/halvingMột phần
Tham số

Không có tham số.

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