Объём 24ч—Открытый интерес—Ликвидации 24ч$1.36BЛонг/Шорт 24ч—Доминация BTC—Доминация ETH—
Приложение
Язык ▾
₽ RUB ▾
/api/currency/ex-table
GETДоступен

Таблица бирж для страницы монеты

Таблица бирж для страницы монеты (цена, объём, OI, финансирование по площадкам; спот или фьючерсы)

GET/api/currency/ex-table

Запрос

Параметры запроса

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
coinstringОбязательный——Символ базовой монеты (в верхнем регистре, например BTC). Пример: BTC
marketstringНеобязательныйfuturesfutures, 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`. Пример: futures
groupstringНеобязательный—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.

Пример запроса

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

Поля ответа

Таблица полей формируется из реальных ответов, поэтому в ней перечислено ровно то, что возвращает эндпоинт. В путях a[] обозначает элементы массива, а {*} — объекты с динамическим ключом, например монетой или биржей.

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
coinstring—Символ монеты в верхнем регистре (например, BTC).
marketstring—Рынок.
dataarray—Полезные данные.
data[]object—Полезные данные.
data[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
data[].namestring—Название.
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—Последняя цена в валюте котировки (USD или USDT, если не указано иное).
data[].change_pctnumber|null%Изменение в процентах.
data[].volume_usdnumber|nullUSDОбъём (номинал в USD).
data[].oi_usdnumber|nullUSDОткрытый интерес (номинал в USD).
data[].ls_rationumber|null—Соотношение лонг/шорт.
data[].liq_longnumber|null—Ликвидированные лонги.
data[].liq_shortnumber|null—Ликвидированные шорты.
data[].fundingnumber|null—Блок или значение ставки финансирования.
data[].funding_interval_hnumber|nullhИнтервал финансирования. может отсутствовать
data[].funding_8hnumber|nullfraction`funding`, приведённая к 8-часовому интервалу: ставка × 8 ÷ `funding_interval_h` (0.0001 = 0.01 %); null, если интервал расчётов неизвестен. может отсутствовать
data[].next_funding_timenumber|nullmsМетка времени. может отсутствовать
data[].multipliernumberxЧисло монет в одной котируемой единице контракта (1000 для контрактов вида 1000PEPE, иначе 1). может отсутствовать
data[].vol_change_pctnumber|null%Изменение объёма биржи за 24h относительно её почасового снимка, сделанного 23–25 часов назад; null, если снимка нет, а также в неосновных строках.
data[].oi_change_pctnumber|null%Изменение открытого интереса биржи относительно почасового снимка тех же контрактов, ближайшего к моменту 24 часа назад (±1 h); null, если базы сравнения нет.
data[].oi_vol_change_pctnumber|null%Изменение отношения «открытый интерес ÷ объём за 24h» относительно того же отношения 24 часа назад.
data[].price_rawnumber|nullUSDПоследняя цена в том виде, в каком биржа котирует контракт, до деления на `multiplier`; равна `price`, если `multiplier` равен 1. может отсутствовать
data[].liquidity_usdnumber|nullUSDСуммарный номинал бидов и асков в книге ордеров в пределах ±1 % от средней цены на этой бирже; нижняя граница, если `liquidity_complete` равно false. может отсутствовать
data[].liquidity_reach_pctnumber%Расстояние от средней цены, фактически покрытое книгой ордеров, которую вернула биржа: меньшее из значений по стороне бидов и стороне асков. может отсутствовать
data[].liquidity_completeboolean—True, если возвращённая книга ордеров охватывает весь диапазон ±1 % с обеих сторон; false означает, что `liquidity_usd` занижено. может отсутствовать
data[].oi_vol_rationumber|null—Открытый интерес, делённый на объём за 24h.
data[].pair_dispstring—Отображаемый вид пары в формате «базовая/котируемая» (`BTC/USDT`, `1000PEPE/USDT`, `BTC/USD` для CME и площадок с маржой в 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`. может отсутствовать
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. может отсутствовать
data[].expiry_datestring|null—Expiry date as YYYY-MM-DD (UTC); null when the contract has no expiry. может отсутствовать
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. может отсутствовать
data[].quotestring|null—Quote currency of the contract or spot pair (`USDT`, `USDC`, `USD`, …). может отсутствовать
data[].margin_typestring|null—Margin asset class from the contract specification: `usdt`, `usdc`, `coin`, `usd` or `other`; null when unknown and on spot rows. может отсутствовать
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. может отсутствовать
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. может отсутствовать
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. может отсутствовать
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. может отсутствовать
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`. может отсутствовать
data[].basestring—Underlying of the contract or spot pair as traded. Contracts quoted in multiples of the coin keep the multiplier (`1000PEPE`). может отсутствовать
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`. может отсутствовать
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`. может отсутствовать
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`. может отсутствовать
data[].qualitystring—`live` = `source_at` within the last hour, `stale` = older, `none` = no ticker for this market. может отсутствовать
data[].is_staleboolean—True when `quality` is `stale`. может отсутствовать
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. может отсутствовать
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. может отсутствовать
data[].marketstring—Рынок. может отсутствовать
metaobject— может отсутствовать
meta.groupstring—`pair` = one row per contract, `exchange` = one row per spot venue. может отсутствовать
meta.as_ofnumbermsTime the table was assembled, Unix milliseconds. может отсутствовать
meta.fresh_window_snumbersMaximum age of a quote for a row to count as `active`. может отсутствовать
meta.expiring_window_snumbersA contract whose expiry is closer than this is reported as `EXPIRING`. может отсутствовать
meta.volume_windowstring—Window of `volume_usd`: `24h_rolling`, the rolling 24-hour turnover each exchange reports. может отсутствовать
meta.volume_unitstring—Unit of `volume_usd`. может отсутствовать
meta.sortstring—Row order of the response in words. может отсутствовать
meta.countsobject—Number of rows per `status`. может отсутствовать
meta.counts.activenumbercountRows with `status=active`. может отсутствовать
meta.counts.no_quotenumbercountRows with `status=no_quote`. может отсутствовать
meta.counts.not_providednumbercountRows with `status=not_provided`. может отсутствовать
meta.counts.expirednumbercountRows with `status=expired`. может отсутствовать
meta.market_status_countsobject—Number of rows per `market_status`. может отсутствовать
meta.market_status_counts.ACTIVEnumbercountRows with `market_status=ACTIVE`. может отсутствовать
meta.market_status_counts.EXPIRINGnumbercountRows with `market_status=EXPIRING`. может отсутствовать
meta.market_status_counts.EXPIREDnumbercountRows with `market_status=EXPIRED`. может отсутствовать
meta.market_status_counts.NO_QUOTEnumbercountRows with `market_status=NO_QUOTE`. может отсутствовать
meta.market_status_counts.STALEnumbercountRows with `market_status=STALE`. может отсутствовать
meta.type_countsobject—Number of rows per market type. может отсутствовать
meta.type_counts.spotnumbercountSpot rows in the response. может отсутствовать
meta.type_counts.perpetualnumbercountPerpetual rows in the response. может отсутствовать
meta.type_counts.deliverynumbercountDelivery (dated futures) rows in the response. может отсутствовать
meta.type_rankableobject—Number of rankable rows (`ACTIVE` or `EXPIRING`) per market type. может отсутствовать
meta.type_rankable.spotnumbercountSpot rows that are rankable (`ACTIVE` or `EXPIRING`). может отсутствовать
meta.type_rankable.perpetualnumbercountPerpetual rows that are rankable. может отсутствовать
meta.type_rankable.deliverynumbercountDelivery rows that are rankable. может отсутствовать

Сформировано 2026-11-12 10:57 UTC; использовано реальных ответов: 9.

Пример ответа

/api/currency/ex-table?coin=BTC&market=futures · Реальный ответ, получен 2026-11-13 03:57:28 UTC. Длинные массивы и словари сокращены для отображения: data: элементов было 24.

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

Проверенные образцы

Помимо примера выше, автопроверка вызывает этот эндпоинт с указанными параметрами и каждый раз сверяет схему.

ПараметрыHTTPЗадержкаРезультат
coin=BTC&market=all200139 msПройдено
coin=BTC&market=perpetual2001 msПройдено
coin=BTC&market=delivery2002 msПройдено
coin=BTC&group=pair&market=futures2002 msПройдено
coin=BTC&market=spot2001 msПройдено
coin=ETH&market=futures200105 msПройдено
coin=SOL&market=futures20067 msПройдено
coin=ARKM&market=futures20055 msПройдено

Проверено: 2026-11-13 03:57:28 UTC

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
30s
Пограничный микрокеш
10s
Частота обновления
тикеры / OI / финансирование — раз в 60 s – 5 min; глубина книги ордеров — раз в 5 min; спотовый объём — раз в 10 min; ликвидации — в реальном времени
Окно
последний снимок (тикеры 1 h, OI 3 h, финансирование 4 h, лонг/шорт 24 h, глубина 30 min); изменения за 24 h — относительно почасовых архивов
Источники данных
Статистика фьючерсов и спота одной монеты по биржам, собранная собственными коллекторами CoinBoss, которые опрашивают публичные API примерно 30 площадок (например, binance, okx, bybit, bitget, gate, hyperliquid).
Покрытие бирж
фьючерсы: все площадки с актуальным тикером монеты (до 24); глубина — с 15 площадок примерно для 28 монет; спот (market=spot): 14 спотовых площадок
Сортировка
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
Единицы измерения
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
Метод расчёта
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)
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный

Текущий статус

ДоступенПроверено: 2026-11-13 03:57:28 UTCHTTP 200139 msСхема совпадает

Доступность за последние 30 дней

Пройдено 99.76% из 411 проверок

Ошибки

Неудачные вызовы имеют одинаковую структуру на всех эндпоинтах. Полный список приведён на странице ошибок. Ошибки и лимиты запросов →

КодHTTPЗначениеЧто делать
INVALID_PARAM400Отсутствует обязательный параметр, или значение не принимается. `param` называет параметр, если он известен.Не повторяйте запрос без изменений; исправьте его.
UNAUTHORIZED401Заголовок `CB-API-KEY` был отправлен, но ключ неизвестен или отозван. Для публичных данных ключ не нужен — уберите заголовок или используйте действительный ключ.Не повторяйте запрос без изменений.
FORBIDDEN403Маршрут не входит в публичный API (внутренний или только для аккаунта).Не повторяйте запрос.
NOT_FOUND404Неизвестный маршрут, либо запрошенная монета / биржа / фонд не существует.Не повторяйте запрос; сверьте путь и идентификаторы с каталогом.
RATE_LIMITED429Запросов больше, чем позволяет поминутный лимит. `Retry-After` указывает, сколько секунд нужно подождать.Дождитесь истечения `Retry-After`, затем повторите запрос с нарастающей задержкой.
INTERNAL500Непредвиденная ошибка сервера. Сообщение намеренно общее; при обращении указывайте `request_id`.Повторите запрос один раз через несколько секунд; если ошибка сохраняется, сообщите о ней, указав ID запроса.
UPSTREAM_FAILED503Источник данных, стоящий за этим эндпоинтом, не ответил вовремя. Устаревшие или подменные значения вместо него не возвращаются.Повторите запрос с нарастающей задержкой; проверьте страницу статуса.
UNAVAILABLE501 / 503Набор данных временно не готов (прогрев кеша), либо у эндпоинта пока нет законного публичного источника.Повторите запрос позже; каталог помечает эндпоинты, недоступные по проектному решению.
REQUEST_FAILED200Некоторые более старые эндпоинты отвечают HTTP 200 с `success: false`. Всегда проверяйте `success`, а не только статус HTTP.Зависит от сообщения; считайте запрос неудачным.

Попробовать

GET/api/currency/ex-tableДоступен
Параметры

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

string · по умолчанию 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 запросаhttps://www.coinboss.com/api/currency/ex-table?coin=BTC&market=futures
Выберите эндпоинт и нажмите «Отправить запрос». Здесь появятся ответ, заголовки и время выполнения.