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

Рейтинг монет по базису

Рейтинг монет по медианному межбиржевому базису; дополнительно приводятся среднее значение, базис, взвешенный по OI, открытый интерес и биржи с минимальным и максимальным значением.

GET/api/sd/basis/rank
Деградация. Эндпоинт сообщает качество данных STALE

Запрос

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

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
kindstringНеобязательныйperpperp, spot_perp`perp`: цена маркировки относительно индексной цены той же биржи. `spot_perp`: цена бессрочного контракта относительно спотовой цены той же биржи.
sortstringНеобязательныйbasis_descbasis_desc, basis_asc, abs_descКлюч сортировки: сначала наибольший, наименьший или наибольший по модулю медианный базис.
limitintegerНеобязательный50≥ 1 · ≤ 200Число строк.
min_exchangesintegerНеобязательный3≥ 1 · ≤ 20Только монеты, у которых базис есть как минимум на указанном числе бирж.

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

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

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
schemastring—Идентификатор схемы этого ответа. Меняется только тогда, когда у существующего поля меняется смысл или тип.
nownumbermsВремя сервера в момент формирования ответа.
kindstring—`perp` или `spot_perp`.
sortstring—Применённый порядок сортировки.
limitnumber—Применённое ограничение числа строк.
min_exchangesnumber—Применённое минимальное число бирж.
totalnumber—Число строк, доступных до применения `limit`.
countnumber—Возвращённые строки.
dataarray—Одна строка на монету.
data[]object—Одна строка на монету.
data[].ranknumber—Позиция в рейтинге; `null`, если у строки нет значения для ранжирования.
data[].coinstring—Символ монеты (в верхнем регистре).
data[].basis_pctnumber%(mark − index) ÷ index × 100 для бессрочных и срочных контрактов; в рейтингах — медиана по биржам.
data[].mean_pctnumber%Простое среднее по тому же набору, что и медиана.
data[].oi_weighted_pctnumber%Базис, взвешенный по открытому интересу; строки без веса OI не учитываются.
data[].oi_usdnumberUSDОткрытый интерес контракта, односторонний; используется как вес.
data[].n_exchangesnumber—Биржи в агрегате.
data[].n_contractsnumber—Контракты в агрегате.
data[].minobject—Биржа и контракт с наименьшим базисом.
data[].min.exchangestring—Идентификатор биржи (в нижнем регистре).
data[].min.symbolstring—Символ контракта в формате хранения CoinBoss.
data[].min.basis_pctnumber%(mark − index) ÷ index × 100 для бессрочных и срочных контрактов; в рейтингах — медиана по биржам.
data[].maxobject—Биржа и контракт с наибольшим базисом.
data[].max.exchangestring—Идентификатор биржи (в нижнем регистре).
data[].max.symbolstring—Символ контракта в формате хранения CoinBoss.
data[].max.basis_pctnumber%(mark − index) ÷ index × 100 для бессрочных и срочных контрактов; в рейтингах — медиана по биржам.
coverageobject—Что входит и что не входит в эти значения. Сверьтесь с этим блоком, прежде чем сравнивать итоги с другим источником.
coverage.included_exchangesarray—Источники, актуальные данные которых учтены.
coverage.included_exchanges[]string—Источники, актуальные данные которых учтены.
coverage.unavailablearray—Источники, которые не удалось включить, с указанием причины для каждого. Они никогда не учитываются как 0.
coverage.unavailable[]object—Источники, которые не удалось включить, с указанием причины для каждого. Они никогда не учитываются как 0.
coverage.unavailable[].exchangestring—Идентификатор биржи (в нижнем регистре).
coverage.unavailable[].reasonstring—Машиночитаемый код причины.
coverage.unavailable[].detailstring—Понятное человеку объяснение причины.
coverage.stale_excludedarray—Строки, не учтённые потому, что их последнее обновление выходит за окно актуальности. пусто в образцах, по которым построена таблица
methodobject—Текстовое описание формул, использованных для этого ответа, по одной записи на поле.
method.basis_pctstring—Пояснение к формуле для `basis_pct`, обычный текст.
method.oi_weighted_pctstring—Пояснение к формуле для `oi_weighted_pct`, обычный текст.
method.inclusionstring—Пояснение к формуле для `inclusion`, обычный текст.
method.coinstring—Пояснение к формуле для `coin`, обычный текст.
metaobject—Происхождение данных и актуальность этого ответа.
meta.schemastring—Идентификатор схемы этого ответа. Меняется только тогда, когда у существующего поля меняется смысл или тип.
meta.sourcearray—Публичные эндпоинты источников, из которых собраны данные.
meta.source[]object—Публичные эндпоинты источников, из которых собраны данные.
meta.source[].exchangestring—Идентификатор биржи (в нижнем регистре).
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/basis/rank · Реальный ответ, получен 2026-11-13 03:58:08 UTC. Длинные массивы и словари сокращены для отображения: coverage.stale_excluded: элементов было 21.

  • {
    • "success": true,
    • "schema": "coinboss.sd.basis/1",
    • "now": 1794542288498,
    • "kind": "perp",
    • "sort": "basis_desc",
    • "limit": 50,
    • "min_exchanges": 3,
    • "total": null,
    • "count": null,
    • "data": null,
    • "coverage": {
      • "included_exchanges": [],
      • "unavailable": [],
      • "stale_excluded": [ … 2 ]
      },
    • "method": {
      • "basis_pct": "median over exchanges (one primary contract per exchange) of the perpetual mark-vs-index basis, percent; the ranking key",
      • "oi_weighted_pct": "OI-weighted mean over all included contracts of the coin (single-sided OI, <= 3 h old); null when no contract has a weight",
      • "inclusion": "fresh rows only (<= 180 s); same row filters as /api/sd/basis; catalogued stock/ETF perpetuals (stock_contracts) are removed; coins quoted on fewer than min_exc…",
      • "coin": "multiplier contracts are folded into the underlying coin (1000PEPE, kPEPE -> PEPE)"
      },
    • "meta": {
      • "schema": "coinboss.sd.basis/1",
      • "source": [],
      • "observed_at": null,
      • "received_at": null,
      • "fetched_at": 1794542288498,
      • "window": "latest",
      • "quality": "STALE",
      • "is_stale": true,
      • "cache_ttl_s": 30,
      • "fallback": "only rows refreshed within 180 s are ranked; when the collector is down the list is empty and quality is STALE",
      • "collector_heartbeat_age_s": 3091
      }
    }

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

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

ПараметрыHTTPЗадержкаРезультат
kind=spot_perp2002 msПройдено STALE
sort=basis_asc&limit=102002 msПройдено STALE
sort=zzz4002 msПройдено возвращает ожидаемую ошибку

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

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
30s
Пограничный микрокеш
10s
Частота обновления
Цикл коллектора — каждые 60 секунд; строка считается актуальной 180 секунд. Историю формируют почасовые снимки.
Окно
Последнее значение по каждому контракту.
Источники данных
Цена маркировки, индексная цена и последняя цена, публикуемые 21 биржей деривативов, а также спотовая цена той же биржи; данные собирает и хранит CoinBoss (sd_px_latest, sd_px_hourly).
Покрытие бирж
21 биржа. Биржи, не публикующие индексную цену или цену маркировки, перечислены в `coverage.unavailable`; строки, у которых две ценовые составляющие разнесены более чем на 60 секунд, возвращают `null`. Строки, не включённые в агрегат, перечислены в `coverage.excluded_from_aggregate` с указанием причины.
Пагинация
Пагинации нет; `limit` ограничивает число строк (макс. 200).
Сортировка
Задаётся параметром `sort`; ключ сортировки — медиана по биржам (`basis_pct`).
Единицы измерения
All basis values in percent. Prices in the quote currency of the contract (USDT / USDC / USD). `oi_usd` single-sided.
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный
Доступен с
2026-11-11

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

ДеградацияПроверено: 2026-11-13 03:58:08 UTCHTTP 20023 msСхема совпадает

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

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

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

Расхождение схемы, обнаруженное последней автопроверкой
  • Возвращается, но не документировано: coverage.stale_excluded[], coverage.stale_excluded[].exchange, coverage.stale_excluded[].age_s

Ошибки

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

Код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/basis/rankДеградация
Параметры

string · по умолчанию perp — `perp`: mark price against the index price of the same exchange. `spot_perp`: perpetual price against the spot price of the same exchange.

string · по умолчанию basis_desc — Sort key: highest, lowest or largest absolute median basis first.

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

integer · по умолчанию 3 · мин. 1 · макс. 20 — Only coins with a basis on at least this many exchanges.

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