GETKhả dụng
Chỉ số premium Bitcoin của Coinbase
Chỉ số premium Bitcoin của Coinbase
GET
/api/p3/coinbase-premiumYê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ả |
|---|---|---|---|---|---|
| range | string | Tùy chọn | 24h | 24h, 7d, 3m, 1y, 3y, all | Khung thời gian. Ví dụ: 24h |
Yêu cầu mẫu
curl -s "https://www.coinboss.com/api/p3/coinbase-premium?range=24h"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 }`. |
| now | number | ms | Thời gian máy chủ lúc phản hồi được dựng. |
| range | string | — | Khung thời gian được yêu cầu. |
| latest | object | — | Bản ghi gần nhất. |
| latest.ts | number | ms | Dấu thời gian. |
| latest.cb | number | USD | Giá BTC-USD trên Coinbase của điểm cuối cùng trong `series`. |
| latest.bn | number | USDT | Giá giao ngay BTCUSDT trên Binance của điểm cuối cùng trong `series`. |
| latest.gap | number | — | Chênh lệch giá. |
| latest.gap_pct | number | % | Chênh lệch giá. |
| series | array | — | Chuỗi thời gian. |
| series[] | object | — | Chuỗi thời gian. |
| series[].ts | number | ms | Dấu thời gian. |
| series[].cb | number | USD | Giá BTC-USD trên Coinbase: trung bình của bucket (bucket 1 phút với `24h`, 15 phút với `7d`) hoặc giá đóng cửa ngày với các khoảng dài hơn. |
| series[].bn | number | USDT | Giá giao ngay BTCUSDT trên Binance: trung bình của bucket (bucket 1 phút với `24h`, 15 phút với `7d`) hoặc giá đóng cửa ngày với các khoảng dài hơn. |
| series[].gap | number | — | Chênh lệch giá. |
| series[].gap_pct | number | % | Chênh lệch giá. |
Tạo lúc 2026-11-11 23:00 UTC từ 1 phản hồi thật.
Phản hồi mẫu
/api/p3/coinbase-premium?range=24h · Phản hồi thật, ghi lại lúc 2026-11-13 04:02:46 UTC. Mảng và map dài được rút gọn khi hiển thị: series có 1440 phần tử.
- "success"true
- "now"1794542566952
- "range""24h"
- "latest"
- "ts"1794542520000
- "cb"68655.16
- "bn"68731
- "gap"-75.84
- "gap_pct"-0.1103
- "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ủ
- 60s
- Micro-cache biên
- 10s
- Tần suất cập nhật
- mỗi 1 phút (tick trong ngày); chuỗi ngày được làm mới mỗi 6 giờ
- Khung thời gian
- `range` = 24h (bucket 1 phút, mặc định), 7d (bucket 15 phút), 3m / 1y / 3y / all (giá đóng cửa ngày)
- Nguồn dữ liệu
- Chỉ số premium Coinbase do CoinBoss tự tính từ giá BTC công khai của hai sàn.
- Độ phủ sàn
- Chỉ BTC; so sánh báo giá USD với báo giá USDT nên bao hàm mọi độ lệch USDT/USD.
- Sắp xếp
- thời gian tăng dần
- Đơn vị
- USD (gap) and percent (gap_pct)
- Phương pháp
- gap = Coinbase BTC-USD price - Binance BTCUSDT price; gap_pct = gap / Binance price x 100; intraday buckets are averages.
- 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:02:46 UTCHTTP 2009 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 47s
Độ khả dụng, 30 ngày qua
100% trong 411 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/p3/coinbase-premiumKhả dụngTham số
string · mặc định 24h — Time window.
URL yêu cầu
https://www.coinboss.com/api/p3/coinbase-premium?range=24hChọ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
- Basis hợp đồng tương lai (mọi sàn) /api/sd/basis
- Lịch sử basis (theo giờ) /api/sd/basis/history
- Xếp hạng coin theo basis /api/sd/basis/rank
- Danh sách basis giữa hợp đồng tương lai và giao ngay /api/derivatives/basis
- Chênh lệch giá BTC hằng ngày giữa Coinbase và Kraken /api/p3/cb-kr-spread
- Chỉ số premium Bitcoin của Coinbase /api/p3/coinbase-premium
- Danh sách chỉ số premium hợp đồng vĩnh cửu /api/p3/premium-index
- Lịch sử chỉ số premium của một coin /api/p3/premium-index/history
- Nến chỉ số premium /api/p3/premium-index/klines
- Premium OTC của USDT so với tỷ giá tiền pháp định /api/usdt-premium
- Danh sách đầy đủ basis giữa hợp đồng tương lai và giao ngay /api/basis/list