Đếm ngược và lịch sử halving Bitcoin
Đếm ngược và lịch sử halving Bitcoin
/api/indicators/halvingYê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ườ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 }`. |
| fetched_at | number | ms | Thời điểm CoinBoss lấy dữ liệu từ nguồn. |
| height | number | — | Chiều cao khối. |
| halving | object | — | Đếm ngược tới halving của Bitcoin, tính từ chiều cao khối hiện tại. |
| halving.epoch | number | count | Số lần halving đã diễn ra: floor(chiều cao ÷ 210,000). |
| halving.last_halving_height | number | blocks | Chiều cao khối của lần halving gần nhất. |
| halving.next_halving_height | number | blocks | Chiều cao khối mà tại đó lần halving tiếp theo diễn ra. |
| halving.remaining_blocks | number | blocks | Số khối còn lại cho tới lần halving tiếp theo. |
| halving.progress_pct | number | % | 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_ms | number | ms | Khoả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_ms | number | ms | Thờ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_reward | number | BTC | Trợ cấp khối hiện tại: 50 ÷ 2^`epoch`. |
| halving.next_reward | number | BTC | Trợ cấp khối sau lần halving tiếp theo: một nửa của `current_reward`. |
| halving.history | array | — | 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[].height | number | — | Chiều cao khối. |
| halving.history[].date | string | — | Ngày theo lịch (UTC). |
| halving.history[].reward | number | BTC | Trợ cấp khối áp dụng kể từ lần halving đó. |
| difficulty | null | — | Luôn là null: không cung cấp ước tính cho lần điều chỉnh độ khó tiếp theo. |
| current_difficulty | object | — | Độ khó đào Bitcoin hiện tại kèm thời điểm đọc. |
| current_difficulty.value | number | — | Giá trị. |
| current_difficulty.as_of | number | ms | Thời điểm độ khó được đọc. |
| current_difficulty.source | string | — | Giá trị này đến từ đâu. |
| sources | object | — | Nguồn dữ liệu. |
| sources.height | string | — | Chiều cao khối. |
| sources.block_interval | string | — | Tên nguồn của `avg_block_ms`; null khi dùng giá trị mặc định 10 phút. |
| sources.current_difficulty | string | — | 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"
- "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
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ĩ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ử
/api/indicators/halvingMột phầnKhông có tham số.
https://www.coinboss.com/api/indicators/halvingEndpoint khác trong danh mục này
- Tra cứu địa chỉ đa chuỗi /api/browser/:chain/address/:addr
- Tra cứu khối đa chuỗi /api/browser/:chain/block/:hashOrHeight
- Tra cứu giao dịch đa chuỗi /api/browser/:chain/tx/:txid
- Phát hiện một địa chỉ đang hoạt động trên những chuỗi EVM nào /api/browser/detect
- Thay đổi số dư của các địa chỉ trong bảng xếp hạng ví giàu BTC /api/btc/rich-flow
- Bảng xếp hạng ví giàu BTC /api/btc/rich-list
- Thống kê bảng xếp hạng ví giàu BTC /api/btc/rich-stat
- Xu hướng lượng nắm giữ của các ví giàu BTC /api/btc/rich-trend
- Tóm tắt địa chỉ Bitcoin /api/explorer/address/:addr
- Giao dịch của địa chỉ Bitcoin /api/explorer/address/:addr/txs
- Chi tiết khối Bitcoin /api/explorer/block/:hashOrHeight
- Đỉnh chuỗi Bitcoin /api/explorer/tip
- Chi tiết giao dịch Bitcoin /api/explorer/tx/:txid
- Số địa chỉ BTC nắm giữ nhiều hơn một ngưỡng /api/indicators/addr-above/:tier
- Chuỗi chỉ báo định giá on-chain của BTC /api/indicators/bdc/:name
- Số lượng và phân bố node Bitcoin kết nối được /api/indicators/bitnodes
- Chuỗi so sánh các nhóm nắm giữ BTC /api/indicators/btccmp/:pair
- Chuỗi biểu đồ on-chain của BTC /api/indicators/chain
- Lịch sử dòng BTC vào / ra sàn /api/indicators/cm/exchange-flows
- Nguồn cung BTC nằm trên sàn /api/indicators/cm/exchange-supply
- Lịch sử số địa chỉ BTC có số dư khác 0 /api/indicators/cm/nonzero-addresses
- Lượng BTC các chính phủ nắm giữ /api/indicators/gov-treasuries
- Đếm ngược và lịch sử halving Bitcoin /api/indicators/halving
- Tỷ trọng nguồn cung BTC không dịch chuyển hơn N năm /api/indicators/hodl-wave-above/:years
- Tỷ trọng khối của các mining pool Bitcoin /api/indicators/mempool/pools
- Lịch sử giá vốn và lượng BTC nắm giữ của Strategy /api/indicators/mstr-cost
- Tỷ trọng nguồn cung BTC đang có lãi /api/indicators/supply-profit-pct
- Lịch sử số dư dự trữ WBTC /api/indicators/wbtc-balance
- Bảng xếp hạng ví giàu đa chuỗi /api/rich-list/:chain
- Thay đổi số dư của các ví giàu đa chuỗi /api/rich-list/:chain/flow
- Thống kê bảng xếp hạng ví giàu đa chuỗi /api/rich-list/:chain/stat
- Xu hướng lượng nắm giữ của các ví giàu đa chuỗi /api/rich-list/:chain/trend
- Kho bạc coin của công ty đại chúng / tổ chức /api/treasuries/:coin