Khối lượng 24h—Vị thế mở—Thanh lý 24h$1.36B Long/Short 24h—Thống trị BTC—Thống trị ETH—

Ứng dụng

Ngôn ngữ ▾

₫ VND ▾

/api/sd/volume

GETKhả dụng

Khối lượng hợp đồng tương lai của một coin

Lớp dữ liệu tự thu thập: khối lượng hợp đồng tương lai của một coin

GET/api/sd/volume

Yê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ả
coin	string	Bắt buộc	—	—	Ký hiệu coin; 400 khi thiếu. Bí danh: `base`. Ví dụ: BTC

Yêu cầu mẫu

curl -s "https://www.coinboss.com/api/sd/volume?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ườ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 }`.
coin	string	—	Ký hiệu coin, viết hoa (ví dụ BTC).
now	number	ms	Thời gian máy chủ lúc phản hồi được dựng.
futures	object	—	Khối hoặc giá trị của thị trường hợp đồng tương lai.
futures.total_usd	number	USD	Khối lượng hợp đồng tương lai 24h trên các sàn (giá trị danh nghĩa USD).
futures.n_exchanges	number	—	Số sàn đóng góp dữ liệu.
futures.by_exchange	array	—	Phần tách theo từng sàn.
futures.by_exchange[]	object	—	Phần tách theo từng sàn.
futures.by_exchange[].exchange	string	—	ID sàn, viết thường (ví dụ `binance`).
futures.by_exchange[].vol_usd	number	USD	Khối lượng tính theo giá trị danh nghĩa USD.
futures.by_exchange[].legacy_usd	number	USD	Phần khối lượng đến từ tập ticker hợp đồng vĩnh cửu USDT.
futures.by_exchange[].sd_usd	number	USD	Phần đến từ các hợp đồng bổ sung (USDC, ký quỹ bằng coin, giao sau có kỳ hạn) đã được tính.
futures.by_exchange[].share_pct	number	%	Tỷ trọng trong tổng.
futures.change_24h	object	—	Thay đổi 24h.
futures.change_24h.pct	number	%	Phần trăm.
futures.change_24h.cur	number	—	Giá trị hiện tại.
futures.change_24h.prev	number	—	Giá trị trước đó (mốc so sánh).
futures.change_24h.n_matched	number	—	Số mục có mặt ở cả hai đầu của phép so sánh.
futures.change_24h.n_total	number	—	Số mục có mặt hiện tại.
futures.change_24h.prev_ts	number	ms	Thời điểm của ảnh chụp mốc so sánh.
futures.change_24h.basis	string	—	Giá hợp đồng tương lai trừ giá giao ngay, hoặc khối basis.
futures.selfdata_contracts	object	—	Các hợp đồng bổ sung: những gì đã được tính và những gì còn đang chờ.
futures.selfdata_contracts.included_usd	null	USD	Khối lượng 24h của các hợp đồng được thu thập bổ sung (ký quỹ bằng coin, USDC, giao sau có kỳ hạn) đã được tính vào tổng hợp đồng tương lai; null khi chưa có hợp đồng nào được tính.
futures.selfdata_contracts.n_included	number	count	Số hợp đồng được thu thập bổ sung đã tính vào tổng hợp đồng tương lai (những hợp đồng có ảnh chụp riêng từ khoảng 24 giờ trước).
futures.selfdata_contracts.pending_usd	number\|null	USD	Tổng của các mục đang chờ, không nằm trong tổng.
futures.selfdata_contracts.n_pending	number	count	Số hợp đồng được thu thập bổ sung chưa được tính vì thiếu mốc so sánh 24 giờ trước của riêng chúng; các hợp đồng lớn nhất được liệt kê trong `pending`.
futures.selfdata_contracts.pending	array	—	Các mục đã thu thập nhưng chưa được tính.
futures.selfdata_contracts.pending[]	object	—	Các mục đã thu thập nhưng chưa được tính.
futures.selfdata_contracts.pending[].exchange	string	—	ID sàn, viết thường (ví dụ `binance`).
futures.selfdata_contracts.pending[].symbol	string	—	Ký hiệu công cụ đã được CoinBoss chuẩn hóa (ví dụ BTCUSDT).
futures.selfdata_contracts.pending[].margin	string	—	Nhóm đồng ký quỹ.
futures.selfdata_contracts.pending[].contract_type	string	—	`perpetual` hoặc `delivery`.
futures.selfdata_contracts.pending[].vol_usd	number	USD	Khối lượng tính theo giá trị danh nghĩa USD.
futures.selfdata_contracts.pending[].reason	string	—	Mã lý do.
spot	object	—	Khối hoặc giá trị của thị trường giao ngay.
spot.total_usd	number	USD	Khối lượng giao ngay 24h trên các sàn.
spot.n_exchanges	number	—	Số sàn đóng góp dữ liệu.
spot.asof	number	ms	Thời điểm của dữ liệu mới nhất được dùng.
spot.by_exchange	array	—	Phần tách theo từng sàn.
spot.by_exchange[]	object	—	Phần tách theo từng sàn.
spot.by_exchange[].exchange	string	—	ID sàn, viết thường (ví dụ `binance`).
spot.by_exchange[].vol_usd	number	USD	Khối lượng tính theo giá trị danh nghĩa USD.
spot.by_exchange[].quote	string	—	Các đồng yết giá được tính cho sàn này.
spot.by_exchange[].ts	number	ms	Dấu thời gian.
spot.by_exchange[].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).
spot.by_exchange[].age_s	number	s	Số giây kể từ lần cập nhật gần nhất của dòng này.
spot.by_exchange[].share_pct	number	%	Tỷ trọng trong tổng.
spot.change_24h	object	—	Thay đổi 24h.
spot.change_24h.pct	number	%	Phần trăm.
spot.change_24h.cur	number	—	Giá trị hiện tại.
spot.change_24h.prev	number	—	Giá trị trước đó (mốc so sánh).
spot.change_24h.n_matched	number	—	Số mục có mặt ở cả hai đầu của phép so sánh.
spot.change_24h.n_total	number	—	Số mục có mặt hiện tại.
spot.change_24h.prev_ts	number	ms	Thời điểm của ảnh chụp mốc so sánh.
spot.change_24h.basis	string	—	Giá hợp đồng tương lai trừ giá giao ngay, hoặc khối basis.
ratios	object	—	Các tỷ lệ khối lượng: `futures_to_spot` (khối lượng hợp đồng tương lai 24h ÷ khối lượng giao ngay 24h) và `oi_to_futures_volume`; mỗi tỷ lệ là null khi thiếu một đầu vào.
ratios.futures_to_spot	number	—	Khối lượng hợp đồng tương lai chia cho khối lượng giao ngay.
ratios.oi_to_futures_volume	number	—	Vị thế mở chia cho khối lượng hợp đồng tương lai 24h.
method	object	—	Diễn giải dạng văn bản thuần về các công thức dùng cho phản hồi này.
method.futures	string	—	Khối hoặc giá trị của thị trường hợp đồng tương lai.
method.spot	string	—	Khối hoặc giá trị của thị trường giao ngay.
method.change	string	—	Thay đổi trong kỳ đã nêu.
method.oi_to_futures_volume	string	—	Định nghĩa dạng văn bản thuần của `ratios.oi_to_futures_volume`: tổng vị thế mở tính bằng USD ÷ khối lượng hợp đồng tương lai 24h tính bằng USD.

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/sd/volume?coin=BTC · Phản hồi thật, ghi lại lúc 2026-11-13 03:57:37 UTC. Mảng và map dài được rút gọn khi hiển thị: spot.by_exchange có 14 phần tử; futures.by_exchange có 23 phần tử; futures.selfdata_contracts.pending có 5 phần tử.

{
- "success": true,
- "coin": "BTC",
- "now": 1794542257033,
- "futures": {
  - "total_usd": 79049803843.06,
  - "n_exchanges": 23,
  - "by_exchange": [ … 2 ],
  - "change_24h": { … 7 },
  - "selfdata_contracts": { … 5 }
  },
- "spot": {
  - "total_usd": 7929483908.44,
  - "n_exchanges": 14,
  - "asof": 1794541800000,
  - "by_exchange": [ … 2 ],
  - "change_24h": { … 7 }
  },
- "ratios": {
  - "futures_to_spot": 9.9691,
  - "oi_to_futures_volume": 0.6197
  },
- "method": {
  - "futures": "SUM of each exchange 24h quote turnover in USD for this coin's contracts (ticker fresh within 1h); self-collected coin-margined/USDC/delivery contracts are adde…",
  - "spot": "per exchange: 24h quote turnover summed over that exchange's USD/USDT/USDC-quoted spot pairs of the coin (quote = the largest pair); total = SUM over exchanges …",
  - "change": "same-exchange pairing: only exchanges with both a current value and a snapshot ~24h ago enter numerator and denominator",
  - "oi_to_futures_volume": "total open interest (USD) / 24h futures turnover (USD)"
  }
}

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=ETH	200	38 ms	Đạt
coin=SOL	200	46 ms	Đạt
coin=ARKM	200	43 ms	Đạt
—	400	1 ms	Đạt trả về lỗi như dự kiến

Kiểm tra lúc 2026-11-13 03:57:37 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: ticker hợp đồng tương lai mỗi 60 s (hợp đồng ký quỹ bằng coin / USDC / có kỳ hạn mỗi 120 s); ảnh chụp giao ngay mỗi 10 phút
Khung thời gian: khối lượng 24 h trượt đúng như từng sàn báo cáo; thay đổi 24 h so với bản lưu riêng của khoảng 24 h trước đó
Nguồn dữ liệu: Khối lượng hợp đồng tương lai 24h từ các trình thu thập ticker của CoinBoss (24 sàn phái sinh) và khối lượng giao ngay 24h từ các trình thu thập ticker giao ngay của CoinBoss (14 sàn giao ngay, ví dụ binance, okx, bybit, coinbase, kraken, upbit).
Độ phủ sàn: hợp đồng tương lai: tối đa 24 sàn; giao ngay: 14 sàn, các cặp yết giá bằng USD / USDT / USDC
Đơn vị: volumes in USD; changes in percent; ratios dimensionless
Phương pháp: futures total = SUM(volume_usd) of tickers fresh within 1 h, plus non-USDT-perp contracts once they have their own ~24 h baseline; spot total = SUM of the latest per-exchange snapshot within 30 min; 24 h change by same-exchange pairing; ratios futures_to_spot and oi_to_futures_volume
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
Có từ: 2026-11-11

Trạng thái trực tiếp

Khả dụngKiểm tra lúc 2026-11-13 03:57:37 UTCHTTP 20042 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 8m

Độ 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/sd/volumeKhả dụng

Tham số

coin Bắt buộc

string — Coin symbol; 400 when missing. Alias: `base`.

URL yêu cầuhttps://www.coinboss.com/api/sd/volume?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.

Gói dữ liệu coin trong một lần gọi (OI, funding, thanh lý, khối lượng, long/short) /api/sd/coin
Khối lượng hợp đồng tương lai của một coin /api/sd/volume
Bộ lọc coin phái sinh /api/derivatives/coins
Bảng coin phái sinh đầy đủ /api/derivatives/coins-full
Nến phái sinh của một coin /api/derivatives/kline
Danh sách RSI theo coin /api/derivatives/rsi
Chuỗi MACD của một coin /api/indicators/ta/macd/:coin
Chuỗi lịch sử của một coin /api/market/history
Ticker phái sinh tổng hợp theo coin /api/market/tickers
Xếp hạng khối lượng phái sinh /api/market/volume-rank