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

Сводный пакет по монете одним запросом (OI, финансирование, ликвидации, объём, лонг/шорт)

Собственный слой данных: сводный пакет по монете одним запросом (OI / финансирование / ликвидации / объём / лонг-шорт, изоляция сбоев по блокам)

GET/api/sd/coin

Запрос

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

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
coinstringОбязательный——Символ монеты; 400, если не указан. Псевдоним: `base`. Пример: BTC

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

curl -s "https://www.coinboss.com/api/sd/coin?coin=BTC"

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
coinstring—Символ монеты в верхнем регистре (например, BTC).
nownumbermsВремя сервера в момент формирования ответа.
oiobject—Тот же объект, что возвращает `/api/sd/oi` для этой монеты.
oi.coinstring—Символ монеты в верхнем регистре (например, BTC).
oi.nownumbermsВремя сервера в момент формирования ответа.
oi.total_usdnumberUSDОткрытый интерес по всем учтённым биржам и контрактам в том виде, в каком его сообщает каждая биржа (номинал в USD).
oi.n_exchangesnumber—Число бирж в итоге.
oi.n_contractsnumber—Число контрактов в итоге.
oi.asofnumbermsСамое позднее время обновления среди учтённых строк.
oi.total_usd_single_adjustednumberUSD`total_usd`, в котором значения бирж, сообщающих обе стороны (`double_sided.exchanges`), уменьшены вдвое, так что каждая площадка учитывается по одной стороне.
oi.double_sidedobject—Биржи, о которых известно, что они публикуют открытый интерес лонг + шорт одним числом.
oi.double_sided.exchangesarray—Биржи.
oi.double_sided.exchanges[]string—Биржи.
oi.double_sided.oi_usdnumberUSDОткрытый интерес этих бирж в том виде, в каком он сообщён, до деления пополам.
oi.by_kindobject—Разбивка на линейные / инверсные.
oi.by_kind.linear_usdnumberUSDОткрытый интерес линейных контрактов (маржа и расчёты в стейблкоине или USD).
oi.by_kind.inverse_usdnumberUSDОткрытый интерес инверсных контрактов (с маржой в монете), пересчитанный в USD по цене контракта.
oi.by_marginobject—Разбивка по валюте маржи.
oi.by_margin.othernumberUSDПрочие валюты маржи (например, площадки с расчётами в USD, такие как CME).
oi.by_margin.usdtnumberUSDКонтракты с маржой в USDT.
oi.by_margin.usdcnumberUSDКонтракты с маржой в USDC. может отсутствовать
oi.by_margin.coinnumberUSDКонтракты с маржой в монете. может отсутствовать
oi.by_contract_typeobject—Разбивка на бессрочные / срочные.
oi.by_contract_type.perpetual_usdnumberUSDБессрочные контракты.
oi.by_contract_type.delivery_usdnumberUSDСрочные фьючерсы (поставочные контракты).
oi.changeobject—Изменение открытого интереса за 1h / 4h / 24h, рассчитанное по одному и тому же набору контрактов на обоих концах. динамические ключи: h1,h4,h24
oi.change.{*}object—Изменение за указанный период.
oi.change.{*}.pctnumber%Изменение в процентах между `prev` и `cur`.
oi.change.{*}.curnumberUSDТекущая сумма по сопоставленным контрактам.
oi.change.{*}.prevnumberUSDСумма по тем же контрактам на момент `prev_ts`.
oi.change.{*}.n_matchednumber—Контракты (или биржи), присутствующие на обоих концах.
oi.change.{*}.n_totalnumber—Контракты (или биржи), присутствующие сейчас.
oi.change.{*}.matched_share_pctnumber%Доля текущего открытого интереса, покрытая сопоставленным набором. может отсутствовать
oi.change.{*}.prev_tsnumbermsВремя базового снимка.
oi.change.{*}.span_minnumberminФактический интервал между базовым снимком и текущим моментом.
oi.change.{*}.basisstring—Из какого ряда снимков взят базовый снимок.
oi.change.{*}.frozen_excludedobject—Строки, не учтённые в изменении, поскольку их значение не менялось между двумя снимками (источник не обновляется). может отсутствовать
oi.change.{*}.frozen_excluded.n_baselinenumber—Элементы в базовом снимке. может отсутствовать
oi.change.{*}.frozen_excluded.n_currentnumber—Элементы в текущем снимке. может отсутствовать
oi.change.{*}.frozen_excluded.cur_usdnumberUSDТекущее значение. может отсутствовать
oi.change.{*}.frozen_excluded.prev_usdnumberUSDБазовое значение. может отсутствовать
oi.by_exchangearray—Разбивка по биржам.
oi.by_exchange[]object—Разбивка по биржам.
oi.by_exchange[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
oi.by_exchange[].oi_usdnumberUSDОткрытый интерес (номинал в USD).
oi.by_exchange[].share_pctnumber%Доля в общем значении.
oi.by_exchange[].n_contractsnumber—Число контрактов.
oi.by_exchange[].linear_usdnumberUSDЛинейные контракты.
oi.by_exchange[].inverse_usdnumberUSDИнверсные контракты (с маржой в монете).
oi.by_exchange[].perpetual_usdnumberUSDБессрочные контракты.
oi.by_exchange[].delivery_usdnumberUSDСрочные контракты.
oi.by_exchange[].oi_sidestring—`double`, если биржа сообщает обе стороны одним числом, `single`, если одну сторону, `unstated`, если биржа этого не документирует.
oi.by_exchange[].oi_usd_single_adjustednumber|nullUSDОдносторонний эквивалент; null, если соглашение об учёте сторон не указано.
oi.by_exchange[].updated_atnumbermsВремя последнего обновления этой строки.
oi.by_exchange[].age_snumbersЧисло секунд с последнего обновления этой строки.
oi.by_exchange[].is_staleboolean—true, если строка старше окна актуальности; устаревшие строки в итогах не используются.
oi.contractsarray—Строки по контрактам.
oi.contracts[]object—Строки по контрактам.
oi.contracts[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
oi.contracts[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
oi.contracts[].native_symbolstring|null—Символ в точности так, как его записывает биржа.
oi.contracts[].oi_usdnumberUSDОткрытый интерес (номинал в USD).
oi.contracts[].oi_sidestring—`double`, `single` или `unstated`: сообщает ли биржа обе стороны открытого интереса одним числом.
oi.contracts[].oi_usd_singlenumber|nullUSDОдносторонний эквивалент `oi_usd`; null, если соглашение об учёте сторон не указано.
oi.contracts[].marginstring—Класс валюты маржи: `usdt`, `usdc`, `coin` или `other`.
oi.contracts[].kindstring—`linear` или `inverse`.
oi.contracts[].contract_typestring—`perpetual` или `delivery`.
oi.contracts[].expiry_tsnumber|nullmsДата экспирации срочного контракта; null для бессрочных контрактов или если она не опубликована.
oi.contracts[].margin_basisstring—Как определён класс маржи (по спецификации контракта или по умолчанию для площадки).
oi.contracts[].updated_atnumbermsВремя последнего обновления этой строки.
oi.contracts[].age_snumbersЧисло секунд с последнего обновления этой строки.
oi.contracts[].is_staleboolean—true, если строка старше окна актуальности; устаревшие строки в итогах не используются.
oi.contracts[].collectorstring—Внутренний коллектор, сформировавший строку.
oi.contracts[].included_sincenumber|nullmsКогда этот контракт вошёл в итоги; null для базового набора.
oi.coverageobject—Что входит и что не входит в приведённые выше значения. Сверьтесь с этим блоком, прежде чем сравнивать итоги с другим источником.
oi.coverage.included_exchangesarray—Биржи, данные которых учтены в итогах.
oi.coverage.included_exchanges[]string—Биржи, учтённые в итогах.
oi.coverage.pendingarray—Контракты, которые уже собираются, но ещё не включены в итоги (например, пока накапливается их собственная 25-часовая история). Приводятся с текущим значением, чтобы расхождение было видно.
oi.coverage.pending[]object—Элементы, которые собираются, но ещё не включены.
oi.coverage.pending[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
oi.coverage.pending[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
oi.coverage.pending[].native_symbolstring—Символ в точности так, как его записывает биржа.
oi.coverage.pending[].marginstring—Класс валюты маржи.
oi.coverage.pending[].contract_typestring—`perpetual` или `delivery`.
oi.coverage.pending[].oi_usdnumberUSDОткрытый интерес (номинал в USD).
oi.coverage.pending[].age_snumbersЧисло секунд с последнего обновления этой строки.
oi.coverage.pending[].reasonstring—Код причины.
oi.coverage.pending[].detailstring|null—Сведения.
oi.coverage.pending_usdnumber|nullUSDСумма по ожидающим контрактам; в `total_usd` не входит.
oi.coverage.stale_excludedarray—Строки, не учтённые потому, что их последнее обновление выходит за окно пригодности. пусто в образцах, по которым построена таблица
oi.coverage.unavailablearray—Пары «биржа / контракт», которые не удалось включить, с указанием причины для каждой. Они никогда не учитываются как 0.
oi.coverage.unavailable[]object—Элементы, по которым нет данных, с указанием причин. Никогда не сообщаются как 0.
oi.coverage.unavailable[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
oi.coverage.unavailable[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
oi.coverage.unavailable[].native_symbolstring—Символ в точности так, как его записывает биржа.
oi.coverage.unavailable[].marginstring—Класс валюты маржи.
oi.coverage.unavailable[].contract_typestring—`perpetual` или `delivery`.
oi.coverage.unavailable[].reasonstring—Код причины.
oi.coverage.unavailable[].detailstring—Сведения.
oi.methodobject—Текстовое описание формул, использованных для этого ответа.
oi.method.totalstring—Всего.
oi.method.usdstringUSDЗначение.
oi.method.change_h1_h4string—Текстовое определение изменений открытого интереса за 1h и 4h: каждый контракт сравнивается с собственным снимком, ближайшим к началу окна.
oi.method.change_h24string—Текстовое определение изменения открытого интереса за 24h: сопоставление в пределах одной биржи с почасовым снимком, ближайшим к моменту 24 часа назад; застывшие базы сравнения исключаются.
oi.method.oi_sidestring—`double`, `single` или `unstated`: сообщает ли биржа обе стороны открытого интереса одним числом.
fundingobject—Тот же объект, что возвращает `/api/sd/funding` для этой монеты.
funding.coinstring—Символ монеты в верхнем регистре (например, BTC).
funding.nownumbermsВремя сервера в момент формирования ответа.
funding.unitstring—Единица всех полей ставок в этом ответе: `fraction` (0.0001 = 0.01 %).
funding.avg_8hnumberfraction per 8hПростое среднее ставок, приведённых к 8h, по одному контракту на биржу.
funding.oi_weighted_8hnumberfraction per 8hСреднее ставок, приведённых к 8h, взвешенное по открытому интересу.
funding.apr_pctnumber% per yearПростой пересчёт в годовое выражение: ставка за 8h × 3 × 365 × 100.
funding.apr_basisstring—На каком агрегате основано главное значение `apr_pct`.
funding.n_exchangesnumber—Число учтённых бирж.
funding.n_normalizednumber—Биржи, интервал финансирования которых известен и ставки которых удалось привести к 8h.
funding.n_unknown_intervalnumber—Биржи, не учтённые в агрегатах, поскольку их интервал финансирования неизвестен.
funding.settled_cum_7dobject—Сумма фактически рассчитанных ставок финансирования за последние 7 дней, усреднённая по биржам с историей расчётов.
funding.settled_cum_7d.avgnumberfractionПростое среднее по биржам.
funding.settled_cum_7d.oi_weightednumberfractionСреднее, взвешенное по открытому интересу.
funding.settled_cum_7d.nnumber—Биржи с полным окном.
funding.settled_cum_30dobject—То же за 30 дней.
funding.settled_cum_30d.avgnumberfractionПростое среднее по биржам.
funding.settled_cum_30d.oi_weightednumberfractionСреднее, взвешенное по открытому интересу.
funding.settled_cum_30d.nnumber—Биржи с полным окном.
funding.by_exchangearray—Одна строка на биржу: её основной контракт по этой монете (с наибольшим открытым интересом).
funding.by_exchange[]object—Разбивка по биржам.
funding.by_exchange[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
funding.by_exchange[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
funding.by_exchange[].marginstring—Класс валюты маржи.
funding.by_exchange[].kindstring—Вид.
funding.by_exchange[].primaryboolean—True для контракта, представляющего свою биржу в агрегатах (контракт с наибольшим открытым интересом); в этом списке всегда true.
funding.by_exchange[].ratenumber—Ставка.
funding.by_exchange[].interval_hnumberhИнтервал.
funding.by_exchange[].rate_8hnumber—Ставка, приведённая к 8-часовому периоду.
funding.by_exchange[].apr_pctnumber% per yearЗначение в процентах годовых.
funding.by_exchange[].next_funding_timenumber|nullmsМетка времени.
funding.by_exchange[].next_derivedboolean—True, если биржа не опубликовала `next_funding_time` и оно принято равным началу следующего полного часа UTC (только для площадок с ежечасными расчётами).
funding.by_exchange[].predicted_ratenull—Ориентировочная ставка следующего периода; null, если она не публикуется.
funding.by_exchange[].oi_usdnumber|nullUSDОткрытый интерес (номинал в USD).
funding.by_exchange[].updated_atnumbermsВремя последнего обновления этой строки.
funding.by_exchange[].age_snumbersЧисло секунд с последнего обновления этой строки.
funding.by_exchange[].is_staleboolean—true, если строка старше окна актуальности; устаревшие строки в итогах не используются.
funding.by_exchange[].settledobject|null—Записи фактических расчётов; null, если публичной истории нет.
funding.by_exchange[].settled.last_ratenumberfractionСтавка финансирования, фактически применённая при последнем расчёте (`last_time`), из истории финансирования биржи (0.0001 = 0.01 %). может отсутствовать
funding.by_exchange[].settled.last_timenumbermsМетка времени. может отсутствовать
funding.by_exchange[].settled.interval_hnumberhИнтервал. может отсутствовать
funding.by_exchange[].settled.cum_7dnumberfractionСумма ставок финансирования, по которым прошли расчёты по этому контракту за последние 7 дней (0.0015 = 0.15 %); null, если расчётов не зафиксировано. может отсутствовать
funding.by_exchange[].settled.n_7dnumbercountЧисло записей о расчётах, собранных за последние 7 дней. может отсутствовать
funding.by_exchange[].settled.n_7d_expectednumbercountСколько расчётов должно быть в полном 7-дневном окне: 168 ÷ интервал расчётов в часах; null, если интервал неизвестен. может отсутствовать
funding.by_exchange[].settled.cum_7d_completeboolean—True, если история охватывает начало 7-дневного окна и содержит не менее 90 % ожидаемых расчётов. может отсутствовать
funding.by_exchange[].settled.cum_30dnumberfractionСумма ставок финансирования, по которым прошли расчёты по этому контракту за последние 30 дней (0.006 = 0.6 %). может отсутствовать
funding.by_exchange[].settled.n_30dnumbercountЧисло записей о расчётах, собранных за последние 30 дней. может отсутствовать
funding.by_exchange[].settled.n_30d_expectednumbercountСколько расчётов должно быть в полном 30-дневном окне: 720 ÷ интервал расчётов в часах; null, если интервал неизвестен. может отсутствовать
funding.by_exchange[].settled.cum_30d_completeboolean—True, если история охватывает начало 30-дневного окна и содержит не менее 90 % ожидаемых расчётов. может отсутствовать
funding.by_exchange[].settled.history_fromnumbermsСамая ранняя из хранимых записей. может отсутствовать
funding.other_contractsarray—Другие контракты той же монеты (USDC, с маржой в монете, …). В агрегаты не входят.
funding.other_contracts[]object—Один дополнительный контракт биржи с финансированием (с маржой в монете, в USDC, …), который не является её основным контрактом и исключён из агрегатов.
funding.other_contracts[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
funding.other_contracts[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
funding.other_contracts[].marginstring—Класс валюты маржи.
funding.other_contracts[].kindstring—Вид.
funding.other_contracts[].primaryboolean—False для каждой строки этого списка: контракт не является тем, который представляет свою биржу в агрегатах.
funding.other_contracts[].ratenumber—Ставка.
funding.other_contracts[].interval_hnumber|nullhИнтервал.
funding.other_contracts[].rate_8hnumber|null—Ставка, приведённая к 8-часовому периоду.
funding.other_contracts[].apr_pctnumber|null% per yearЗначение в процентах годовых.
funding.other_contracts[].next_funding_timenumber|nullmsМетка времени.
funding.other_contracts[].next_derivedboolean—True, если биржа не опубликовала `next_funding_time` и оно принято равным началу следующего полного часа UTC (только для площадок с ежечасными расчётами).
funding.other_contracts[].predicted_ratenumber|null—Ориентировочная ставка следующего периода; null, если она не публикуется.
funding.other_contracts[].oi_usdnumber|nullUSDОткрытый интерес (номинал в USD).
funding.other_contracts[].updated_atnumbermsВремя последнего обновления этой строки.
funding.other_contracts[].age_snumbersЧисло секунд с последнего обновления этой строки.
funding.other_contracts[].is_staleboolean—true, если строка старше окна актуальности; устаревшие строки в итогах не используются.
funding.other_contracts[].settledobject|null—Записи фактических расчётов; null, если публичной истории нет.
funding.other_contracts[].settled.last_ratenumberfractionСтавка финансирования, фактически применённая при последнем расчёте (`last_time`), из истории финансирования биржи (0.0001 = 0.01 %). может отсутствовать
funding.other_contracts[].settled.last_timenumbermsМетка времени. может отсутствовать
funding.other_contracts[].settled.interval_hnumberhИнтервал. может отсутствовать
funding.other_contracts[].settled.cum_7dnumberfractionСумма ставок финансирования, по которым прошли расчёты по этому контракту за последние 7 дней (0.0015 = 0.15 %); null, если расчётов не зафиксировано. может отсутствовать
funding.other_contracts[].settled.n_7dnumbercountЧисло записей о расчётах, собранных за последние 7 дней. может отсутствовать
funding.other_contracts[].settled.n_7d_expectednumbercountСколько расчётов должно быть в полном 7-дневном окне: 168 ÷ интервал расчётов в часах; null, если интервал неизвестен. может отсутствовать
funding.other_contracts[].settled.cum_7d_completeboolean—True, если история охватывает начало 7-дневного окна и содержит не менее 90 % ожидаемых расчётов. может отсутствовать
funding.other_contracts[].settled.cum_30dnumberfractionСумма ставок финансирования, по которым прошли расчёты по этому контракту за последние 30 дней (0.006 = 0.6 %). может отсутствовать
funding.other_contracts[].settled.n_30dnumbercountЧисло записей о расчётах, собранных за последние 30 дней. может отсутствовать
funding.other_contracts[].settled.n_30d_expectednumbercountСколько расчётов должно быть в полном 30-дневном окне: 720 ÷ интервал расчётов в часах; null, если интервал неизвестен. может отсутствовать
funding.other_contracts[].settled.cum_30d_completeboolean—True, если история охватывает начало 30-дневного окна и содержит не менее 90 % ожидаемых расчётов. может отсутствовать
funding.other_contracts[].settled.history_fromnumbermsСамая ранняя из хранимых записей. может отсутствовать
funding.coverageobject—Что входит и что не входит в приведённые выше значения. Сверьтесь с этим блоком, прежде чем сравнивать итоги с другим источником.
funding.coverage.settle_history_exchangesarray—Биржи, по которым собираются записи фактических расчётов.
funding.coverage.settle_history_exchanges[]string—Идентификатор биржи, по которой для этой монеты собираются записи о фактических расчётах финансирования.
funding.coverage.no_settle_historyarray—Биржи без публичного источника истории расчётов; их `settled` равно null.
funding.coverage.no_settle_history[]string—Идентификатор биржи основного контракта, по которому история расчётов не собрана, поэтому его блок `settled` равен null.
funding.coverage.unknown_intervalarray—Строки, для которых не удалось определить интервал финансирования. пусто в образцах, по которым построена таблица
funding.coverage.no_liveness_excludedarray—Строки, исключённые потому, что по контракту нет признаков торгов (нет недавнего тикера, открытого интереса или котировки). пусто в образцах, по которым построена таблица
funding.methodobject—Текстовое описание формул, использованных для этого ответа.
funding.method.ratestring—Ставка.
funding.method.rate_8hstring—Ставка, приведённая к 8-часовому периоду.
funding.method.apr_pctstring% per yearЗначение в процентах годовых.
funding.method.aggregatestring—Агрегат по биржам.
funding.method.settledstring—Записи фактических расчётов; null, если публичной истории нет.
funding.method.predicted_ratestring—Ориентировочная ставка следующего периода; null, если она не публикуется.
funding.method.livenessstring—Текстовое правило отсева неактивных контрактов: строка финансирования учитывается, только если есть тикер не старше 1h, открытый интерес не старше 3h или собственная котировка не старше 3h.
liquidationsobject—Тот же объект, что возвращает `/api/sd/liquidations` для этой монеты.
liquidations.coinstring—Символ монеты в верхнем регистре (например, BTC).
liquidations.nownumbermsВремя сервера в момент формирования ответа.
liquidations.windowsobject—Итоги по каждому окну (ключи вида `1h`, `4h`, `12h`, `24h`). динамические ключи: 1h,4h,12h,24h
liquidations.windows.{*}object—Значения по окнам.
liquidations.windows.{*}.long_usdnumberUSDЛиквидированные длинные позиции; null, если окно не покрыто ни одним источником.
liquidations.windows.{*}.short_usdnumberUSDЛиквидированные короткие позиции; null, если окно не покрыто ни одним источником.
liquidations.windows.{*}.total_usdnumberUSDЛонг + шорт.
liquidations.windows.{*}.countnumber—Число ордеров ликвидации.
liquidations.windows.{*}.long_pctnumber%Доля лонгов в общем значении.
liquidations.windows.{*}.max_orderobject—Крупнейшая отдельная ликвидация в окне.
liquidations.windows.{*}.max_order.exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
liquidations.windows.{*}.max_order.symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
liquidations.windows.{*}.max_order.sidestring—`long` / `short` или `buy` / `sell`.
liquidations.windows.{*}.max_order.pricenumber—Последняя цена в валюте котировки (USD или USDT, если не указано иное).
liquidations.windows.{*}.max_order.qtynumber—Количество.
liquidations.windows.{*}.max_order.contract_multipliernumberxЧисло монет в котируемой единице контракта крупнейшего ордера (1000 для контрактов вида 1000PEPE); `price` и `qty` уже пересчитаны на одну монету.
liquidations.windows.{*}.max_order.value_usdnumberUSDЗначение.
liquidations.windows.{*}.max_order.timestampnumbermsМетка времени.
liquidations.by_exchangeobject—Разбивка по биржам для каждого окна. динамические ключи: 1h,4h,12h,24h
liquidations.by_exchange.{*}array—Разбивка по биржам.
liquidations.by_exchange.{*}[]object—Разбивка по биржам.
liquidations.by_exchange.{*}[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
liquidations.by_exchange.{*}[].long_usdnumberUSDСторона лонг.
liquidations.by_exchange.{*}[].short_usdnumberUSDСторона шорт.
liquidations.by_exchange.{*}[].total_usdnumberUSDВсего.
liquidations.by_exchange.{*}[].countnumber—Число элементов.
liquidations.by_exchange.{*}[].share_pctnumber%Доля в общем значении.
liquidations.last_event_atnumbermsВремя самой последней ликвидации по этой монете.
liquidations.last_event_age_snumbersЧисло секунд с этого события.
liquidations.sourcesarray—Состояние каждой ленты ликвидаций: как она собирается и когда в последний раз передавала данные.
liquidations.sources[]object—Источники данных.
liquidations.sources[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
liquidations.sources[].viastring—Способ сбора (`ws`, `rest`, …).
liquidations.sources[].statusstring—Состояние ленты, оцениваемое по времени её собственных событий и по heartbeat-сообщениям.
liquidations.sources[].feed_last_event_age_snumber|nullsЧисло секунд с события.
liquidations.sources[].ws_heartbeat_age_snumber|nullsЧисло секунд с события.
liquidations.sources[].judged_bystring—По какой метке времени оценивался статус.
liquidations.sources[].coin_last_event_age_snumber|nullsЧисло секунд с события.
liquidations.sources[].min_event_usdnumberUSDМинимальный размер ордера, публикуемый лентой; более мелкие ликвидации на этой площадке не видны.
liquidations.sources[].notestring|null—Примечание.
liquidations.sources[].node_heartbeat_age_snumbersЧисло секунд с события. может отсутствовать
liquidations.sources[].pipeline_last_event_age_snumbersЧисло секунд с события. может отсутствовать
liquidations.coverageobject—Что входит и что не входит в приведённые выше значения. Сверьтесь с этим блоком, прежде чем сравнивать итоги с другим источником.
liquidations.coverage.collected_exchangesarray—Биржи с публичной лентой ликвидаций, которую собирает CoinBoss.
liquidations.coverage.collected_exchanges[]string—Собираемые биржи.
liquidations.coverage.unavailablearray—Пары «биржа / контракт», которые не удалось включить, с указанием причины для каждой. Они никогда не учитываются как 0.
liquidations.coverage.unavailable[]object—Элементы, по которым нет данных, с указанием причин. Никогда не сообщаются как 0.
liquidations.coverage.unavailable[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
liquidations.coverage.unavailable[].reasonstring—Код причины.
liquidations.methodobject—Текстовое описание формул, использованных для этого ответа.
liquidations.method.eventstring—Текстовое пояснение, что считается одним событием ликвидации: один ордер ликвидации, переданный потоком биржи или возвращённый её публичным REST API.
liquidations.method.sidestring—`long` / `short` или `buy` / `sell`.
liquidations.method.value_usdstringUSDЗначение.
liquidations.method.dedupestring—Текстовое пояснение о дедупликации: события уникальны по бирже, символу, стороне, цене, сумме и метке времени, а также по биржевому ID ордера, если он передан.
liquidations.method.null_rulestring—Текстовое пояснение о том, что окно без единого собранного события возвращает null, а не 0, и о том, где перечислены биржи без публичного потока.
liquidations.method.binance_notestring—Текстовая оговорка о том, что Binance передаёт не более одной ликвидации на символ в секунду, поэтому итоги Binance — нижняя граница.
liquidations.method.min_event_usdstringUSDМинимальный ордер, публикуемый лентой.
volumeobject—Тот же объект, что возвращает `/api/sd/volume` для этой монеты.
volume.coinstring—Символ монеты в верхнем регистре (например, BTC).
volume.nownumbermsВремя сервера в момент формирования ответа.
volume.futuresobject—Блок или значение фьючерсного рынка.
volume.futures.total_usdnumberUSDФьючерсный объём за 24h по биржам (номинал в USD).
volume.futures.n_exchangesnumber—Число учтённых бирж.
volume.futures.by_exchangearray—Разбивка по биржам.
volume.futures.by_exchange[]object—Разбивка по биржам.
volume.futures.by_exchange[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
volume.futures.by_exchange[].vol_usdnumberUSDОбъём (номинал в USD).
volume.futures.by_exchange[].legacy_usdnumberUSDЧасть объёма, приходящаяся на набор тикеров бессрочных контрактов USDT.
volume.futures.by_exchange[].sd_usdnumberUSDЧасть, приходящаяся на уже включённые дополнительные контракты (USDC, с маржой в монете, срочные).
volume.futures.by_exchange[].share_pctnumber%Доля в общем значении.
volume.futures.change_24hobject—Изменение за 24h.
volume.futures.change_24h.pctnumber%Значение в процентах.
volume.futures.change_24h.curnumber—Текущее значение.
volume.futures.change_24h.prevnumber—Предыдущее значение (база сравнения).
volume.futures.change_24h.n_matchednumber—Элементы, присутствующие на обоих концах сравнения.
volume.futures.change_24h.n_totalnumber—Элементы, присутствующие сейчас.
volume.futures.change_24h.prev_tsnumbermsВремя базового снимка.
volume.futures.change_24h.basisstring—Цена фьючерса минус спотовая цена либо блок базиса.
volume.futures.selfdata_contractsobject—Дополнительные контракты: что уже включено и что ещё ожидает включения.
volume.futures.selfdata_contracts.included_usdnullUSDОбъём за 24h по дополнительно собираемым контрактам (с маржой в монете, в USDC, срочным), уже учтённый во фьючерсном итоге; null, если пока не учтён ни один.
volume.futures.selfdata_contracts.n_includednumbercountЧисло дополнительно собираемых контрактов, учтённых во фьючерсном итоге (тех, у которых есть собственный снимок примерно 24-часовой давности).
volume.futures.selfdata_contracts.pending_usdnumber|nullUSDСумма по ожидающим элементам; в итог не входит.
volume.futures.selfdata_contracts.n_pendingnumbercountЧисло дополнительно собираемых контрактов, которые пока не учтены, поскольку у них нет собственной базы сравнения 24-часовой давности; крупнейшие перечислены в `pending`.
volume.futures.selfdata_contracts.pendingarray—Элементы, которые собираются, но ещё не включены.
volume.futures.selfdata_contracts.pending[]object—Элементы, которые собираются, но ещё не включены.
volume.futures.selfdata_contracts.pending[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
volume.futures.selfdata_contracts.pending[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
volume.futures.selfdata_contracts.pending[].marginstring—Класс валюты маржи.
volume.futures.selfdata_contracts.pending[].contract_typestring—`perpetual` или `delivery`.
volume.futures.selfdata_contracts.pending[].vol_usdnumberUSDОбъём (номинал в USD).
volume.futures.selfdata_contracts.pending[].reasonstring—Код причины.
volume.spotobject—Блок или значение спотового рынка.
volume.spot.total_usdnumberUSDСпотовый объём за 24h по биржам.
volume.spot.n_exchangesnumber—Число учтённых бирж.
volume.spot.asofnumbermsВремя самых новых использованных данных.
volume.spot.by_exchangearray—Разбивка по биржам.
volume.spot.by_exchange[]object—Разбивка по биржам.
volume.spot.by_exchange[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
volume.spot.by_exchange[].vol_usdnumberUSDОбъём (номинал в USD).
volume.spot.by_exchange[].quotestring—Валюты котировки, учтённые для этой биржи.
volume.spot.by_exchange[].tsnumbermsМетка времени.
volume.spot.by_exchange[].pricenumber—Последняя цена в валюте котировки (USD или USDT, если не указано иное).
volume.spot.by_exchange[].age_snumbersЧисло секунд с последнего обновления этой строки.
volume.spot.by_exchange[].share_pctnumber%Доля в общем значении.
volume.spot.change_24hobject—Изменение за 24h.
volume.spot.change_24h.pctnumber%Значение в процентах.
volume.spot.change_24h.curnumber—Текущее значение.
volume.spot.change_24h.prevnumber—Предыдущее значение (база сравнения).
volume.spot.change_24h.n_matchednumber—Элементы, присутствующие на обоих концах сравнения.
volume.spot.change_24h.n_totalnumber—Элементы, присутствующие сейчас.
volume.spot.change_24h.prev_tsnumbermsВремя базового снимка.
volume.spot.change_24h.basisstring—Цена фьючерса минус спотовая цена либо блок базиса.
volume.ratiosobject—Отношения объёмов: `futures_to_spot` (фьючерсный объём за 24h ÷ спотовый объём за 24h) и `oi_to_futures_volume`; каждое равно null, если отсутствует одно из исходных значений.
volume.ratios.futures_to_spotnumber—Фьючерсный объём, делённый на спотовый объём.
volume.ratios.oi_to_futures_volumenumber—Открытый интерес, делённый на фьючерсный объём за 24h.
volume.methodobject—Текстовое описание формул, использованных для этого ответа.
volume.method.futuresstring—Блок или значение фьючерсного рынка.
volume.method.spotstring—Блок или значение спотового рынка.
volume.method.changestring—Изменение за указанный период.
volume.method.oi_to_futures_volumestring—Текстовое определение `ratios.oi_to_futures_volume`: совокупный открытый интерес в USD ÷ фьючерсный объём за 24h в USD.
lsobject—Тот же объект, что возвращает `/api/sd/ls` для этой монеты.
ls.coinstring—Символ монеты в верхнем регистре (например, BTC).
ls.nownumbermsВремя сервера в момент формирования ответа.
ls.accountobject—Доля счетов с чистой длинной позицией и доля счетов с чистой короткой позицией среди всех счетов.
ls.account.long_pctnumber%Доля лонгов.
ls.account.short_pctnumber%Доля шортов.
ls.account.rationumber—Соотношение.
ls.account.n_exchangesnumber—Число учтённых бирж.
ls.account.by_exchangearray—Разбивка по биржам.
ls.account.by_exchange[]object—Разбивка по биржам.
ls.account.by_exchange[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
ls.account.by_exchange[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
ls.account.by_exchange[].long_pctnumber%Доля лонгов.
ls.account.by_exchange[].short_pctnumber%Доля шортов.
ls.account.by_exchange[].rationumber—Соотношение.
ls.account.by_exchange[].updated_atnumbermsВремя последнего обновления этой строки.
ls.account.by_exchange[].age_snumbersЧисло секунд с последнего обновления этой строки.
ls.account.by_exchange[].is_staleboolean—true, если строка старше окна актуальности; устаревшие строки в итогах не используются.
ls.account.by_exchange[].sourcestring—Откуда взято значение.
ls.account.by_exchange[].periodstring—Период.
ls.top_accountobject—То же, но только для топ-трейдеров по определению биржи.
ls.top_account.long_pctnumber|null%Доля лонгов.
ls.top_account.short_pctnumber|null%Доля шортов.
ls.top_account.rationumber|null—Соотношение.
ls.top_account.n_exchangesnumber—Число учтённых бирж.
ls.top_account.by_exchangearray—Разбивка по биржам.
ls.top_account.by_exchange[]object—Разбивка по биржам.
ls.top_account.by_exchange[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
ls.top_account.by_exchange[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
ls.top_account.by_exchange[].long_pctnumber%Доля лонгов.
ls.top_account.by_exchange[].short_pctnumber%Доля шортов.
ls.top_account.by_exchange[].rationumber—Соотношение.
ls.top_account.by_exchange[].updated_atnumbermsВремя последнего обновления этой строки.
ls.top_account.by_exchange[].age_snumbersЧисло секунд с последнего обновления этой строки.
ls.top_account.by_exchange[].is_staleboolean—true, если строка старше окна актуальности; устаревшие строки в итогах не используются.
ls.top_account.by_exchange[].sourcestring—Откуда взято значение.
ls.top_account.by_exchange[].periodstring—Период.
ls.top_positionobject—Доли лонгов и шортов в позициях топ-трейдеров.
ls.top_position.long_pctnumber|null%Доля лонгов.
ls.top_position.short_pctnumber|null%Доля шортов.
ls.top_position.rationumber|null—Соотношение.
ls.top_position.n_exchangesnumber—Число учтённых бирж.
ls.top_position.by_exchangearray—Разбивка по биржам.
ls.top_position.by_exchange[]object—Разбивка по биржам.
ls.top_position.by_exchange[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
ls.top_position.by_exchange[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
ls.top_position.by_exchange[].long_pctnumber%Доля лонгов.
ls.top_position.by_exchange[].short_pctnumber%Доля шортов.
ls.top_position.by_exchange[].rationumber—Соотношение.
ls.top_position.by_exchange[].updated_atnumbermsВремя последнего обновления этой строки.
ls.top_position.by_exchange[].age_snumbersЧисло секунд с последнего обновления этой строки.
ls.top_position.by_exchange[].is_staleboolean—true, если строка старше окна актуальности; устаревшие строки в итогах не используются.
ls.top_position.by_exchange[].sourcestring—Откуда взято значение.
ls.top_position.by_exchange[].periodstring—Период.
ls.position_allobject—Доли лонгов и шортов во всех позициях (площадки, которые это публикуют).
ls.position_all.long_pctnumber|null%Доля лонгов.
ls.position_all.short_pctnumber|null%Доля шортов.
ls.position_all.rationumber|null—Соотношение.
ls.position_all.n_exchangesnumber—Число учтённых бирж.
ls.position_all.by_exchangearray—Разбивка по биржам.
ls.position_all.by_exchange[]object—Разбивка по биржам.
ls.position_all.by_exchange[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
ls.position_all.by_exchange[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
ls.position_all.by_exchange[].long_pctnumber%Доля лонгов.
ls.position_all.by_exchange[].short_pctnumber%Доля шортов.
ls.position_all.by_exchange[].rationumber—Соотношение.
ls.position_all.by_exchange[].updated_atnumbermsВремя последнего обновления этой строки.
ls.position_all.by_exchange[].age_snumbersЧисло секунд с последнего обновления этой строки.
ls.position_all.by_exchange[].is_staleboolean—true, если строка старше окна актуальности; устаревшие строки в итогах не используются.
ls.position_all.by_exchange[].sourcestring—Откуда взято значение.
ls.position_all.by_exchange[].periodstring—Период.
ls.takerobject—Доли объёма покупок и продаж тейкеров.
ls.taker.long_pctnumber|null%Доля лонгов.
ls.taker.short_pctnumber|null%Доля шортов.
ls.taker.rationumber|null—Соотношение.
ls.taker.n_exchangesnumber—Число учтённых бирж.
ls.taker.by_exchangearray—Разбивка по биржам.
ls.definitionsobject—Определение каждого показателя. Пять показателей отвечают на разные вопросы и никогда не смешиваются. может отсутствовать
ls.definitions.accountstring—Показатель по счетам. может отсутствовать
ls.definitions.top_accountstring—Показатель по счетам топ-трейдеров. может отсутствовать
ls.definitions.top_positionstring—Показатель по позициям топ-трейдеров. может отсутствовать
ls.definitions.position_allstring—Показатель по всем позициям. может отсутствовать
ls.definitions.takerstring—Показатель покупок / продаж тейкеров. может отсутствовать
ls.methodobject—Текстовое описание формул, использованных для этого ответа. может отсутствовать
ls.method.normalizestring—Текстовое пояснение о нормализации: значение каждой биржи масштабируется так, чтобы лонг % + шорт % = 100, а соотношение = лонг % ÷ шорт %. может отсутствовать
ls.method.aggregatestring—Агрегат по биржам. может отсутствовать
ls.method.freshnessstring—Текстовое правило актуальности: показываются строки, обновлённые за последние 24 часа, а `is_stale` помечает строки старше 2 часов. может отсутствовать
errorsobject—Части набора, которые не удалось сформировать, с ключами по названию части; пусто, если все части на месте. может отсутствовать

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

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

Пример не сохранён: последний успешный ответ слишком велик для отображения. Вызовите эндпоинт в песочнице.

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

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

ПараметрыHTTPЗадержкаРезультат
coin=ETH20073 msПройдено
coin=SOL20059 msПройдено
coin=ARKM20059 msПройдено
—4002 msПройдено возвращает ожидаемую ошибку

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

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
15s
Пограничный микрокеш
10s
Частота обновления
см. /api/sd/oi, /api/sd/funding, /api/sd/liquidations, /api/sd/volume, /api/sd/ls (опрос раз в 60 s – 5 min; ликвидации — в реальном времени; спот — раз в 10 min)
Окно
последний снимок по каждому блоку и собственные скользящие окна каждого блока
Источники данных
Объединённые блоки открытого интереса, финансирования, ликвидаций, объёма и лонг/шорт для одной монеты; все они построены собственными коллекторами CoinBoss, которые опрашивают публичные API примерно 30 площадок (например, binance, okx, bybit, bitget, gate, hyperliquid).
Покрытие бирж
как у пяти эндпоинтов отдельных блоков; список контрактов обрезается до 60 строк
Единицы измерения
USD notional for OI / volume / liquidations; funding as fraction; long/short in percent
Метод расчёта
same builders as the five single-block endpoints
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный
Доступен с
2026-11-11

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

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

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

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

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

Ошибки

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

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

string — Coin symbol; 400 when missing. Alias: `base`.

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