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

Рейтинг монет по глубине книги ордеров

Рейтинг монет по агрегированной глубине книги ордеров (bid + ask) в пределах одного диапазона с числом учтённых контрактов и самым узким спредом.

GET/api/sd/liquidity/rank

Запрос

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

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
marketstringНеобязательныйperpperp, spotТип рынка. Книги бессрочных контрактов и спота никогда не суммируются.
bandstringНеобязательный10.5, 1, 2Расстояние от средней цены в процентах.
limitintegerНеобязательный50≥ 1 · ≤ 200Число строк.

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

curl -s "https://www.coinboss.com/api/sd/liquidity/rank"

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
schemastring—Идентификатор схемы этого ответа. Меняется только тогда, когда у существующего поля меняется смысл или тип.
nownumbermsВремя сервера в момент формирования ответа.
marketstring—`perp` или `spot`.
band_pctnumber%Выбранный диапазон: расстояние от средней цены.
limitnumber—Применённое ограничение числа строк.
total_coinsnumber—Монеты, у которых есть хотя бы одна строка книги ордеров.
rowsarray—Одна строка на монету.
rows[]object—Одна строка на монету.
rows[].coinstring—Символ монеты (в верхнем регистре).
rows[].bid_depth_usdnumberUSDНоминал бидов, стоящих в книге между средней ценой и нижней границей диапазона. Нижняя граница, если `complete` равно false.
rows[].ask_depth_usdnumberUSDНоминал асков, стоящих в книге между средней ценой и верхней границей диапазона. Нижняя граница, если `complete` равно false.
rows[].total_depth_usdnumberUSDГлубина бидов + глубина асков в диапазоне; используется только как ключ ранжирования.
rows[].n_includednumber—Строки, включённые в сумму глубины: актуальные и полные для данного диапазона. Читайте это значение вместе со значением глубины.
rows[].n_freshnumber—Актуальные строки.
rows[].n_rowsnumber—Найденные строки, включая устаревшие.
rows[].mid_mediannumberUSDМедиана средних цен актуальных строк.
rows[].spread_bps_minnumberbpСамый узкий спред среди актуальных строк.
rows[].included_exchangesarray—Источники, актуальные данные которых учтены.
rows[].included_exchanges[]string—Источники, актуальные данные которых учтены.
rows[].uses_aggregated_bucketsboolean—True, если во включённой строке использованы интервалы, агрегированные по цене, из-за чего сумма является нижней границей.
rows[].ranknumber—Позиция в рейтинге; `null`, если у строки нет значения для ранжирования.
coverageobject—Что входит и что не входит в эти значения. Сверьтесь с этим блоком, прежде чем сравнивать итоги с другим источником.
coverage.included_exchangesarray—Источники, актуальные данные которых учтены.
coverage.included_exchanges[]string—Источники, актуальные данные которых учтены.
coverage.unavailablearray—Источники, которые не удалось включить, с указанием причины для каждого. Они никогда не учитываются как 0. пусто в образцах, по которым построена таблица
coverage.stale_excludedarray—Строки, не учтённые потому, что их последнее обновление выходит за окно актуальности.
coverage.stale_excluded[]object—Строки, не учтённые потому, что их последнее обновление выходит за окно актуальности.
coverage.stale_excluded[].exchangestring—Идентификатор биржи (в нижнем регистре).
coverage.stale_excluded[].age_snumbersЧисло секунд с момента получения строки.
coverage.n_fresh_rowsnumber—Актуальные строки по всем монетам.
coverage.n_stale_rowsnumber—Устаревшие строки по всем монетам.
coverage.n_incomplete_rowsnumber—Актуальные строки, снимок которых не достигает границы диапазона.
methodobject—Текстовое описание формул, использованных для этого ответа, по одной записи на поле.
method.bid_depth_usdstring—Пояснение к формуле для `bid_depth_usd`, обычный текст.
method.ask_depth_usdstring—Пояснение к формуле для `ask_depth_usd`, обычный текст.
method.completestring—Пояснение к формуле для `complete`, обычный текст.
method.aggregatestring—Пояснение к формуле для `aggregate`, обычный текст.
method.freshstring—Пояснение к формуле для `fresh`, обычный текст.
method.rankstring—Пояснение к формуле для `rank`, обычный текст.
metaobject—Происхождение данных и актуальность этого ответа.
meta.schemastring—Идентификатор схемы этого ответа. Меняется только тогда, когда у существующего поля меняется смысл или тип.
meta.sourcearray—Публичные эндпоинты источников, из которых собраны данные.
meta.source[]object—Публичные эндпоинты источников, из которых собраны данные.
meta.source[].exchangestring—Идентификатор биржи (в нижнем регистре).
meta.source[].marketstring—`perp` или `spot`.
meta.source[].endpointstring—Публичный эндпоинт источника, который читает коллектор (показан для сведений о происхождении данных; клиенты его не вызывают).
meta.observed_atnumbermsМетка времени, указанная источником для данных.
meta.received_atnumbermsВремя получения данных коллектором CoinBoss.
meta.fetched_atnumbermsВремя формирования этого ответа.
meta.windowstring—Временное окно, которое охватывают значения.
meta.qualitystring—FRESH, PARTIAL, STALE, BROKEN или UNAVAILABLE — оценка по меткам времени данных и покрытию.
meta.is_staleboolean—True, если данные старше своего окна актуальности.
meta.cache_ttl_snumbersВремя жизни кеша этого ответа.
meta.fallbackstring—Что возвращает эндпоинт при сбое коллектора или источника.
meta.collector_heartbeat_age_snumbersЧисло секунд с последнего сообщения коллектора о том, что он работает.

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

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

/api/sd/liquidity/rank · Реальный ответ, получен 2026-11-13 04:02:46 UTC. Длинные массивы и словари сокращены для отображения: rows: элементов было 50; meta.source: элементов было 23; coverage.stale_excluded: элементов было 23; rows[].included_exchanges: элементов было 19; coverage.included_exchanges: элементов было 23.

  • {
    • "success": true,
    • "schema": "coinboss.sd.liquidity/1",
    • "now": 1794542566023,
    • "market": "perp",
    • "band_pct": 1,
    • "limit": 50,
    • "total_coins": 89,
    • "rows": [
      • { … 12 },
      • { … 12 }
      ],
    • "coverage": {
      • "included_exchanges": [ … 8 ],
      • "unavailable": [],
      • "stale_excluded": [ … 2 ],
      • "n_fresh_rows": 1481,
      • "n_stale_rows": 82,
      • "n_incomplete_rows": 8
      },
    • "method": {
      • "bid_depth_usd": "sum of resting bid notional with price >= mid * (1 - band%), in USD; notional = price * size * contract_value (inverse contracts: size * contract_value); USDT /…",
      • "ask_depth_usd": "sum of resting ask notional with price <= mid * (1 + band%), in USD; same notional rule as bid_depth_usd",
      • "complete": "true when BOTH sides of the snapshot reach the band edge (reach_pct >= band) or the whole side of the book was returned; when false the depth values are lower b…",
      • "aggregate": "per market and band: sum over rows that are fresh AND complete for that band; n_included / n_fresh is the denominator; lower_bound_* additionally adds the incom…",
      • "fresh": "a row is fresh when now - received_at <= max(3 * period_s, 300s); stale rows are listed in coverage.stale_excluded; rows older than 24h are dropped",
      • "rank": "coins ordered by bid_depth_usd + ask_depth_usd of the chosen market and band, aggregated as in aggregate; coins with no fresh complete row carry nulls and sort …"
      },
    • "meta": {
      • "schema": "coinboss.sd.liquidity/1",
      • "source": [ … 2 ],
      • "observed_at": 1794542565862,
      • "received_at": 1794542565977,
      • "fetched_at": 1794542566023,
      • "window": "latest",
      • "quality": "PARTIAL",
      • "is_stale": false,
      • "cache_ttl_s": 30,
      • "fallback": "stale rows (older than max(3 * period_s, 300s)) are left out; coins whose rows are all stale or incomplete keep their place in the list with null depth",
      • "collector_heartbeat_age_s": 4
      }
    }

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

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

ПараметрыHTTPЗадержкаРезультат
market=spot2005 msПройдено PARTIAL
band=0.5&limit=102007 msПройдено PARTIAL
limit=04002 msПройдено возвращает ожидаемую ошибку

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

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
30s
Пограничный микрокеш
10s
Частота обновления
Тот же цикл сбора, что и у `/api/sd/liquidity`.
Окно
Последний снимок по каждому контракту.
Источники данных
Публичные REST-снимки книги ордеров 24 бирж (рынки бессрочных контрактов и спот), которые собирает и хранит CoinBoss (sd_book_latest, sd_book_hist). Глубину и проскальзывание CoinBoss рассчитывает по исходным ценовым уровням.
Покрытие бирж
24 биржи, 38 связок «биржа × рынок». Если публичный снимок не достигает ±0.5 / 1 / 2 % от средней цены (ограничение площадки на число уровней), такой диапазон помечается `complete: false`, его значение является нижней границей и в агрегат не входит; `n_included` / `n_fresh` дают знаменатель, а `excluded_incomplete` перечисляет исключённое.
Пагинация
Пагинации нет; `limit` ограничивает число строк (макс. 200).
Сортировка
По убыванию `total_depth_usd`; монеты без единой полной актуальной строки идут последними с `rank: null`.
Единицы измерения
Depth in USD notional, bid and ask side reported separately and never added. Spread and slippage in basis points (1 bp = 0.01 %). USDT / USDC / USD quotes are counted 1:1 as USD.
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный
Доступен с
2026-11-11

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

ЧастичноПроверено: 2026-11-13 04:02:46 UTCHTTP 2009 msСхема совпадаетВозраст самой новой точки данных: 0s

Эндпоинт сообщает качество данных PARTIAL

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

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

Ошибки

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

Код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/sd/liquidity/rankЧастично
Параметры

string · по умолчанию perp — Market type. Perpetual and spot books are never added together.

string · по умолчанию 1 — Distance from mid price in percent.

integer · по умолчанию 50 · мин. 1 · макс. 200 — Number of rows.

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