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/ex-table
GETKhả dụng

Bảng sàn trên trang coin

Bảng sàn trên trang coin (giá, khối lượng, OI, funding theo từng sàn; giao ngay hoặc hợp đồng tương lai)

GET/api/currency/ex-table

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
marketstringTùy chọnfuturesfutures, spot, perpetual, delivery, all`futures` (default) and `spot` return one row per exchange (`futures` one row per contract with `group=pair`). `perpetual`, `delivery` and `all` always return one row per market: perpetual contracts only, dated futures only, or every spot, perpetual and delivery market of the coin in one list. Any other value is treated as `futures`. Ví dụ: futures
groupstringTùy chọn—pair`pair` returns one row per contract instead of one row per exchange. Each row then carries `status`, `status_reason`, `market_type`, `expiry_ts`, `expiry_date`, `native_symbol`, `quote`, `margin_type`, `price_source`, `price_at` and `rank`, and the response adds a `meta` object. Rows whose `status` is not `active` (no live quote, no feed, expired) carry no price.

Yêu cầu mẫu

curl -s "https://www.coinboss.com/api/currency/ex-table?coin=BTC&market=futures"

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 }`.
coinstring—Ký hiệu coin, viết hoa (ví dụ BTC).
marketstring—Thị trường.
dataarray—Dữ liệu trả về.
data[]object—Dữ liệu trả về.
data[].exchangestring—ID sàn, viết thường (ví dụ `binance`).
data[].namestring—Tên.
data[].pairstring|null—Exchange symbol of the row's contract: the highest-volume contract of the exchange, or the exact contract with `group=pair` (the symbol as CoinBoss normalises it; the name used by the exchange is `native_symbol`); null when the exchange has open interest but no ticker.
data[].pricenumber|null—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_pctnumber|null%Thay đổi tính theo phần trăm.
data[].volume_usdnumber|nullUSDKhối lượng tính theo giá trị danh nghĩa USD.
data[].oi_usdnumber|nullUSDVị thế mở tính theo giá trị danh nghĩa USD.
data[].ls_rationumber|null—Tỷ lệ long/short.
data[].liq_longnumber|null—Vị thế long bị thanh lý.
data[].liq_shortnumber|null—Vị thế short bị thanh lý.
data[].fundingnumber|null—Khối hoặc giá trị tỷ lệ funding.
data[].funding_interval_hnumber|nullhChu kỳ funding. có thể vắng mặt
data[].funding_8hnumber|nullfraction`funding` được chuẩn hóa về chu kỳ 8 giờ: tỷ lệ × 8 ÷ `funding_interval_h` (0.0001 = 0.01 %); null khi không rõ chu kỳ thanh toán. có thể vắng mặt
data[].next_funding_timenumber|nullmsDấu thời gian. có thể vắng mặt
data[].multipliernumberxSố coin mà một đơn vị yết giá của hợp đồng đại diện (1000 với các hợp đồng kiểu 1000PEPE, còn lại là 1). có thể vắng mặt
data[].vol_change_pctnumber|null%Thay đổi khối lượng 24h của sàn so với ảnh chụp theo giờ được lấy 23–25 giờ trước; null khi không có ảnh chụp hoặc ở các dòng không phải dòng chính.
data[].oi_change_pctnumber|null%Thay đổi vị thế mở của sàn so với ảnh chụp theo giờ của chính các hợp đồng đó gần mốc 24 giờ trước nhất (±1 h); null khi không có mốc so sánh.
data[].oi_vol_change_pctnumber|null%Thay đổi của tỷ lệ vị thế mở ÷ khối lượng 24h so với chính tỷ lệ đó 24 giờ trước.
data[].price_rawnumber|nullUSDGiá gần nhất đúng như sàn yết cho hợp đồng, trước khi chia cho `multiplier`; bằng `price` khi `multiplier` là 1. có thể vắng mặt
data[].liquidity_usdnumber|nullUSDGiá trị danh nghĩa sổ lệnh phía mua cộng phía bán trong phạm vi ±1 % quanh giá giữa trên sàn này; là cận dưới khi `liquidity_complete` bằng false. có thể vắng mặt
data[].liquidity_reach_pctnumber%Khoảng cách tính từ giá giữa mà sổ lệnh do sàn trả về thực sự phủ tới, lấy giá trị nhỏ hơn giữa phía mua và phía bán. có thể vắng mặt
data[].liquidity_completeboolean—True khi sổ lệnh trả về vươn tới trọn dải ±1 % ở cả hai phía; false nghĩa là `liquidity_usd` thấp hơn thực tế. có thể vắng mặt
data[].oi_vol_rationumber|null—Vị thế mở chia cho khối lượng 24h.
data[].pair_dispstring—Dạng hiển thị của cặp theo kiểu cơ sở/yết giá (`BTC/USDT`, `1000PEPE/USDT`, `BTC/USD` với CME và các sàn ký quỹ bằng USD).
data[].contract_typestring|null—`perpetual` or `delivery` (dated futures); null on spot rows. With `group=pair` it comes from the exchange's contract specification where CoinBoss has one, otherwise from the expiry code in the symbol.
data[].expirystring(decimal)|null—Expiry date code YYMMDD of a dated contract. With `group=pair` it is derived from `expiry_ts` for every contract that has an expiry; otherwise it is the six-digit symbol suffix. Null for contracts without an expiry and for CME rows.
data[].market_typestring—`spot`, `perpetual` or `delivery`. có thể vắng mặt
data[].expiry_tsnumber|nullmsExpiry / delivery time of the contract, Unix milliseconds; null when the contract has no expiry or the exchange does not publish one. có thể vắng mặt
data[].expiry_datestring|null—Expiry date as YYYY-MM-DD (UTC); null when the contract has no expiry. có thể vắng mặt
data[].native_symbolstring|null—Contract name exactly as the exchange lists it (`BTCUSDT_270326`, `BTC-PERPETUAL`, `XBTMZ26`); null when CoinBoss holds no contract specification for the venue and on spot rows. có thể vắng mặt
data[].quotestring|null—Quote currency of the contract or spot pair (`USDT`, `USDC`, `USD`, …). có thể vắng mặt
data[].margin_typestring|null—Margin asset class from the contract specification: `usdt`, `usdc`, `coin`, `usd` or `other`; null when unknown and on spot rows. có thể vắng mặt
data[].statusstring—Market state of the row (only with `group=pair` and `market=spot`): `active` = a real quote received within the last hour and a 24h volume above zero; `no_quote` = the contract is listed but has no usable quote, see `status_reason`; `not_provided` = the exchange publishes no real-time ticker that CoinBoss collects (CME); `expired` = the contract is past its expiry. Rows that are not `active` carry no price. có thể vắng mặt
data[].status_reasonstring|null—Why a row is not `active`: `expired`, `no_realtime_feed`, `quote_stale` (last quote older than one hour), `no_price`, `no_volume` (the exchange reports no 24h volume) or `no_trades_24h` (the reported 24h volume is zero). Null on active rows. có thể vắng mặt
data[].price_sourcestring|null—Dataset the row's price and volume were read from: `market_tickers`, `sd_contract_latest` or `spot_coin_ex_vol`; null when no ticker exists for the contract. có thể vắng mặt
data[].price_atnumber|nullmsTime the row's ticker was received, Unix milliseconds. On rows that are not `active` it is the time of the last ticker seen (no price is returned for it), or null. có thể vắng mặt
data[].symbolstring—Symbol of the row as CoinBoss stores it (`BTCUSDT`, `BTCUSD_270326`, `BTC-27NOV26`); same value as `pair` on contract rows, base + quote on spot rows. The name used by the exchange is `native_symbol`. có thể vắng mặt
data[].basestring—Underlying of the contract or spot pair as traded. Contracts quoted in multiples of the coin keep the multiplier (`1000PEPE`). có thể vắng mặt
data[].market_statusstring—State of the market: `ACTIVE` = not expired, a quote of this market received within the last hour and a 24h volume above zero; `EXPIRING` = active and the exchange lists its expiry within the next 24 hours; `EXPIRED` = past its expiry; `STALE` = the last quote is older than one hour; `NO_QUOTE` = no usable quote, see `reason_code`. Only `ACTIVE` and `EXPIRING` rows carry a price and a `rank`. có thể vắng mặt
data[].reason_codestring|null—Why the row carries no price: `NO_QUOTE` (listed, but no trades in 24h or no last price / volume reported), `EXPIRED`, `STALE`, or `UNAVAILABLE` (CoinBoss collects no real-time ticker for this market, e.g. CME). Null on `ACTIVE` and `EXPIRING` rows. The finer cause is in `status_reason`. có thể vắng mặt
data[].source_atnumber|nullmsTime the ticker behind this row was received from the exchange, Unix milliseconds; null when no ticker exists. Same value as `price_at`. có thể vắng mặt
data[].qualitystring—`live` = `source_at` within the last hour, `stale` = older, `none` = no ticker for this market. có thể vắng mặt
data[].is_staleboolean—True when `quality` is `stale`. có thể vắng mặt
data[].expires_in_snumber|nullsSeconds until the expiry of the contract at the time the table was assembled; negative once expired; null when the contract has no expiry. có thể vắng mặt
data[].ranknumber|null—Position among rankable rows (`market_status` `ACTIVE` or `EXPIRING`) ordered by `volume_usd` descending, starting at 1 and counted inside the requested view; null on rows that are not rankable. có thể vắng mặt
data[].marketstring—Thị trường. có thể vắng mặt
metaobject— có thể vắng mặt
meta.groupstring—`pair` = one row per contract, `exchange` = one row per spot venue. có thể vắng mặt
meta.as_ofnumbermsTime the table was assembled, Unix milliseconds. có thể vắng mặt
meta.fresh_window_snumbersMaximum age of a quote for a row to count as `active`. có thể vắng mặt
meta.expiring_window_snumbersA contract whose expiry is closer than this is reported as `EXPIRING`. có thể vắng mặt
meta.volume_windowstring—Window of `volume_usd`: `24h_rolling`, the rolling 24-hour turnover each exchange reports. có thể vắng mặt
meta.volume_unitstring—Unit of `volume_usd`. có thể vắng mặt
meta.sortstring—Row order of the response in words. có thể vắng mặt
meta.countsobject—Number of rows per `status`. có thể vắng mặt
meta.counts.activenumbercountRows with `status=active`. có thể vắng mặt
meta.counts.no_quotenumbercountRows with `status=no_quote`. có thể vắng mặt
meta.counts.not_providednumbercountRows with `status=not_provided`. có thể vắng mặt
meta.counts.expirednumbercountRows with `status=expired`. có thể vắng mặt
meta.market_status_countsobject—Number of rows per `market_status`. có thể vắng mặt
meta.market_status_counts.ACTIVEnumbercountRows with `market_status=ACTIVE`. có thể vắng mặt
meta.market_status_counts.EXPIRINGnumbercountRows with `market_status=EXPIRING`. có thể vắng mặt
meta.market_status_counts.EXPIREDnumbercountRows with `market_status=EXPIRED`. có thể vắng mặt
meta.market_status_counts.NO_QUOTEnumbercountRows with `market_status=NO_QUOTE`. có thể vắng mặt
meta.market_status_counts.STALEnumbercountRows with `market_status=STALE`. có thể vắng mặt
meta.type_countsobject—Number of rows per market type. có thể vắng mặt
meta.type_counts.spotnumbercountSpot rows in the response. có thể vắng mặt
meta.type_counts.perpetualnumbercountPerpetual rows in the response. có thể vắng mặt
meta.type_counts.deliverynumbercountDelivery (dated futures) rows in the response. có thể vắng mặt
meta.type_rankableobject—Number of rankable rows (`ACTIVE` or `EXPIRING`) per market type. có thể vắng mặt
meta.type_rankable.spotnumbercountSpot rows that are rankable (`ACTIVE` or `EXPIRING`). có thể vắng mặt
meta.type_rankable.perpetualnumbercountPerpetual rows that are rankable. có thể vắng mặt
meta.type_rankable.deliverynumbercountDelivery rows that are rankable. có thể vắng mặt

Tạo lúc 2026-11-12 10:57 UTC từ 9 phản hồi thật.

Phản hồi mẫu

/api/currency/ex-table?coin=BTC&market=futures · Phản hồi thật, ghi lại lúc 2026-11-13 03:57:28 UTC. Mảng và map dài được rút gọn khi hiển thị: data có 24 phần tử.

  • {
    • "success": true,
    • "coin": "BTC",
    • "market": "futures",
    • "data": [
      • { … 26 },
      • { … 26 }
      ]
    }

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=BTC&market=all200139 msĐạt
coin=BTC&market=perpetual2001 msĐạt
coin=BTC&market=delivery2002 msĐạt
coin=BTC&group=pair&market=futures2002 msĐạt
coin=BTC&market=spot2001 msĐạt
coin=ETH&market=futures200105 msĐạt
coin=SOL&market=futures20067 msĐạt
coin=ARKM&market=futures20055 msĐạt

Kiểm tra lúc 2026-11-13 03:57:28 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 / OI / funding mỗi 60 s đến 5 phút; độ sâu sổ lệnh mỗi 5 phút; khối lượng giao ngay mỗi 10 phút; thanh lý theo thời gian thực
Khung thời gian
ảnh chụp mới nhất (ticker 1 h, OI 3 h, funding 4 h, long/short 24 h, độ sâu 30 phút); thay đổi 24 h so với bản lưu theo giờ
Nguồn dữ liệu
Thống kê hợp đồng tương lai và giao ngay theo từng sàn của một coin, tổng hợp từ các trình thu thập của chính CoinBoss, vốn polling API công khai của khoảng 30 sàn (ví dụ binance, okx, bybit, bitget, gate, hyperliquid).
Độ phủ sàn
hợp đồng tương lai: mọi sàn có ticker còn mới cho coin (tối đa 24); độ sâu từ 15 sàn cho khoảng 28 coin; giao ngay (market=spot): 14 sàn giao ngay
Sắp xếp
volume_usd desc. With `group=pair` and with `market=spot|perpetual|delivery|all`: rankable rows (`market_status` ACTIVE or EXPIRING) first by volume_usd desc (these carry `rank`), then rows without a live quote by oi_usd desc, expired contracts last; ties by expiry, exchange and symbol, so every request made at the same moment gets the same order
Đơn vị
price in USD (multiplier contracts normalized to one coin); volume / OI / liquidations / depth in USD; funding as raw fraction and 8 h-normalized fraction; changes in percent
Phương pháp
per exchange (futures): volume = SUM(volume_usd); funding_8h = rate x 8 / interval_hours of the largest-OI contract; depth_1pct_usd = bid + ask notional within +/- 1% of mid; OI 24 h change by same-contract pairing; volume change vs the ticker archive 23-25 h earlier; liquidations = 24 h SUM(value_usd)
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:28 UTCHTTP 200139 msSchema khớp

Độ 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/ex-tableKhả dụng
Tham số

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

string · mặc định futures — `futures` (default) and `spot` return one row per exchange (`futures` one row per contract with `group=pair`). `perpetual`, `delivery` and `all` always return one row per market: perpetual contracts only, dated futures only, or every spot, perpetual and delivery market of the coin in one list. Any other value is treated as `futures`.

string — `pair` returns one row per contract instead of one row per exchange. Each row then carries `status`, `status_reason`, `market_type`, `expiry_ts`, `expiry_date`, `native_symbol`, `quote`, `margin_type`, `price_source`, `price_at` and `rank`, and the response adds a `meta` object. Rows whose `status` is not `active` (no live quote, no feed, expired) carry no price.

URL yêu cầuhttps://www.coinboss.com/api/currency/ex-table?coin=BTC&market=futures
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.