GETKhả dụng
Bảng tín hiệu đa yếu tố của BTC
Bảng tín hiệu đa yếu tố của BTC
GET
/api/indices/btc-signalYê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/indices/btc-signal"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 }`. |
| totalScore | number | — | Tổng có trọng số của điểm sáu chiều, −100 đến 100; dương là thiên về tăng giá. |
| label | object | — | Nhãn. |
| label.key | string | — | Khóa. |
| label.zh | string | — | Văn bản bằng tiếng Trung. |
| dims | array | — | Sáu chiều của tín hiệu: `liq`, `funding`, `oi`, `ls`, `options`, `basis`. |
| dims[] | object | — | Một chiều: `key`, `zh` (tên tiếng Trung), `weight`, `score`, `detail` (văn bản tiếng Trung) và `raw` (các đầu vào). |
| dims[].key | string | — | Khóa. |
| dims[].zh | string | — | Văn bản bằng tiếng Trung. |
| dims[].weight | number | fraction | Trọng số của chiều trong `totalScore`: 0.25 cho `liq`, 0.15 cho mỗi chiều còn lại. |
| dims[].score | number | — | Điểm số. |
| dims[].detail | string | — | Chi tiết. |
| dims[].raw | object | — | Giá trị đúng như nhận được từ nguồn. |
| dims[].raw.longLiq | number | USD | Thanh lý long BTC trong 4 giờ qua. có thể vắng mặt |
| dims[].raw.shortLiq | number | USD | Thanh lý short BTC trong 4 giờ qua. có thể vắng mặt |
| dims[].raw.imbalance | number | ratio | (`shortLiq` − `longLiq`) ÷ (`shortLiq` + `longLiq`), −1 đến 1; được báo là 0 khi không có thanh lý nào. có thể vắng mặt |
| dims[].raw.rate | number | — | Tỷ lệ. có thể vắng mặt |
| dims[].raw.oiChg | number | % | Thay đổi của tổng vị thế mở các hợp đồng USDT của BTC so với ảnh chụp theo giờ có tuổi ít nhất 24 giờ; được báo là 0 khi không có ảnh chụp nào. có thể vắng mặt |
| dims[].raw.priceChg | number | % | Thay đổi từ giá mở cửa đến giá đóng cửa của nến ngày BTC mới nhất (ngày UTC hiện tại), không phải 24 giờ trượt. có thể vắng mặt |
| dims[].raw.oiCur | number | USD | Vị thế mở hiện tại cộng trên các hợp đồng ký quỹ USDT của BTC. có thể vắng mặt |
| dims[].raw.longPct | number | % | Tỷ lệ phần trăm long trung bình trên các dòng tỷ lệ long/short của BTC; mã nguồn thay bằng 55 khi không có dòng nào. có thể vắng mặt |
| dims[].raw.pc | number | ratio | Vị thế mở quyền chọn put của BTC ÷ vị thế mở quyền chọn call, cả hai tính bằng USD; mã nguồn thay bằng 1 khi không có vị thế mở call. có thể vắng mặt |
| dims[].raw.callOi | number | USD | Vị thế mở của quyền chọn call BTC. có thể vắng mặt |
| dims[].raw.putOi | number | USD | Vị thế mở của quyền chọn put BTC. có thể vắng mặt |
| dims[].raw.basisPct | number | % | Basis hợp đồng vĩnh cửu trung bình (giá hợp đồng vĩnh cửu so với giá giao ngay) trên các hợp đồng BTC; được báo là 0 khi không có dòng nào. có thể vắng mặt |
| ts | number | ms | Dấu thời gian. |
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/indices/btc-signal · Phản hồi thật, ghi lại lúc 2026-11-13 04:03:34 UTC. Mảng và map dài được rút gọn khi hiển thị: dims có 6 phần tử.
- "success"true
- "totalScore"-32.6
- "label"
- "key""bear"
- "zh""偏空"
- "dims"
- "ts"1794542614556
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
- tính lại theo yêu cầu (cache 2 phút); dữ liệu đầu vào được làm mới mỗi 1-10 phút
- Khung thời gian
- ảnh chụp mới nhất (thanh lý: 4 giờ gần nhất; vị thế mở: thay đổi 24h)
- Nguồn dữ liệu
- Điểm tổng hợp do CoinBoss tự xây dựng từ dữ liệu thanh lý, funding, vị thế mở, long/short, quyền chọn và basis thu thập trực tiếp từ các sàn.
- Độ phủ sàn
- Chỉ BTC.
- Đơn vị
- score -100..+100 per dimension and overall, with a label
- Phương pháp
- Weighted sum of six dimension scores: liquidation imbalance (0.25) and funding rate, OI/price change, retail long share (contrarian), put/call OI ratio, basis (0.15 each); labels strong_bull >=40, bull >=15, bear <=-15, strong_bear <=-40.
- 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 04:03:34 UTCHTTP 200393 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 0s
Độ khả dụng, 30 ngày qua
100% trong 409 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/indices/btc-signalKhả dụngTham số
Không có tham số.
URL yêu cầu
https://www.coinboss.com/api/indices/btc-signalChọ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