GETKhả dụng
Số địa chỉ BTC nắm giữ nhiều hơn một ngưỡng
Số địa chỉ BTC nắm giữ nhiều hơn một ngưỡng (lịch sử)
GET
/api/indicators/addr-above/:tierYêu cầu
Tham số truy vấn
| Tên | Kiểu | Bắt buộc | Mặc định | Giá trị hợp lệ | Mô tả |
|---|---|---|---|---|---|
| tier path | string | Bắt buộc | — | 1, 10, 100, 1000 | Ngưỡng số dư BTC; 400 khi không xác định. Ví dụ: 1000 |
Tham số được đánh dấu “path” là một phần của URL.
Yêu cầu mẫu
curl -s "https://www.coinboss.com/api/indicators/addr-above/1000"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 }`. |
| series | array | — | Chuỗi thời gian. |
| series[] | object | — | Chuỗi thời gian. |
| series[].name | string | — | Tên. |
| series[].data | array | — | Dữ liệu trả về. |
| series[].data[] | array | — | Dữ liệu trả về. |
| series[].data[][] | number | — | Dữ liệu trả về. |
| series[].color | string | — | Màu hiển thị (hex). |
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/addr-above/1000 · Phản hồi thật, ghi lại lúc 2026-11-13 03:59:13 UTC. Mảng và map dài được rút gọn khi hiển thị: series[].data có 1437 phần tử.
- "success"true
- "series"
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ủ
- 60m
- Micro-cache biên
- 10s
- Tần suất cập nhật
- hằng ngày (lần làm mới bắt đầu lúc 03:00 UTC, mỗi 8 phút một chỉ số do giới hạn tần suất của gói miễn phí phía upstream)
- Khung thời gian
- toàn bộ lịch sử mà nguồn upstream cung cấp (khoảng một khung trượt 4 năm), theo ngày
- Nguồn dữ liệu
- Số địa chỉ BTC nắm giữ nhiều hơn một mức số dư cho trước, do CoinBoss tự tính từ số lượng theo dải số dư của bên thứ ba.
- Độ phủ sàn
- Chỉ BTC; `tier` = 1 | 10 | 100 | 1000 (giá trị khác trả về 400).
- Sắp xếp
- ngày tăng dần
- Đơn vị
- addresses (count)
- Phương pháp
- Sum of the address counts of all balance bands above the tier (1-10, 10-100, 100-1k, 1k-10k, >10k BTC).
- 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
Khả dụngKiểm tra lúc 2026-11-13 03:59:13 UTCHTTP 2001 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 2.2d
Độ 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ử
GET
/api/indicators/addr-above/:tierKhả dụngTham số
string — BTC balance threshold; 400 if unknown.
URL yêu cầu
https://www.coinboss.com/api/indicators/addr-above/1000Chọ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.
Endpoint 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