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

Обзор деривативов одной биржи

Обзор деривативов одной биржи (OI, объём, число монет, ...)

GET/api/exchanges/detail

Запрос

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

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
exstringОбязательный——Идентификатор биржи (приводится к нижнему регистру, только a-z0-9.); 400, если не указан. Пример: binance

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

curl -s "https://www.coinboss.com/api/exchanges/detail?ex=binance"

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
dataobject—Полезные данные.
data.exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
data.namestring—Название.
data.volume_usdnumberUSDОбъём (номинал в USD).
data.oi_usdnumberUSDОткрытый интерес (номинал в USD).
data.liq_24h_longnumber—Ликвидированные лонги за 24h.
data.liq_24h_shortnumber—Ликвидированные шорты за 24h.
data.liq_24h_totalnumber—Всего ликвидаций за 24h.
data.liq_24h_cntnumbercountЧисло ордеров ликвидации, зафиксированных на бирже за последние 24 часа; null, если у биржи нет потока ликвидаций.
data.liq_sourceboolean—True, если за последние 7 дней по этой бирже есть записи о ликвидациях; при false поля `liq_24h_*` равны null, а не нулю.
data.contractsnumber—Строки по контрактам.
data.options_vol_usdnullUSDЗарезервировано для объёма опционов биржи; сейчас не заполняется, поэтому значение всегда null.
data.taker_feenumber%Комиссия тейкера базового уровня по бессрочным контрактам USDT из публичной тарифной сетки биржи (0.05 = 0.05 %); статическое справочное значение, null, если неизвестно.
data.maker_feenumber%Комиссия мейкера базового уровня по бессрочным контрактам USDT из публичной тарифной сетки биржи (0.02 = 0.02 %); статическое справочное значение, null, если неизвестно.
data.is_dexboolean—True для децентрализованных бирж бессрочных контрактов (например, Hyperliquid, dYdX, Aster), false для централизованных.
data.scorenumber—Оценка.
data.has_lsboolean—True, если по этой бирже доступны данные о соотношении лонг/шорт.
data.total_assets_usdnumber|nullUSDСовокупные активы в раскрытых кошельках биржи (то же значение, что и `reserve.tvl_usd`) по данным стороннего источника; null, если биржа не охвачена.
data.reserveobject|null—Снимок резервов в раскрытых кошельках биржи по данным стороннего источника, обновляется примерно раз в 6 часов; null, если биржа не охвачена.
data.reserve.tvl_usdnumberUSDОбщая заблокированная стоимость.
data.reserve.clean_tvl_usdnumberUSDАктивы в кошельках без собственного платформенного токена биржи — по определению стороннего источника; null, если значение не публикуется.
data.reserve.inflow_24hnumberUSDЧистый приток в кошельки биржи за последние 24 часа (отрицательное значение = чистый отток) по данным стороннего источника.
data.reserve.inflow_1wnumberUSDЧистый приток в кошельки биржи за последние 7 дней (отрицательное значение = чистый отток) по данным стороннего источника.
data.reserve.inflow_1mnumberUSDЧистый приток в кошельки биржи за последний месяц (отрицательное значение = чистый отток) по данным стороннего источника.
data.reserve.wallets_linkstring—URL собственного раскрытия биржи о кошельках или подтверждении резервов; null, если оно неизвестно.
data.reserve.updated_atnumbermsВремя последнего обновления этой строки.
data.dist_oiarray—Топ-20 монет по открытому интересу на этой бирже, от большего к меньшему; контракты, давно не обновлявшиеся, исключены.
data.dist_oi[]object—Одна монета: `coin` — базовый актив, `v` — его открытый интерес на этой бирже в USD.
data.dist_oi[].coinstring—Символ монеты в верхнем регистре (например, BTC).
data.dist_oi[].vnumber—Значение.
data.dist_volarray—Топ-20 монет по фьючерсному объёму за 24 часа на этой бирже, от большего к меньшему; тикеры, не обновлявшиеся в течение 1 часа, исключены.
data.dist_vol[]object—Одна монета: `coin` — базовый актив, `v` — его объём за 24 часа на этой бирже в USD.
data.dist_vol[].coinstring—Символ монеты в верхнем регистре (например, BTC).
data.dist_vol[].vnumber—Значение.

Сформировано 2026-11-11 23:00 UTC; использовано реальных ответов: 3.

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

/api/exchanges/detail?ex=binance · Реальный ответ, получен 2026-11-13 03:58:11 UTC. Длинные массивы и словари сокращены для отображения: data.dist_oi: элементов было 20; data.dist_vol: элементов было 20.

  • {
    • "success": true,
    • "data": {
      • "exchange": "binance",
      • "name": "Binance",
      • "volume_usd": 66757355043.21,
      • "oi_usd": 24415618131.95,
      • "liq_24h_long": 435450375.63,
      • "liq_24h_short": 17633087.23,
      • "liq_24h_total": 453083462.86,
      • "liq_24h_cnt": 47283,
      • "liq_source": true,
      • "contracts": 762,
      • "options_vol_usd": null,
      • "taker_fee": 0.05,
      • "maker_fee": 0.02,
      • "is_dex": false,
      • "score": 96,
      • "has_ls": true,
      • "total_assets_usd": 121135381605.44,
      • "reserve": { … 7 },
      • "dist_oi": [ … 2 ],
      • "dist_vol": [ … 2 ]
      }
    }

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

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

ПараметрыHTTPЗадержкаРезультат
ex=okx200171 msПройдено
ex=hyperliquid200176 msПройдено
—4001 msПройдено возвращает ожидаемую ошибку

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

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
30s
Пограничный микрокеш
10s
Частота обновления
тикеры — раз в 1 min; OI — раз в 5 min; резервы — раз в 6 h; кеш в памяти 30 s
Окно
скользящие 24h для объёма и ликвидаций
Источники данных
Профиль биржи, агрегированный из публичного API биржи (объём, OI, контракты), потоков ликвидаций и данных стороннего источника о резервах CEX.
Покрытие бирж
Любая собираемая площадка деривативов; резервы — только для 10 площадок, отслеживаемых по данным стороннего источника
Пагинация
нет
Единицы измерения
USD; score 1-99
Метод расчёта
score = clamp(1..99, round(log10(vol + 10) / 11.2 * 70 + log10(oi + 10) / 11 * 30))
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный

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

ДоступенПроверено: 2026-11-13 03:58:11 UTCHTTP 200964 msСхема совпадаетВозраст самой новой точки данных: 4.8h

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

Пройдено 100% из 410 проверок

Ошибки

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

Код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/exchanges/detailДоступен
Параметры

string — Exchange id (lower-cased, a-z0-9. only); 400 when missing.

URL запросаhttps://www.coinboss.com/api/exchanges/detail?ex=binance
Выберите эндпоинт и нажмите «Отправить запрос». Здесь появятся ответ, заголовки и время выполнения.