Обзор

Публичный API CoinBoss

Бесплатный общедоступный REST и WebSocket API с данными по криптодеривативам: открытый интерес, ставки финансирования, ликвидации, соотношения лонг/шорт, глубина книги ордеров, потоки ETF и многое другое. CoinBoss собирает данные напрямую из API бирж, хранит исходные записи и рассчитывает каждый агрегат по опубликованной формуле.

API-ключ не требуетсяЭндпоинтов: 299Бирж: 30API v1
Базовый URLhttps://www.coinboss.com/api
Текущий статусПоследнюю проверку реальным вызовом прошли 275 из 298 эндпоинтовпроверено 48s назадСтатус →

Быстрый старт

1

Отправьте запрос

Каждый эндпоинт — это обычный запрос HTTPS GET, возвращающий JSON. Регистрация и ключ не нужны: скопируйте команду и выполните её.

2

Разберите обёртку ответа

Поле success показывает, выполнен ли вызов. Эндпоинты слоя данных дополнительно возвращают coverage (какие биржи учтены, какие нет и почему), method (формула каждого агрегата) и meta (метки времени, актуальность, время жизни кеша).

3

Обработайте null и ошибки

Отсутствующее значение — это null, а не 0. Неудачный вызов возвращает success: false с машиночитаемым кодом и полем request_id, которое можно указать в сообщении о проблеме.

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

Открыть документацию: /api/sd/oi · Открыть в песочнице

Реальный ответ, получен 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": { … 2 },
    • "by_kind": { … 2 },
    • "by_margin": { … 4 },
    • "by_contract_type": { … 2 },
    • "change": { … 2 },
    • "by_exchange": [ … 2 ],
    • "contracts": [ … 2 ],
    • "coverage": { … 5 },
    • "method": { … 5 }
    }

Что охватывает 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)5m24 / 25
Открытый интересоткрытый интерес по каждому контракту в номинале USDкаждые 5 минут; основные контракты — каждую минуту; ежечасный снимок в историю15m22 / 23
Ставка финансированиятекущая / прогнозная ставка финансирования, интервал и время следующего расчётакаждые 5 минут; ежечасный снимок в историю15m24 / 24
Расчёты финансированияреализованная ставка финансирования при каждом расчётепосле каждого расчёта9h16 / 16
Ликвидацииордера ликвидации (биржевые ленты WebSocket / REST)в реальном времени (WebSocket) или опрос с коротким интервалом — в зависимости от биржи30m11 / 11
Соотношение лонг/шортсоотношения лонг/шорт по счетам, топ-трейдерам и тейкерамкаждые 5 минут; ежечасный снимок в историю1.5h0 / 7
Спотовый объёмспотовый объём за 24h по монетам и биржамкаждые 10 минут30m14 / 14
Контракты с маржой в монете / USDC / срочныеконтракты вне набора бессрочных контрактов с маржой в USDT (цена, OI, объём, финансирование)каждые 2 минуты6m11 / 11
Книга ордеров (бессрочные контракты)Глубина в пределах ±0.5 / 1 / 2 % от средней цены и проскальзывание рыночных ордеров по снимкам книги ордеров.каждые 2–5 минут для самых торгуемых монет, каждые 10–20 минут для остальных5m14 / 23
Книга ордеров (спот)Глубина в пределах ±0.5 / 1 / 2 % от средней цены и проскальзывание рыночных ордеров по снимкам книги ордеров.каждые 2–5 минут для самых торгуемых монет, каждые 10–20 минут для остальных5m11 / 15
Базис (маркировка / индекс)Цены маркировки и индексные цены бессрочных и срочных контрактов, используемые для расчёта базиса.60 s3m0 / 21
ОпционыОпционные контракты: открытый интерес, объём, IV по цене маркировки и греки.10 min25m0 / 6

Покрытие бирж

Бирж: 30, семейств данных: 12. Прочерк означает, что у биржи нет публичного эндпоинта для этих данных или CoinBoss их не собирает; причина для каждой ячейки указана на странице качества данных.

Самая новая сохранённая точка данных находится внутри окна актуальности этого семейства данных. Часть контрактов или строк вышла за окно актуальности, либо отсутствует обязательное поле. В окне актуальности нет ни одной строки. За пределами окна пригодности значения исключаются из агрегатов. Эндпоинт источника постоянно отвечает ошибкой, либо большинство строк не проходит проверки на корректность. У биржи нет публичного эндпоинта для этих данных, либо они не собираются. Отображается как «—» и никогда как 0.
БиржаФьючерсные тикерыОткрытый интересСтавка финансированияРасчёты финансированияЛиквидацииСоотношение лонг/шортСпотовый объёмКонтракты с маржой в монете / USDC / срочныеКнига ордеров (бессрочные контракты)Книга ордеров (спот)Базис (маркировка / индекс)Опционы
asterFRESHFRESHFRESHFRESHFRESH———PARTIAL—STALE—
backpackFRESHFRESHFRESH—————FRESHFRESHSTALE—
binanceFRESHFRESHFRESHFRESHFRESHPARTIALFRESHFRESHPARTIALFRESHSTALESTALE
bingxFRESHPARTIALFRESHFRESH———FRESHFRESHPARTIALSTALE—
bitfinexFRESHFRESHFRESH—FRESH—FRESH—FRESHFRESHSTALE—
bitgetFRESHFRESHFRESHFRESHFRESHPARTIALFRESHFRESHPARTIALFRESHSTALE—
bitstamp——————FRESH—————
bitunixFRESH—FRESH—————PARTIAL—STALE—
bybitFRESHFRESHFRESHFRESHFRESHPARTIALFRESHFRESHPARTIALFRESHSTALESTALE
cme—FRESH——————————
coinbaseSTALE—————FRESH——FRESH——
coincall———————————STALE
cryptocomFRESHFRESHFRESHFRESH——FRESH—FRESHFRESHSTALE—
deribitFRESHFRESHFRESHFRESHFRESH——FRESHFRESH—STALESTALE
dydxFRESHFRESHFRESHFRESH————FRESH———
edgexFRESHFRESHFRESH—————FRESH———
gateFRESHFRESHFRESHFRESHFRESHPARTIALFRESHFRESHPARTIALPARTIALSTALESTALE
gemini——————FRESH—————
htxFRESHFRESHFRESHFRESHFRESHPARTIALFRESHFRESHFRESHFRESHSTALE—
hyperliquidFRESHFRESHFRESHFRESHFRESH———FRESH—STALE—
krakenFRESHFRESHFRESHFRESH—PARTIALFRESHFRESHFRESHFRESHSTALE—
kucoinFRESHFRESHFRESHFRESH———FRESHPARTIALPARTIALSTALE—
lbankFRESH—FRESH—————PARTIAL—STALE—
lighterFRESHFRESHFRESH—FRESH———FRESH—STALE—
mexcFRESHFRESHFRESHFRESH——FRESHFRESHPARTIALPARTIALSTALE—
okxFRESHFRESHFRESHFRESHFRESHPARTIALFRESHFRESHFRESHFRESHSTALESTALE
paradexFRESHFRESHFRESH—————FRESH—STALE—
tradexyzFRESHFRESHFRESH—————————
upbit——————FRESH—————
whitebitFRESHFRESHFRESHFRESH————FRESHFRESHSTALE—

Оценено: 2026-11-14 21:09 UTC · Открыть полную матрицу качества данных →

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

Собственный сбор данных

Метрики деривативов поступают из REST и WebSocket API бирж; CoinBoss сам собирает и хранит их. Несколько эндпоинтов рыночного контекста используют другие публичные источники; на каждой странице справочника указан источник данных.

Null — это не ноль

Если у биржи нет публичного эндпоинта для метрики или значение устарело, поле равно null, а причина указана в coverage.unavailable. Пропуски никогда не заполняются нулями или интерполированными значениями.

Опубликованные формулы

Для агрегатов указан метод расчёта: единица измерения, окно, способ объединения контрактов с множителем, приведение финансирования к 8-часовому интервалу и перечень исключённых строк.

Три метки времени

observed_at — время самой биржи, received_at — момент, когда коллектор сохранил запись, fetched_at — момент формирования ответа; по ним можно самостоятельно измерить отставание.

У расхождений есть причины

Значения могут отличаться от других сайтов с данными из-за времени фиксации, покрытия бирж, типов контрактов, единиц измерения и определений окон. Прежде чем считать расхождение ошибкой, сравните эти параметры.

Типовые сценарии

Мониторинг ставки финансирования

Раз в минуту опрашивайте эндпоинт финансирования по монете, считывайте среднее значение, приведённое к 8 часам, и строки по биржам, а для реализованных ставок используйте историю расчётов.

Лента ликвидаций

Подпишитесь на WebSocket, чтобы получать ордера ликвидации в реальном времени, после переподключения восполняйте пропуск через эндпоинт ленты, а итоги по окнам берите из агрегирующего эндпоинта.

Дашборд открытого интереса

Получите агрегированный открытый интерес по монете и его разбивку по биржам, затем дополните их данными эндпоинта истории, чтобы построить график изменений во времени.

Контроль качества на входе пайплайна

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

Что дальше

Недоступен указан для полноты; законного публичного источника пока нет, эндпоинт возвращает значения null или не обслуживается