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

Матрица качества данных

Матрица биржа × семейство данных с оценками FRESH / PARTIAL / STALE / BROKEN / UNAVAILABLE, метками времени источника и получения, отставанием, покрытием и причиной каждого пропуска.

GET/api/meta/quality

Запрос

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

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
exchangestringНеобязательный——Вернуть только эту биржу (идентификатор в нижнем регистре, например `binance`).
familystringНеобязательный——Вернуть только это семейство данных (например, `oi`, `funding`, `liquidation`).

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

curl -s "https://www.coinboss.com/api/meta/quality"

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
schemastring—Идентификатор схемы этого ответа (`coinboss.meta.quality/1`).
nownumbermsВремя сервера в момент формирования ответа.
familiesarray—Семейства данных, оцениваемые по каждой бирже (тикеры, открытый интерес, финансирование, ликвидации, книги ордеров, опционы и другие).
families[]object—Одно семейство: `id`, `scope`, `title`, `what`, `table`, `cadence` и `fresh_within_s`.
families[].idstring—Идентификатор.
families[].scopestring—`exchange` для семейств, оцениваемых по каждой бирже в `matrix`.
families[].titlestring—Отображаемое название семейства.
families[].whatstring—Краткое описание данных, которые охватывает семейство.
families[].tablestring—Название внутреннего набора данных, по которому оценивается семейство; только для справки.
families[].cadencestring—Текстовое расписание сбора данных семейства; null, если не указано.
families[].fresh_within_snumbersОкно актуальности: данные новее этого значения считаются актуальными.
exchangesarray—Биржи.
exchanges[]string—Биржи.
matrixobject—Матрица с ключами по строке и столбцу. динамические ключи: aster,backpack,binance,bingx,bitfinex,bitget
matrix.{*}object—Матрица с ключами по строке и столбцу. динамические ключи: ticker,oi,funding,funding_settle,liquidation,ls
matrix.{*}.{*}object—Матрица с ключами по строке и столбцу.
matrix.{*}.{*}.statusstring—Статус.
matrix.{*}.{*}.lag_snumber|nullsТекущее время минус самая новая сохранённая метка времени данных этой биржи (первый ключ) и семейства (второй ключ); null, если семейство там недоступно.
matrix.{*}.{*}.source_atnumber|nullmsМетка времени.
matrix.{*}.{*}.fetched_atnumber|nullmsВремя, когда CoinBoss получил данные от источника.
matrix.{*}.{*}.fresh_within_snumber|nullsОкно актуальности: данные новее этого значения считаются актуальными.
matrix.{*}.{*}.coverageobject|null—Что включено и чего не хватает.
matrix.{*}.{*}.coverage.rowsnumber—Строки результата. может отсутствовать
matrix.{*}.{*}.coverage.rows_freshnumber—Строки, обновлённые в пределах окна актуальности. может отсутствовать
matrix.{*}.{*}.coverage.rows_usablenumber—Строки в пределах окна пригодности. может отсутствовать
matrix.{*}.{*}.coverage.rows_orphannumber—Строки, контракт которых больше не торгуется. может отсутствовать
matrix.{*}.{*}.coverage.rows_invalidnumber—Строки, отклонённые при валидации. может отсутствовать
matrix.{*}.{*}.reasonstring|null—Код причины.
matrix.{*}.{*}.coverage.rows_no_livenessnumbercountСтроки финансирования по контрактам без признаков реальной торговли (делистинг или отсутствие объёма); не учитываются в подсчёте актуальности. может отсутствовать
matrix.{*}.{*}.coverage.rows_unknown_intervalnumbercountНедавно обновлённые строки финансирования, у которых интервал расчётов неизвестен, поэтому их нельзя привести к 8 часам. может отсутствовать
matrix.{*}.{*}.coverage.symbolsnumber—Символы. может отсутствовать
matrix.{*}.{*}.coverage.events_1hnumbercountОрдера ликвидации, сохранённые с биржи за последний час; минимальные размеры ордеров у бирж различаются. может отсутствовать
matrix.{*}.{*}.coverage.events_24hnumbercountОрдера ликвидации, сохранённые с биржи за последние 24 часа; минимальные размеры ордеров у бирж различаются. может отсутствовать
matrix.{*}.{*}.viastring—Путь сбора. может отсутствовать
matrix.{*}.{*}.coverage.booksnumbercountЧисло отслеживаемых книг ордеров. может отсутствовать
matrix.{*}.{*}.coverage.books_freshnumbercountЧисло книг ордеров, обновлённых в пределах окна актуальности. может отсутствовать
matrix.{*}.{*}.coverage.books_reaching_2pctnumbercountЧисло книг ордеров, глубины которых хватает, чтобы покрыть ±2 % от средней цены. может отсутствовать
matrix.{*}.{*}.coverage.contractsnumber—Строки по контрактам. может отсутствовать
matrix.{*}.{*}.coverage.contracts_freshnumbercountЧисло контрактов, обновлённых в пределах окна актуальности. может отсутствовать
matrix.{*}.{*}.coverage.with_mark_and_indexnumbercountЧисло контрактов, у которых есть и цена маркировки, и индексная цена. может отсутствовать
matrix.{*}.{*}.coverage.delivery_contractsnumbercountЧисло срочных контрактов (с датой экспирации). может отсутствовать
matrix.{*}.{*}.notestring—Примечание. может отсутствовать
matrix.{*}.{*}.coverage.coinsnumber—Монеты. может отсутствовать
matrix.{*}.{*}.coverage.rows_without_oinumbercountСтроки контрактов с маржой в монете, с маржой в USDC или срочных контрактов без значения открытого интереса в USD. может отсутствовать
matrix.{*}.{*}.coverage.with_mark_ivnumbercountЧисло опционных контрактов, у которых есть подразумеваемая волатильность по цене маркировки. может отсутствовать
matrix.{*}.{*}.coverage.with_greeksnumbercountЧисло опционных контрактов, у которых есть греки. может отсутствовать
datasetsarray—Проверки качества наборов данных, не привязанных к биржам (например, спотовые ETF и дневные данные CME), каждая со статусом, задержкой, покрытием и причиной.
datasets[]object—Один общерыночный набор данных, не привязанный к отдельной бирже (опционы, спотовые ETF, CME, книги ордеров, базис).
datasets[].familystring—Идентификатор набора данных, например `etf` или `cme`.
datasets[].idstring—Идентификатор.
datasets[].titlestring—Отображаемое название набора данных.
datasets[].sourcestring—Откуда взято значение.
datasets[].endpointstring—Публичный эндпоинт, отдающий этот набор данных.
datasets[].statusstring—Статус.
datasets[].lag_snumbersВозраст самой новой точки данных на момент формирования ответа.
datasets[].source_atnumbermsМетка времени.
datasets[].fetched_atnumbermsВремя, когда CoinBoss получил данные от источника.
datasets[].fresh_within_snumbersОкно актуальности: данные новее этого значения считаются актуальными.
datasets[].coverageobject—Что включено и чего не хватает.
datasets[].coverage.funds_totalnumbercountЧисло отслеживаемых фондов. может отсутствовать
datasets[].coverage.funds_coverednumbercountЧисло фондов с пригодным раскрытием информации. может отсутствовать
datasets[].coverage.funds_unavailablenumbercountЧисло фондов, эмитент которых не публикует машиночитаемого раскрытия. может отсутствовать
datasets[].coverage.funds_failingnumbercountЧисло фондов, раскрытие которых не удалось прочитать в последнем раунде сбора. может отсутствовать
datasets[].coverage.as_ofstring—Самая поздняя дата раскрытия среди охваченных фондов (YYYY-MM-DD). может отсутствовать
datasets[].coverage.as_of_minstring—Самая ранняя дата раскрытия среди охваченных фондов (YYYY-MM-DD). может отсутствовать
datasets[].reasonstring|null—Код причины.
datasets[].coverage.contractsnumber—Строки по контрактам. может отсутствовать
datasets[].coverage.report_datestring—Дата последнего отчёта CFTC Commitments of Traders (YYYY-MM-DD). может отсутствовать
datasets[].coverage.productsnumbercountЧисло охваченных продуктов CME. может отсутствовать
datasets[].coverage.trade_datestring—Торговый день последнего дневного отчёта CME (YYYY-MM-DD). может отсутствовать
summaryobject—Блок сводки. динамические ключи: FRESH,PARTIAL,STALE,BROKEN,UNAVAILABLE
summary.{*}number—Блок сводки.
by_familyobject—Число бирж в каждом статусе по семействам. Внешние ключи — идентификаторы семейств. динамические ключи: ticker,oi,funding,funding_settle,liquidation,ls
by_family.{*}object—Число бирж по статусам для одного семейства; ключи — статусы (`FRESH`, `PARTIAL`, `STALE`, `BROKEN`, `UNAVAILABLE`). динамические ключи: FRESH,PARTIAL,STALE,BROKEN,UNAVAILABLE
by_family.{*}.{*}numbercountЧисло бирж с этим статусом для этого семейства.
alertsarray—Оповещения патруля качества данных, которые открыты или были закрыты за последние 7 дней; сначала открытые; отфильтрованы по параметрам запроса.
alerts[]object—Одно оповещение: `level`, `exchange`, `family`, `code`, `detail`, время открытия / последнего наблюдения / закрытия, `hits` и `open`.
alerts[].levelstring—Уровень.
alerts[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
alerts[].familystring—Семейство данных, к которому относится оповещение.
alerts[].codestring—Код.
alerts[].detailstring—Сведения.
alerts[].opened_atnumbermsМетка времени.
alerts[].last_seen_atnumbermsМетка времени.
alerts[].resolved_atnumber|nullmsМетка времени.
alerts[].hitsnumbercountЧисло запусков патруля (один каждые 5 минут), зафиксировавших это условие с момента открытия оповещения.
alerts[].openboolean—Цена открытия периода.
monitorobject—Состояние самого мониторинга: время и возраст последнего запуска патруля, `patrol_ok` и возраст сигнала активности сборщика.
monitor.patrol_last_run_atnumbermsМетка времени.
monitor.patrol_age_snumbersЧисло секунд с события.
monitor.patrol_okboolean—true, если патруль запускался в последние 15 минут; при false список `alerts` может быть устаревшим, а матрица остаётся актуальной.
monitor.collector_heartbeat_age_snumbersЧисло секунд с события.
errorsnull—Словарь «идентификатор семейства → код ошибки» для семейств, у которых не удалась сама проверка качества; null, если все проверки выполнены.
legendobject—Текстовое определение каждого статуса ячейки. динамические ключи: FRESH,PARTIAL,STALE,BROKEN,UNAVAILABLE
legend.{*}string—Определение статуса, заданного ключом (`FRESH`, `PARTIAL`, `STALE`, `BROKEN`, `UNAVAILABLE`).
methodobject—Примечания о формуле / методе.
method.statusstring—Статус.
method.lag_sstring—Текстовое описание того, как вычисляется `lag_s`.
method.source_atstring—Строка с датой и временем.
method.fetched_atstring—Строка с датой и временем.
metaobject—Обёртка этого ответа: идентификатор схемы, система-источник, метки времени, время жизни кеша и актуальность.
meta.schemastring—Идентификатор схемы этого ответа; то же значение, что и `schema` верхнего уровня.
meta.sourcearray—Откуда взято значение.
meta.source[]object—Откуда взято значение.
meta.source[].systemstring—Система, сформировавшая данные; для эндпоинтов центра разработчика всегда `coinboss`.
meta.source[].componentstring—Компонент, стоящий за данными: проверка эндпоинтов и патруль качества данных.
meta.observed_atnull—Метка времени.
meta.received_atnumbermsМетка времени.
meta.fetched_atnumbermsВремя, когда CoinBoss получил данные от источника.
meta.windowstring—Окно.
meta.cache_ttl_snumbersВремя жизни серверного кеша этого ответа.
meta.qualitystring—Обычно `FRESH`; `PARTIAL`, если патруль качества не запускался в течение 15 минут (затронут только список оповещений).
meta.is_staleboolean—true, если строка старше окна актуальности; устаревшие строки в итогах не используются.
meta.fallbackstring—Текстовое пояснение того, что возвращает этот эндпоинт, когда его входные данные устарели или отсутствуют.

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

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

/api/meta/quality · Реальный ответ, получен 2026-11-13 03:59:28 UTC. Длинные массивы и словари сокращены для отображения: alerts: элементов было 11; legend: элементов было 5; matrix: элементов было 30; summary: элементов было 5; datasets: элементов было 12; families: элементов было 12.

  • {
    • "success": true,
    • "schema": "coinboss.meta.quality/1",
    • "now": 1794542368785,
    • "families": [
      • { … 7 },
      • { … 7 }
      ],
    • "exchanges": [
      • "aster",
      • "backpack",
      • "binance",
      • "bingx",
      • "bitfinex",
      • "bitget",
      • "bitstamp",
      • "bitunix"
      ],
    • "matrix": {
      • "aster": { … 2 },
      • "backpack": { … 2 }
      },
    • "datasets": [
      • { … 12 },
      • { … 12 }
      ],
    • "summary": {
      • "FRESH": 161,
      • "PARTIAL": 7
      },
    • "by_family": {
      • "ticker": { … 2 },
      • "oi": { … 2 }
      },
    • "alerts": [
      • { … 10 },
      • { … 10 }
      ],
    • "monitor": {
      • "patrol_last_run_at": 1794542347666,
      • "patrol_age_s": 22,
      • "patrol_ok": true,
      • "collector_heartbeat_age_s": 18
      },
    • "errors": null,
    • "legend": {
      • "FRESH": "newest stored data point is inside the fresh window for this family",
      • "PARTIAL": "some contracts / rows are outside the fresh window or miss a required field"
      },
    • "method": {
      • "status": "judged from data timestamps in CoinBoss storage every request (30 s in-process cache); a running collector process is not treated as evidence",
      • "lag_s": "now − newest stored data timestamp for the exchange / family",
      • "source_at": "newest stored data timestamp (exchange timestamp when the exchange provides one, otherwise collector receive time)",
      • "fetched_at": "last successful upstream call recorded by the collector health log; null for WebSocket feeds and collectors that do not log per-call health"
      },
    • "meta": {
      • "schema": "coinboss.meta.quality/1",
      • "source": [ … 1 ],
      • "observed_at": null,
      • "received_at": 1794542369610,
      • "fetched_at": 1794542368785,
      • "window": "latest",
      • "cache_ttl_s": 20,
      • "quality": "FRESH",
      • "is_stale": false,
      • "fallback": "matrix is always computed from storage; when the 5-minute patrol itself stops (monitor.patrol_ok=false) only the alerts list may be outdated"
      }
    }

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

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

ПараметрыHTTPЗадержкаРезультат
exchange=binance2001 msПройдено FRESH
family=funding2001 msПройдено FRESH

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

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
20s
Пограничный микрокеш
10s
Частота обновления
Оценивается при запросе по самой новой метке времени данных каждой пары «биржа × семейство».
Источники данных
Исходные таблицы CoinBoss (метки времени последних строк), журнал состояния коллекторов. Работающий процесс никогда не считается признаком исправных данных.
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный
Доступен с
2026-11-11

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

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

Доступность за последние 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/meta/qualityДоступен
Параметры

string — Return only this exchange (lower-case id, for example `binance`).

string — Return only this data family (for example `oi`, `funding`, `liquidation`).

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