Khối lượng 24h—Vị thế mở—Thanh lý 24h$1.36BLong/Short 24h—Thống trị BTC—Thống trị ETH—
Ứng dụng
Ngôn ngữ ▾
₫ VND ▾
/api/currency/overview
GETKhả dụng

Tổng quan chi tiết coin

Tổng quan chi tiết coin (giá, vốn hóa, nguồn cung, tóm tắt phái sinh)

GET/api/currency/overview

Yêu cầu

Tham số truy vấn

TênKiểuBắt buộcMặc địnhGiá trị hợp lệMô tả
coinstringBắt buộc——Ký hiệu coin cơ sở (viết hoa, ví dụ BTC). Ví dụ: BTC

Yêu cầu mẫu

curl -s "https://www.coinboss.com/api/currency/overview?coin=BTC"

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ườngKiểuĐơn vịMô tả
successboolean—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 }`.
dataobject—Dữ liệu trả về.
data.coinstring—Ký hiệu coin, viết hoa (ví dụ BTC).
data.supplyobject—Nguồn cung, tính bằng coin.
data.supply.price_usdstring(decimal)USDGiá.
data.supply.market_cap_usdstring(decimal)USDVốn hóa thị trường.
data.supply.mcap_ranknumber—Thứ hạng theo vốn hóa thị trường.
data.supply.vol_24h_usdstring(decimal)USDKhối lượng 24h.
data.supply.circulatingstring(decimal)—Nguồn cung lưu hành, tính bằng coin.
data.supply.total_supplystring(decimal)—Tổng cung, tính bằng coin.
data.supply.max_supplystring(decimal)|null—Nguồn cung tối đa, tính bằng coin; null khi không giới hạn hoặc không rõ.
data.supply.change_24h_pctstring(decimal)%Thay đổi 24h tính theo phần trăm.
data.supply.image_urlstring—Đường dẫn icon cùng origin do CoinBoss phục vụ; null khi không có icon đã xác minh.
data.supply.website_urlstring—Website chính thức của dự án, lấy từ metadata của coin.
data.supply.reddit_urlstring|null—Subreddit của dự án; null khi không có.
data.supply.github_urlstring|null—Kho mã nguồn chính của dự án; null khi không có.
data.supply.whitepaper_urlstring—Liên kết tới whitepaper của dự án.
data.supply.explorer_urlstring—Liên kết tới một trình khám phá khối của coin.
data.supply.categorystring—Danh mục.
data.supply.asofnumbermsThời điểm của dữ liệu mới nhất được dùng.
data.supply.staleboolean—Các dòng hoặc cờ dành cho dữ liệu cũ hơn khung dữ liệu mới.
data.supply.spot_vol_usdnumberUSDTổng khối lượng giao ngay 24h của coin trên các sàn giao ngay do CoinBoss tự thu thập (ảnh chụp mới nhất); null khi không được thu thập.
data.supply.futures_vol_usdnumberUSDTổng khối lượng hợp đồng tương lai 24h trên mọi sàn có ticker mới hơn 1 giờ, cùng giá trị với `futures_vol.total_usd`; null khi không có dữ liệu tự thu thập.
data.supply.oi_total_usdnumberUSDVị thế mở tổng hợp của coin trên mọi sàn và mọi loại hợp đồng, cùng giá trị với `oi.total_usd`; null khi không có dữ liệu tự thu thập.
data.supply.high_24hstring(decimal)—Giá cao nhất 24h.
data.supply.low_24hstring(decimal)—Giá thấp nhất 24h.
data.futures_vol_chg_pctnumber%Thay đổi 24h của khối lượng hợp đồng tương lai: tính trên các sàn có mặt cả ở hiện tại lẫn trong ảnh chụp theo giờ khoảng 24 giờ trước, (Σ hiện tại − Σ trước đó) ÷ Σ trước đó.
data.oi_chg_pctnumber%Thay đổi 24h của vị thế mở, tính trên các hợp đồng có mặt cả ở hiện tại lẫn trong ảnh chụp theo giờ gần mốc 24 giờ trước nhất.
data.oiobject—Vị thế mở.
data.oi.total_usdnumberUSDTổng.
data.oi.local_usdnumberUSDVị thế mở cộng từ dữ liệu do CoinBoss tự thu thập theo từng sàn; trùng với `oi.total_usd`.
data.oi.by_exchangearray—Phần tách theo từng sàn.
data.oi.by_exchange[]object—Phần tách theo từng sàn.
data.oi.by_exchange[].exchangestring—ID sàn, viết thường (ví dụ `binance`).
data.oi.by_exchange[].oi_usdnumberUSDVị thế mở tính theo giá trị danh nghĩa USD.
data.oi.n_exchangesnumber—Số sàn đóng góp dữ liệu.
data.oi.asofnumbermsThời điểm của dữ liệu mới nhất được dùng.
data.oi.chg_basisobject—Đầu vào của `oi_chg_pct`: tổng hiện tại và tổng trước đó đã ghép cặp (`cur`, `prev`), số sàn khớp được, giờ mốc so sánh và các hợp đồng đứng yên bị loại.
data.oi.chg_basis.curnumber—Giá trị hiện tại.
data.oi.chg_basis.prevnumber—Giá trị trước đó (mốc so sánh).
data.oi.chg_basis.n_matchednumber—Số mục có mặt ở cả hai đầu của phép so sánh.
data.oi.chg_basis.prev_hour_tsnumbermsThời điểm bắt đầu của bucket giờ trước.
data.oi.chg_basis.frozen_excludedobject—Các dòng bị loại vì giá trị nguồn không thay đổi.
data.oi.chg_basis.frozen_excluded.n_baselinenumber—Số mục trong ảnh chụp mốc so sánh.
data.oi.chg_basis.frozen_excluded.n_currentnumber—Số mục trong ảnh chụp hiện tại.
data.oi.chg_basis.frozen_excluded.cur_usdnumberUSDGiá trị hiện tại.
data.oi.chg_basis.frozen_excluded.prev_usdnumberUSDGiá trị mốc so sánh.
data.futures_volobject—Khối lượng hợp đồng tương lai.
data.futures_vol.total_usdnumberUSDTổng.
data.futures_vol.n_exchangesnumber—Số sàn đóng góp dữ liệu.
data.futures_vol.chg_basisobject—Đầu vào của `futures_vol_chg_pct`: tổng khối lượng hiện tại và trước đó đã ghép cặp (`cur`, `prev`), số sàn khớp được và giờ mốc so sánh.
data.futures_vol.chg_basis.curnumber—Giá trị hiện tại.
data.futures_vol.chg_basis.prevnumber—Giá trị trước đó (mốc so sánh).
data.futures_vol.chg_basis.n_matchednumber—Số mục có mặt ở cả hai đầu của phép so sánh.
data.futures_vol.chg_basis.prev_hour_tsnumbermsThời điểm bắt đầu của bucket giờ trước.
data.fundingnumber—Khối hoặc giá trị tỷ lệ funding.
data.funding_detailobject—Phần tách đứng sau `funding`: tỷ lệ chuẩn hóa 8h dạng trung bình đơn giản và trung bình trọng số theo vị thế mở, tỷ lệ quy năm, số sàn và một mục cho mỗi sàn.
data.funding_detail.basisstring—Giá hợp đồng tương lai trừ giá giao ngay, hoặc khối basis.
data.funding_detail.avg_8hnumber—Trung bình của các tỷ lệ đã chuẩn hóa 8h.
data.funding_detail.oi_weighted_8hnumber—Trung bình trọng số theo vị thế mở của các tỷ lệ đã chuẩn hóa 8h.
data.funding_detail.apr_pctnumber% per yearPhần trăm quy năm.
data.funding_detail.n_exchangesnumber—Số sàn đóng góp dữ liệu.
data.funding_detail.n_normalizednumber—Các sàn đã được chuẩn hóa về 8h.
data.funding_detail.n_unknown_intervalnumber—Các sàn không rõ chu kỳ funding.
data.funding_detail.by_exchangearray—Phần tách theo từng sàn.
data.funding_detail.by_exchange[]object—Phần tách theo từng sàn.
data.funding_detail.by_exchange[].exchangestring—ID sàn, viết thường (ví dụ `binance`).
data.funding_detail.by_exchange[].symbolstring—Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT).
data.funding_detail.by_exchange[].ratenumber—Tỷ lệ.
data.funding_detail.by_exchange[].interval_hnumberhChu kỳ.
data.funding_detail.by_exchange[].rate_8hnumber—Tỷ lệ được chuẩn hóa về chu kỳ 8 giờ.
data.funding_detail.by_exchange[].next_funding_timenumber|nullmsDấu thời gian.
data.long_shortobject—Khối long/short.
data.long_short.longnumber—Giá trị phía long.
data.long_short.shortnumber—Giá trị phía short.
data.long_short.rationumber—Tỷ lệ.
data.long_short.typestring—Loại.
data.long_short.n_exchangesnumber—Số sàn đóng góp dữ liệu.
data.derivedobject—Các chỉ báo của coin được tính lại định kỳ (RSI, basis, vị thế mở tổng hợp, funding trung bình, tỷ trọng long/short, thanh lý 24h); null khi chưa được tính.
data.derived.rsi_1hstring(decimal)—RSI(14) trên nến 1h.
data.derived.rsi_4hstring(decimal)—RSI(14) trên nến 4h.
data.derived.rsi_1dstring(decimal)—RSI(14) trên nến ngày.
data.derived.basis_pctstring(decimal)|null%(futures − spot) / spot × 100.
data.derived.basis_annual_pctnull% per yearBasis quy năm theo số ngày còn lại đến đáo hạn.
data.derived.oi_usd_aggstring(decimal)USDVị thế mở tổng hợp trên mọi sàn và mọi loại hợp đồng tại lần làm mới chỉ báo gần nhất; có thể trễ đôi chút so với `oi.total_usd`.
data.derived.funding_avgstring(decimal)—Tỷ lệ funding trung bình trên các sàn.
data.derived.ls_accountstring(decimal)—Tỷ lệ long/short theo tài khoản.
data.derived.ls_takerstring(decimal)|null—Tỷ lệ taker mua/bán.
data.derived.liq_24h_usdstring(decimal)USDThanh lý 24h.
data.liquidationobject—Khối thanh lý. khóa động: 1h,4h,12h,24h
data.liquidation.{*}object—Khối thanh lý.
data.liquidation.{*}.winstring—Nhãn khung thời gian của mục, lặp lại khóa của nó (`1h`, `4h`, `12h` hoặc `24h`).
data.liquidation.{*}.long_usdnumberUSDPhía long.
data.liquidation.{*}.short_usdnumberUSDPhía short.
data.liquidation.{*}.total_usdnumberUSDTổng.
data.liquidation.{*}.cntnumber—Số lượng.

Tạo lúc 2026-11-11 23:00 UTC từ 4 phản hồi thật.

Phản hồi mẫu

/api/currency/overview?coin=BTC · Phản hồi thật, ghi lại lúc 2026-11-13 03:57:31 UTC. Mảng và map dài được rút gọn khi hiển thị: data.liquidation có 4 phần tử; data.oi.by_exchange có 22 phần tử; data.funding_detail.by_exchange có 23 phần tử.

  • {
    • "success": true,
    • "data": {
      • "coin": "BTC",
      • "supply": { … 22 },
      • "futures_vol_chg_pct": 67.76,
      • "oi_chg_pct": -3.65,
      • "oi": { … 6 },
      • "futures_vol": { … 3 },
      • "funding": 0.000057831612725940206,
      • "funding_detail": { … 8 },
      • "long_short": { … 5 },
      • "derived": { … 10 },
      • "liquidation": { … 2 }
      }
    }

Mẫu đã xác minh

Ngoài ví dụ ở trên, trình thăm dò còn gọi endpoint này với các tham số dưới đây và kiểm tra schema ở mỗi lần gọi.

Tham sốHTTPĐộ trễKết quả
coin=ETH20086 msĐạt
coin=SOL20081 msĐạt
coin=ARKM20079 msĐạt

Kiểm tra lúc 2026-11-13 03:57:31 UTC

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ủ
30s
Micro-cache biên
10s
Tần suất cập nhật
nhà tổng hợp dữ liệu thị trường bên thứ ba, mỗi 10 phút; ticker mỗi 1 phút; OI/funding/long-short mỗi 5 phút (coin chủ lực mỗi 1 phút); khối lượng giao ngay mỗi 10 phút; cache trong bộ nhớ 30 s
Khung thời gian
24h trượt cho khối lượng/thanh lý; ảnh chụp mới nhất cho OI/funding/long-short
Nguồn dữ liệu
Nguồn cung, vốn hóa và thứ hạng lấy từ nhà tổng hợp dữ liệu thị trường bên thứ ba; giá, vị thế mở, funding, long/short, khối lượng hợp đồng tương lai và giao ngay do CoinBoss tự tổng hợp từ API công khai của các sàn; thanh lý lấy từ luồng thanh lý của sàn.
Độ phủ sàn
Mọi coin có trong bảng lấy từ nhà tổng hợp dữ liệu thị trường bên thứ ba hoặc có hợp đồng phái sinh đang niêm yết
Phân trang
không có
Đơn vị
USD; rates as decimals; changes in percent
Phương pháp
OI = SUM(oi_usd) over fresh contracts incl. multiplier contracts (3h; CME 120h); funding = OI-weighted mean of rate normalized to 8h (rate * 8 / interval_hours)
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:57:31 UTCHTTP 20095 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 20s

Độ khả dụng, 30 ngày qua

99.76% 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ĩaCách xử lý
INVALID_PARAM400Thiế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.
UNAUTHORIZED401Header `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.
FORBIDDEN403Route 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_FOUND404Route 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_LIMITED429Số 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.
INTERNAL500Lỗ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_FAILED503Nguồ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.
UNAVAILABLE501 / 503Bộ 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_FAILED200Mộ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/currency/overviewKhả dụng
Tham số

string — Base coin symbol (uppercase, e.g. BTC).

URL yêu cầuhttps://www.coinboss.com/api/currency/overview?coin=BTC
Chọ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.