GETKhả dụng
Các dải định giá đỉnh chu kỳ
Các dải định giá đỉnh chu kỳ (nhiều mô hình vốn hóa)
GET
/api/indicators/cycle-capsYê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/cycle-caps"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 }`. |
| updated_at | number | ms | Thời điểm dòng này được cập nhật lần cuối. |
| series | object | — | Chuỗi thời gian. |
| series.price | array | — | Giá gần nhất tính theo đồng yết giá (USD hoặc USDT nếu không nêu khác). |
| series.price[] | array | — | Giá gần nhất tính theo đồng yết giá (USD hoặc USDT nếu không nêu khác). |
| series.price[][] | number | — | Giá gần nhất tính theo đồng yết giá (USD hoặc USDT nếu không nêu khác). |
| series.topCap | array | — | Giá Top Cap theo ngày của BTC: 35 × `avgPrice`. Là ước tính của mô hình; nguồn cung được suy ra từ lịch halving. |
| series.topCap[] | array | — | Mỗi ngày một cặp `[timestamp, price]`. |
| series.topCap[][] | number | — | Phần tử 0 là dấu thời gian của ngày tính bằng Unix ms, phần tử 1 là giá tính bằng USD. |
| series.avgPrice | array | — | Giá Average Cap theo ngày: trung bình lũy kế của vốn hóa theo ngày ÷ nguồn cung ước tính. Là ước tính của mô hình. |
| series.avgPrice[] | array | — | Mỗi ngày một cặp `[timestamp, price]`. |
| series.avgPrice[][] | number | — | Phần tử 0 là dấu thời gian của ngày tính bằng Unix ms, phần tử 1 là giá tính bằng USD. |
| series.deltaTop | array | — | Giá Delta Top theo ngày: 7 × (giá thực hiện hóa − `avgPrice`); chỉ gồm những ngày có giá thực hiện hóa dương. Là ước tính của mô hình. |
| series.deltaTop[] | array | — | Mỗi ngày một cặp `[timestamp, price]`. |
| series.deltaTop[][] | number | — | Phần tử 0 là dấu thời gian của ngày tính bằng Unix ms, phần tử 1 là giá tính bằng USD. |
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/cycle-caps · Phản hồi thật, ghi lại lúc 2026-11-13 03:59:03 UTC. Mảng và map dài được rút gọn khi hiển thị: series.price có 5931 phần tử; series.topCap có 5931 phần tử; series.avgPrice có 5931 phần tử; series.deltaTop có 1455 phần tử.
- "success"true
- "updated_at"1794541710712
- "series"
- "price"
- "topCap"
- "avgPrice"
- "deltaTop"
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ủ
- 30m
- Micro-cache biên
- 10s
- Tần suất cập nhật
- dữ liệu theo ngày; cache chỉ được làm mới khi có yêu cầu, tối đa 12 giờ một lần
- Khung thời gian
- toàn bộ lịch sử theo ngày (Delta Top chỉ có ở những nơi có giá thực hiện hóa, khoảng 4 năm gần nhất)
- Nguồn dữ liệu
- Các mô hình giá đỉnh chu kỳ, do CoinBoss tự tính từ lịch sử giá BTC và một chuỗi giá thực hiện hóa của bên thứ ba.
- Độ phủ sàn
- Chỉ BTC.
- Sắp xếp
- ngày tăng dần
- Đơn vị
- USD
- Phương pháp
- Top Cap price = 35 x average cap / supply (average cap = cumulative mean of daily market cap); Delta Top = 7 x (realized price - average price).
- 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:03 UTCHTTP 2006 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 11m
Độ khả dụng, 30 ngày qua
99.75% 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/cycle-capsKhả dụngTham số
Không có tham số.
URL yêu cầu
https://www.coinboss.com/api/indicators/cycle-capsChọ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
- Chuỗi chỉ báo tích lũy AHR999 /api/indicators/ahr999
- Chỉ số bong bóng Bitcoin /api/indicators/bitcoin-bubble
- Toàn bộ lịch sử giá đóng cửa theo ngày của BTC /api/indicators/btc-history
- Danh sách kiểm tra tín hiệu đỉnh thị trường tăng /api/indicators/bull-peak-signals
- Chỉ số tổng hợp chu kỳ tăng giá CBBI /api/indicators/cbbi
- Chỉ số rủi ro phái sinh (phương pháp CoinBoss) /api/indicators/cdri
- Chỉ số tổng hợp phái sinh (phương pháp CoinBoss) /api/indicators/cgdi
- Tương quan của BTC với vàng / S&P 500 /api/indicators/correlation
- Ma trận tương quan của các tài sản chính /api/indicators/correlation-matrix
- Tình trạng pháp lý của crypto theo quốc gia /api/indicators/crypto-legality
- Các dải định giá đỉnh chu kỳ /api/indicators/cycle-caps
- Chuỗi thời gian nhân đôi giá BTC /api/indicators/doubling-time
- Xu hướng mức độ quan tâm tìm kiếm trên Google /api/indicators/google-trends
- Chuỗi vĩ mô /api/indicators/macro-series
- Kết quả mô hình dự báo giá /api/indicators/price-forecast
- Chuỗi mức sụt giảm so với ATH /api/indicators/price-no-turning-back
- Số người đăng ký subreddit Bitcoin trên Reddit /api/indicators/reddit-subs
- Lượt xem trang Wikipedia /api/indicators/wikipedia-pageviews
- Chỉ số mùa altcoin (phương pháp CoinBoss) /api/indices/altseason
- Radar dò đáy /api/indices/bottom-radar
- Nghiên cứu tình huống lịch sử của radar dò đáy /api/indices/bottom-radar/case-0819
- Bảng tín hiệu đa yếu tố của BTC /api/indices/btc-signal
- Backtest tín hiệu BTC /api/indices/btc-signal/backtest
- Chỉ số Fear & Greed /api/indices/fear-greed
- Chỉ số Fear & Greed (hiện tại và lịch sử) /api/market/fear-greed
- Kết quả backtest tín hiệu /api/signal/backtest/:coin
- Bảng giám sát tín hiệu /api/signal/monitor/:coin