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/derivatives/coins

GETKhả dụng

Bộ lọc coin phái sinh

Bộ lọc coin phái sinh (giá, OI, funding, RSI, long/short, thanh lý; lọc được)

GET/api/derivatives/coins

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ả
limit	integer	Tùy chọn	50	≤ 500	Số dòng trả về. Ví dụ: 50
offset	integer	Tùy chọn	0	—	Offset phân trang.
onlyWatchlist	string	Tùy chọn	—	1	=1 chỉ lấy danh sách theo dõi của người gọi (cần JWT, không cache).
exchanges	string	Tùy chọn	—	—	Danh sách trắng các sàn, phân tách bằng dấu phẩy (27 sàn); 400 nếu không có sàn nào hợp lệ.
minMarketCap	number	Tùy chọn	—	—	Bộ lọc: vốn hóa tối thiểu (USD).
maxMarketCap	number	Tùy chọn	—	—	Bộ lọc: vốn hóa tối đa (USD).
minOi	number	Tùy chọn	—	—	Bộ lọc: vị thế mở tối thiểu (USD).
maxOi	number	Tùy chọn	—	—	Bộ lọc: vị thế mở tối đa (USD).
minFunding	number	Tùy chọn	—	—	Bộ lọc: tỷ lệ funding tối thiểu.
maxFunding	number	Tùy chọn	—	—	Bộ lọc: tỷ lệ funding tối đa.
minRsi1h	number	Tùy chọn	—	—	Bộ lọc: RSI 1h tối thiểu.
maxRsi1h	number	Tùy chọn	—	—	Bộ lọc: RSI 1h tối đa.
minRsi4h	number	Tùy chọn	—	—	Bộ lọc: RSI 4h tối thiểu.
maxRsi4h	number	Tùy chọn	—	—	Bộ lọc: RSI 4h tối đa.
minRsi1d	number	Tùy chọn	—	—	Bộ lọc: RSI 1d tối thiểu.
maxRsi1d	number	Tùy chọn	—	—	Bộ lọc: RSI 1d tối đa.
minChangePct	number	Tùy chọn	—	—	Bộ lọc: thay đổi 24h tối thiểu (%).
maxChangePct	number	Tùy chọn	—	—	Bộ lọc: thay đổi 24h tối đa (%).
minVolume	number	Tùy chọn	—	—	Bộ lọc: khối lượng 24h tối thiểu (USD).
maxVolume	number	Tùy chọn	—	—	Bộ lọc: khối lượng 24h tối đa (USD).
minLiq24h	number	Tùy chọn	—	—	Bộ lọc: thanh lý 24h tối thiểu (USD).
maxLiq24h	number	Tùy chọn	—	—	Bộ lọc: thanh lý 24h tối đa (USD).
minLsAccount	number	Tùy chọn	—	—	Bộ lọc: tỷ lệ long/short theo tài khoản tối thiểu.
maxLsAccount	number	Tùy chọn	—	—	Bộ lọc: tỷ lệ long/short theo tài khoản tối đa.
minOiChg1h	number	Tùy chọn	—	—	Bộ lọc: thay đổi OI 1h tối thiểu (%).
maxOiChg1h	number	Tùy chọn	—	—	Bộ lọc: thay đổi OI 1h tối đa (%).
minOiChg24h	number	Tùy chọn	—	—	Bộ lọc: thay đổi OI 24h tối thiểu (%).
maxOiChg24h	number	Tùy chọn	—	—	Bộ lọc: thay đổi OI 24h tối đa (%).

Yêu cầu mẫu

curl -s "https://www.coinboss.com/api/derivatives/coins?limit=50"

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.
total	number	—	Tổng.
data	array	—	Dữ liệu trả về.
data[]	object	—	Dữ liệu trả về.
data[].coin	string	—	Ký hiệu coin, viết hoa (ví dụ BTC).
data[].name	string	—	Tên.
data[].image_url	string	—	Đường dẫn icon cùng origin do CoinBoss phục vụ; null khi không có icon đã xác minh.
data[].market_cap	number	—	Vốn hóa thị trường.
data[].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).
data[].change_pct	number	%	Thay đổi tính theo phần trăm.
data[].volume_usd	number	USD	Khối lượng tính theo giá trị danh nghĩa USD.
data[].rsi_1h	number	—	RSI(14) trên nến 1h.
data[].rsi_4h	number	—	RSI(14) trên nến 4h.
data[].rsi_1d	number	—	RSI(14) trên nến ngày.
data[].basis_pct	number\|null	%	(futures − spot) / spot × 100.
data[].basis_annual_pct	null	% per year	Basis quy năm theo số ngày còn lại đến đáo hạn.
data[].oi_usd	number	USD	Vị thế mở tính theo giá trị danh nghĩa USD.
data[].funding_avg	number	—	Tỷ lệ funding trung bình trên các sàn.
data[].ls_account	number\|null	—	Tỷ lệ long/short theo tài khoản.
data[].ls_taker	number\|null	—	Tỷ lệ taker mua/bán.
data[].liq_24h_usd	number	USD	Thanh lý 24h.
data[].oi_chg_1h_pct	number	%	Thay đổi 1h của vị thế mở.
data[].oi_chg_24h_pct	number	%	Thay đổi 24h của vị thế mở.
data[].vol_chg_24h_pct	number	%	Thay đổi khối lượng trong 24h.
data[].updated_at	number	ms	Thời điểm dòng này được cập nhật lần cuối.

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/derivatives/coins?limit=50 · Phản hồi thật, ghi lại lúc 2026-11-13 04:02:33 UTC. Mảng và map dài được rút gọn khi hiển thị: data có 50 phần tử.

{
- "success": true,
- "now": 1794542553222,
- "total": 800,
- "data": [
  - { … 21 },
  - { … 21 }
  ]
}

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ủ: 5s
Micro-cache biên: 10s
Tần suất cập nhật: chỉ số dẫn xuất: top 100 coin mỗi 5 phút, hạng 101-400 mỗi 15 phút, hạng 401-980 mỗi 30 phút; ticker mỗi 60 s; giá trực tiếp được đẩy qua WebSocket
Khung thời gian: ảnh chụp mới nhất (ticker trong vòng 1 h)
Nguồn dữ liệu: Chỉ số phái sinh theo từng coin do CoinBoss tính sẵn từ các trình thu thập dữ liệu sàn của chính mình (25 nguồn, ví dụ binance, okx, bybit, bitget, gate, hyperliquid); tên coin, icon và vốn hóa lấy từ nhà tổng hợp dữ liệu thị trường bên thứ ba.
Độ phủ sàn: tối đa 980 coin xếp hạng theo vị thế mở tổng hợp (801 dòng tại thời điểm rà soát); tham số `exchanges` chỉ nhận các sàn trong danh sách cho phép gồm 27 sàn
Phân trang: limit (mặc định 50, tối đa 500)
Sắp xếp: oi_usd giảm dần
Đơn vị: oi / volume / liquidations in USD; change and RSI fields as percent / index values; funding as raw fraction; market_cap in USD
Phương pháp: oi_usd = cross-exchange open interest (all contract types, multiplier contracts folded); RSI(14) on 1 h / 4 h (aggregated from 1 h) / 1 d klines; oi_chg = change vs hourly archive; liq_24h_usd = 24 h SUM(value_usd); with the `exchanges` param metrics are recomputed at request time for the selected venues
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:33 UTCHTTP 20019 msSchema khớpĐiểm dữ liệu mới nhất có tuổi 4m

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

100% trong 412 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/derivatives/coinsKhả dụng

Tham số

limit

integer · mặc định 50 · tối đa 500 — Number of rows to return.

offset

integer · mặc định 0 — Pagination offset.

onlyWatchlist

string — =1 restricts to the caller watchlist (JWT required, uncached).

exchanges

string — Comma-separated exchange whitelist (27 venues); 400 if none valid.

minMarketCap

number — Filter: minimum market cap (USD).

maxMarketCap

number — Filter: maximum market cap (USD).

minOi

number — Filter: minimum open interest (USD).

maxOi

number — Filter: maximum open interest (USD).

minFunding

number — Filter: minimum funding rate.

maxFunding

number — Filter: maximum funding rate.

minRsi1h

number — Filter: minimum 1h RSI.

maxRsi1h

number — Filter: maximum 1h RSI.

minRsi4h

number — Filter: minimum 4h RSI.

maxRsi4h

number — Filter: maximum 4h RSI.

minRsi1d

number — Filter: minimum 1d RSI.

maxRsi1d

number — Filter: maximum 1d RSI.

minChangePct

number — Filter: minimum 24h change (%).

maxChangePct

number — Filter: maximum 24h change (%).

minVolume

number — Filter: minimum 24h volume (USD).

maxVolume

number — Filter: maximum 24h volume (USD).

minLiq24h

number — Filter: minimum 24h liquidations (USD).

maxLiq24h

number — Filter: maximum 24h liquidations (USD).

minLsAccount

number — Filter: minimum account long/short ratio.

maxLsAccount

number — Filter: maximum account long/short ratio.

minOiChg1h

number — Filter: minimum 1h OI change (%).

maxOiChg1h

number — Filter: maximum 1h OI change (%).

minOiChg24h

number — Filter: minimum 24h OI change (%).

maxOiChg24h

number — Filter: maximum 24h OI change (%).

URL yêu cầuhttps://www.coinboss.com/api/derivatives/coins?limit=50

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