Публичный API CoinBoss
Бесплатный общедоступный REST и WebSocket API с данными по криптодеривативам: открытый интерес, ставки финансирования, ликвидации, соотношения лонг/шорт, глубина книги ордеров, потоки ETF и многое другое. CoinBoss собирает данные напрямую из API бирж, хранит исходные записи и рассчитывает каждый агрегат по опубликованной формуле.
https://www.coinboss.com/apiБыстрый старт
Отправьте запрос
Каждый эндпоинт — это обычный запрос HTTPS GET, возвращающий JSON. Регистрация и ключ не нужны: скопируйте команду и выполните её.
Разберите обёртку ответа
Поле success показывает, выполнен ли вызов. Эндпоинты слоя данных дополнительно возвращают coverage (какие биржи учтены, какие нет и почему), method (формула каждого агрегата) и meta (метки времени, актуальность, время жизни кеша).
Обработайте null и ошибки
Отсутствующее значение — это null, а не 0. Неудачный вызов возвращает success: false с машиночитаемым кодом и полем request_id, которое можно указать в сообщении о проблеме.
curl -s "https://www.coinboss.com/api/sd/oi?coin=BTC"Реальный ответ, получен 2026-11-14 21:07 UTC
- "success"true
- "coin""BTC"
- "now"1794690454669
- "total_usd"44740859027.98
- "n_exchanges"22
- "n_contracts"95
- "asof"1794690431000
- "total_usd_single_adjusted"40201822657.17998
- "double_sided"
- "by_kind"
- "by_margin"
- "by_contract_type"
- "change"
- "by_exchange"
- "contracts"
- "coverage"
- "method"
Что охватывает API
Агрегаты по всем биржам
Открытый интерес, финансирование, ликвидации, соотношение лонг/шорт и объём по каждой монете, агрегированные по биржам, с разбивкой по биржам в том же ответе.
Детализация до контракта
Бессрочные контракты с маржой в USDT, USDC и в монете, а также срочные фьючерсы; в каждой строке указаны биржа, контракт и метка времени данных.
История для графиков
Временные ряды открытого интереса, расчётов финансирования, ликвидаций по интервалам, объёма и свечей с явно указанными окнами и шагом.
Поток в реальном времени
WebSocket передаёт ордера ликвидации и обновления цен по мере их поступления. Пропуск после переподключения восполняется через HTTP-эндпоинты.
Рыночный контекст
Потоки и запасы спотовых ETF, открытый интерес и макс. боль по опционам, позиционирование на CME, индексы и резервы бирж.
Качество как данные
Каждой бирже и каждому семейству данных по меткам времени данных присваивается оценка FRESH, PARTIAL, STALE, BROKEN или UNAVAILABLE. Сама оценка тоже доступна через эндпоинт.
Категории данных
Каждая категория ведёт к своим эндпоинтам. Счётчик показывает, сколько эндпоинтов прошло последнюю проверку реальным вызовом.
Рынки и спот
доступно 23/23Списки монет, спотовые цены, капитализация, динамика цены, свечи, лидеры движения и спот-рынки по площадкам.
Фьючерсы
доступно 10/10Тикеры деривативов, скринеры, объём, свечи и ряды технических индикаторов по монетам.
Открытый интерес
доступно 6/6Открытый интерес по монетам, биржам и контрактам с историей и явным указанием одностороннего или двустороннего учёта.
Ставки финансирования
доступно 13/13Текущие, приведённые к 8h, взвешенные, исторические и накопленные ставки финансирования по площадкам.
Лонг/шорт
доступно 10/10Соотношение по счетам, соотношение по позициям и покупки/продажи тейкеров — как отдельные показатели, без смешивания.
Ликвидации
доступно 23/23Записи ликвидаций, итоги по монетам и биржам, крупнейшие ордера и временные ряды.
Модели ликвидаций
доступно 8/8Модельные тепловые карты ликвидаций, карты, уровни кластеров и макс. боль. Это оценки, а не данные бирж.
Книга ордеров
доступно 4/4Глубина в пределах ±0.5 / 1 / 2 % от средней цены, проскальзывание для заданного размера ордера и крупные ордера, стоящие в книге.
Базис и премия
доступно 9/11Базис фьючерсов к споту, индекс премии бессрочных контрактов и ценовые премии между площадками.
Биржи
доступно 21/21Рейтинги бирж, рынки по биржам, доля объёма, ончейн-балансы и резервы.
ETF
доступно 9/12Потоки спотовых и фьючерсных ETF, AUM, запасы, профили фондов и премии трастов.
Опционы
доступно 8/13Открытый интерес и объём опционов, соотношение пут/колл, макс. боль и подразумеваемая волатильность.
CME и CFTC
доступно 2/3Данные фьючерсов CME и позиционирование по отчётам CFTC Commitments of Traders.
Hyperliquid
доступно 25/25Рынки, позиционирование китов и уровней, волты, состояние адресов и сжигание HYPE.
Акции и RWA
доступно 19/20Бессрочные контракты на акции, токенизированные акции, контракты Pre-IPO и ликвидации бессрочных контрактов TradFi.
Категории
доступно 4/4Категории (секторы) монет с входящими в них монетами и разблокировки токенов.
Индексы и индикаторы
доступно 25/26Индекс страха и жадности, сезон альткоинов, индикаторы цикла и оценки стоимости, макроэкономические ряды и ряды настроений.
Ончейн
доступно 23/33Ончейн-метрики BTC, списки богатейших адресов, корпоративные резервы и поиск по блокчейнам.
Рыночные агрегаты
доступно 17/17Итоги по всему рынку: объём, открытый интерес, ликвидации, доминирование, капитализация и стейблкоины.
Метаданные и утилиты
доступно 15/15Каталог API, статус, качество данных, журнал изменений, документ OpenAPI, проверка работоспособности, иконки и курсы валют.
WebSocket
доступно 1/1Поток ликвидаций и цен в реальном времени.
Насколько актуальны данные
Актуальность измеряется по метке времени самой новой сохранённой записи — отдельно для каждой биржи и каждого семейства данных. Семейство считается FRESH, пока возраст этой записи не превышает его окно актуальности.
| Семейство данных | Содержит | Сбор | Окно актуальности | Бирж с актуальными данными |
|---|---|---|---|---|
| Фьючерсные тикеры | последняя цена, объём за 24h и изменение цены по каждому контракту | каждую минуту (REST) | 5m | 24 / 25 |
| Открытый интерес | открытый интерес по каждому контракту в номинале USD | каждые 5 минут; основные контракты — каждую минуту; ежечасный снимок в историю | 15m | 22 / 23 |
| Ставка финансирования | текущая / прогнозная ставка финансирования, интервал и время следующего расчёта | каждые 5 минут; ежечасный снимок в историю | 15m | 24 / 24 |
| Расчёты финансирования | реализованная ставка финансирования при каждом расчёте | после каждого расчёта | 9h | 16 / 16 |
| Ликвидации | ордера ликвидации (биржевые ленты WebSocket / REST) | в реальном времени (WebSocket) или опрос с коротким интервалом — в зависимости от биржи | 30m | 11 / 11 |
| Соотношение лонг/шорт | соотношения лонг/шорт по счетам, топ-трейдерам и тейкерам | каждые 5 минут; ежечасный снимок в историю | 1.5h | 0 / 7 |
| Спотовый объём | спотовый объём за 24h по монетам и биржам | каждые 10 минут | 30m | 14 / 14 |
| Контракты с маржой в монете / USDC / срочные | контракты вне набора бессрочных контрактов с маржой в USDT (цена, OI, объём, финансирование) | каждые 2 минуты | 6m | 11 / 11 |
| Книга ордеров (бессрочные контракты) | Глубина в пределах ±0.5 / 1 / 2 % от средней цены и проскальзывание рыночных ордеров по снимкам книги ордеров. | каждые 2–5 минут для самых торгуемых монет, каждые 10–20 минут для остальных | 5m | 14 / 23 |
| Книга ордеров (спот) | Глубина в пределах ±0.5 / 1 / 2 % от средней цены и проскальзывание рыночных ордеров по снимкам книги ордеров. | каждые 2–5 минут для самых торгуемых монет, каждые 10–20 минут для остальных | 5m | 11 / 15 |
| Базис (маркировка / индекс) | Цены маркировки и индексные цены бессрочных и срочных контрактов, используемые для расчёта базиса. | 60 s | 3m | 0 / 21 |
| Опционы | Опционные контракты: открытый интерес, объём, IV по цене маркировки и греки. | 10 min | 25m | 0 / 6 |
Покрытие бирж
Бирж: 30, семейств данных: 12. Прочерк означает, что у биржи нет публичного эндпоинта для этих данных или CoinBoss их не собирает; причина для каждой ячейки указана на странице качества данных.
| Биржа | Фьючерсные тикеры | Открытый интерес | Ставка финансирования | Расчёты финансирования | Ликвидации | Соотношение лонг/шорт | Спотовый объём | Контракты с маржой в монете / USDC / срочные | Книга ордеров (бессрочные контракты) | Книга ордеров (спот) | Базис (маркировка / индекс) | Опционы |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| aster | FRESH | FRESH | FRESH | FRESH | FRESH | — | — | — | PARTIAL | — | STALE | — |
| backpack | FRESH | FRESH | FRESH | — | — | — | — | — | FRESH | FRESH | STALE | — |
| binance | FRESH | FRESH | FRESH | FRESH | FRESH | PARTIAL | FRESH | FRESH | PARTIAL | FRESH | STALE | STALE |
| bingx | FRESH | PARTIAL | FRESH | FRESH | — | — | — | FRESH | FRESH | PARTIAL | STALE | — |
| bitfinex | FRESH | FRESH | FRESH | — | FRESH | — | FRESH | — | FRESH | FRESH | STALE | — |
| bitget | FRESH | FRESH | FRESH | FRESH | FRESH | PARTIAL | FRESH | FRESH | PARTIAL | FRESH | STALE | — |
| bitstamp | — | — | — | — | — | — | FRESH | — | — | — | — | — |
| bitunix | FRESH | — | FRESH | — | — | — | — | — | PARTIAL | — | STALE | — |
| bybit | FRESH | FRESH | FRESH | FRESH | FRESH | PARTIAL | FRESH | FRESH | PARTIAL | FRESH | STALE | STALE |
| cme | — | FRESH | — | — | — | — | — | — | — | — | — | — |
| coinbase | STALE | — | — | — | — | — | FRESH | — | — | FRESH | — | — |
| coincall | — | — | — | — | — | — | — | — | — | — | — | STALE |
| cryptocom | FRESH | FRESH | FRESH | FRESH | — | — | FRESH | — | FRESH | FRESH | STALE | — |
| deribit | FRESH | FRESH | FRESH | FRESH | FRESH | — | — | FRESH | FRESH | — | STALE | STALE |
| dydx | FRESH | FRESH | FRESH | FRESH | — | — | — | — | FRESH | — | — | — |
| edgex | FRESH | FRESH | FRESH | — | — | — | — | — | FRESH | — | — | — |
| gate | FRESH | FRESH | FRESH | FRESH | FRESH | PARTIAL | FRESH | FRESH | PARTIAL | PARTIAL | STALE | STALE |
| gemini | — | — | — | — | — | — | FRESH | — | — | — | — | — |
| htx | FRESH | FRESH | FRESH | FRESH | FRESH | PARTIAL | FRESH | FRESH | FRESH | FRESH | STALE | — |
| hyperliquid | FRESH | FRESH | FRESH | FRESH | FRESH | — | — | — | FRESH | — | STALE | — |
| kraken | FRESH | FRESH | FRESH | FRESH | — | PARTIAL | FRESH | FRESH | FRESH | FRESH | STALE | — |
| kucoin | FRESH | FRESH | FRESH | FRESH | — | — | — | FRESH | PARTIAL | PARTIAL | STALE | — |
| lbank | FRESH | — | FRESH | — | — | — | — | — | PARTIAL | — | STALE | — |
| lighter | FRESH | FRESH | FRESH | — | FRESH | — | — | — | FRESH | — | STALE | — |
| mexc | FRESH | FRESH | FRESH | FRESH | — | — | FRESH | FRESH | PARTIAL | PARTIAL | STALE | — |
| okx | FRESH | FRESH | FRESH | FRESH | FRESH | PARTIAL | FRESH | FRESH | FRESH | FRESH | STALE | STALE |
| paradex | FRESH | FRESH | FRESH | — | — | — | — | — | FRESH | — | STALE | — |
| tradexyz | FRESH | FRESH | FRESH | — | — | — | — | — | — | — | — | — |
| upbit | — | — | — | — | — | — | FRESH | — | — | — | — | — |
| whitebit | FRESH | FRESH | FRESH | FRESH | — | — | — | — | FRESH | FRESH | STALE | — |
Оценено: 2026-11-14 21:09 UTC · Открыть полную матрицу качества данных →
Принципы качества данных
Собственный сбор данных
Метрики деривативов поступают из REST и WebSocket API бирж; CoinBoss сам собирает и хранит их. Несколько эндпоинтов рыночного контекста используют другие публичные источники; на каждой странице справочника указан источник данных.
Null — это не ноль
Если у биржи нет публичного эндпоинта для метрики или значение устарело, поле равно null, а причина указана в coverage.unavailable. Пропуски никогда не заполняются нулями или интерполированными значениями.
Опубликованные формулы
Для агрегатов указан метод расчёта: единица измерения, окно, способ объединения контрактов с множителем, приведение финансирования к 8-часовому интервалу и перечень исключённых строк.
Три метки времени
observed_at — время самой биржи, received_at — момент, когда коллектор сохранил запись, fetched_at — момент формирования ответа; по ним можно самостоятельно измерить отставание.
У расхождений есть причины
Значения могут отличаться от других сайтов с данными из-за времени фиксации, покрытия бирж, типов контрактов, единиц измерения и определений окон. Прежде чем считать расхождение ошибкой, сравните эти параметры.
Типовые сценарии
Мониторинг ставки финансирования
Раз в минуту опрашивайте эндпоинт финансирования по монете, считывайте среднее значение, приведённое к 8 часам, и строки по биржам, а для реализованных ставок используйте историю расчётов.
Лента ликвидаций
Подпишитесь на WebSocket, чтобы получать ордера ликвидации в реальном времени, после переподключения восполняйте пропуск через эндпоинт ленты, а итоги по окнам берите из агрегирующего эндпоинта.
Дашборд открытого интереса
Получите агрегированный открытый интерес по монете и его разбивку по биржам, затем дополните их данными эндпоинта истории, чтобы построить график изменений во времени.
Контроль качества на входе пайплайна
Прежде чем доверять значению, проверьте в матрице качества биржу и семейство данных, от которых зависит расчёт, а в проверки работоспособности включите эндпоинт статуса сервиса.
Что дальше
Недоступен указан для полноты; законного публичного источника пока нет, эндпоинт возвращает значения null или не обслуживается