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

Обзор ликвидаций бессрочных контрактов TradFi

Обзор ликвидаций бессрочных контрактов TradFi (акции / индексы / сырьё / валюты)

GET/api/liquidations/tradfi

Запрос

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

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
rangestringНеобязательный24h1h, 4h, 12h, 24hВременное окно. Пример: 24h
classstringНеобязательныйstockstock, index, commodity, forexКласс активов; неизвестное значение возвращает 400. Пример: stock
limitintegerНеобязательный30≤ 100Число возвращаемых строк.

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

curl -s "https://www.coinboss.com/api/liquidations/tradfi?class=stock&range=24h"

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
rangestring—Запрошенное окно.
classstring—Класс актива.
overviewobject—Блок обзора.
overview.long_usdnumberUSDСторона лонг.
overview.short_usdnumberUSDСторона шорт.
overview.total_usdnumberUSDВсего.
overview.cntnumber—Количество.
byClassobject—Итоги ликвидаций по классам активов за запрошенный `range`; охватывают все некриптовалютные классы независимо от фильтра `class`. динамические ключи: stock,commodity,index,unknown,forex
byClass.{*}object—Итоги по одному классу активов; ключи — названия классов (`stock`, `commodity`, `index`, `forex`, `unknown`), в каждом — `total_usd` и `cnt`.
byClass.{*}.total_usdnumberUSDВсего.
byClass.{*}.cntnumber—Количество.
assetsarray—Активы.
assets[]object—Активы.
assets[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
assets[].dexnull—Децентрализованная площадка (деплоер HIP-3 или идентификатор DEX).
assets[].dexesarray—Децентрализованные площадки. пусто в образцах, по которым построена таблица
assets[].dexes[]string—Децентрализованные площадки.
assets[].merged_fromarray—Источники, объединённые в этой строке.
assets[].merged_from[]string—Источники, объединённые в этой строке.
assets[].display_namestring|null—Отображаемое название.
assets[].long_usdnumberUSDСторона лонг.
assets[].short_usdnumberUSDСторона шорт.
assets[].total_usdnumberUSDВсего.
assets[].cntnumber—Количество.
largestarray—Крупнейшие записи.
largest[]object—Крупнейшие записи.
largest[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
largest[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
largest[].src_symbolstring—Символ в источнике.
largest[].raw_symbolstring—Символ в точности так, как его записывает биржа.
largest[].dexstring|null—Децентрализованная площадка (деплоер HIP-3 или идентификатор DEX).
largest[].sidestring—Сторона ликвидированной позиции (`long` = был ликвидирован лонг).
largest[].pricestring(decimal)—Последняя цена в валюте котировки (USD или USDT, если не указано иное).
largest[].qtystring(decimal)—Количество.
largest[].value_usdstring(decimal)USDНоминал ликвидации.
largest[].timestampnumbermsМетка времени.
largest[].liq_userstring|null—Адрес ликвидированного счёта; доступен только для ончейн-ликвидаций Hyperliquid, для остальных бирж — null.
chartarray—Ряды графика.
chart[]object—Ряды графика.
chart[].bucketnumbermsНачало временного интервала.
chart[].sidestring—Сторона ликвидированной позиции (`long` = был ликвидирован лонг).
chart[].total_usdnumberUSDВсего.
sourcesarray—Источники данных.
sources[]object—Источники данных.
sources[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
sources[].dexstring|null—Децентрализованная площадка (деплоер HIP-3 или идентификатор DEX).
sources[].total_usdnumberUSDВсего.
sources[].cntnumber—Количество.

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

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

/api/liquidations/tradfi?class=stock&range=24h · Реальный ответ, получен 2026-11-13 03:58:42 UTC. Длинные массивы и словари сокращены для отображения: chart: элементов было 48; assets: элементов было 30; byClass: элементов было 5; largest: элементов было 10; sources: элементов было 11.

  • {
    • "success": true,
    • "range": "24h",
    • "class": "stock",
    • "overview": {
      • "long_usd": 57063780.89,
      • "short_usd": 35281288.2,
      • "total_usd": 92345069.09,
      • "cnt": 20306
      },
    • "byClass": {
      • "stock": { … 2 },
      • "commodity": { … 2 }
      },
    • "assets": [
      • { … 9 },
      • { … 9 }
      ],
    • "largest": [
      • { … 11 },
      • { … 11 }
      ],
    • "chart": [
      • { … 3 },
      • { … 3 }
      ],
    • "sources": [
      • { … 4 },
      • { … 4 }
      ]
    }

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
20s
Пограничный микрокеш
10s
Частота обновления
в реальном времени (push по WebSocket бирж); опрос REST: okx — раз в 15 s, gate — раз в 25 s, htx — раз в 5 min; пакеты исполнений с узла hyperliquid загружаются раз в 5 s
Окно
параметр range: 1h | 4h | 12h | 24h (по умолчанию 24h); шаг графика 15 min при range <= 4 h, иначе 1 h
Источники данных
Ликвидации бессрочных контрактов на некриптовалютные активы (токенизированные акции, индексы, сырьевые товары, валюты), фиксируемые теми же собственными коллекторами биржевых ликвидаций на 10 площадках (например, binance, okx, hyperliquid, gate, bybit, bitget) и выделяемые классификатором классов активов.
Покрытие бирж
10 площадок, наблюдавшихся за последние 30 дней (binance, okx, hyperliquid, gate, bybit, bitget, lighter, aster, htx, bitfinex); классы активов stock / index / commodity / forex (небольшая доля классифицирована как 'unknown'); история начинается с 2026-06-17
Пагинация
limit для списка активов (по умолчанию 30, макс. 100)
Сортировка
активы — по убыванию total_usd
Единицы измерения
USD notional (price x quantity) per liquidation order; timestamps in Unix ms; side LONG = long position liquidated, SHORT = short position liquidated
Метод расчёта
overview / byClass / per-asset totals = SUM(value_usd) by side; 10 largest orders; per-source (exchange) totals
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный

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

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

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

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

Ошибки

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

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

string · по умолчанию 24h — Time window.

string · по умолчанию stock — Asset class; unknown value returns 400.

integer · по умолчанию 30 · макс. 100 — Number of rows to return.

URL запросаhttps://www.coinboss.com/api/liquidations/tradfi?range=24h&class=stock
Выберите эндпоинт и нажмите «Отправить запрос». Здесь появятся ответ, заголовки и время выполнения.