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

Сводка по монете

Сводка по монете (цена, капитализация, предложение, сводка по деривативам)

GET/api/currency/overview

Запрос

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

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
coinstringОбязательный——Символ базовой монеты (в верхнем регистре, например BTC). Пример: BTC

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

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

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
dataobject—Полезные данные.
data.coinstring—Символ монеты в верхнем регистре (например, BTC).
data.supplyobject—Предложение в монетах.
data.supply.price_usdstring(decimal)USDЦена.
data.supply.market_cap_usdstring(decimal)USDРыночная капитализация.
data.supply.mcap_ranknumber—Ранг по рыночной капитализации.
data.supply.vol_24h_usdstring(decimal)USDОбъём за 24h.
data.supply.circulatingstring(decimal)—Предложение в обращении, в монетах.
data.supply.total_supplystring(decimal)—Общее предложение в монетах.
data.supply.max_supplystring(decimal)|null—Максимальное предложение в монетах; null, если оно не ограничено или неизвестно.
data.supply.change_24h_pctstring(decimal)%Изменение за 24h в процентах.
data.supply.image_urlstring—Путь к иконке на том же источнике (same-origin), которую отдаёт CoinBoss; null, если проверенной иконки нет.
data.supply.website_urlstring—Официальный сайт проекта, из метаданных монеты.
data.supply.reddit_urlstring|null—Сабреддит проекта; null, если он не указан.
data.supply.github_urlstring|null—Основной репозиторий исходного кода проекта; null, если он не указан.
data.supply.whitepaper_urlstring—Ссылка на технический документ (white paper) проекта.
data.supply.explorer_urlstring—Ссылка на обозреватель блоков для монеты.
data.supply.categorystring—Категория.
data.supply.asofnumbermsВремя самых новых использованных данных.
data.supply.staleboolean—Строки или флаг для данных старше окна актуальности.
data.supply.spot_vol_usdnumberUSDСумма спотового объёма монеты за 24h по спотовым биржам, данные которых CoinBoss собирает сам (последний снимок); null, если данные не собираются.
data.supply.futures_vol_usdnumberUSDСумма фьючерсного объёма за 24h по всем биржам, тикер которых свежее 1 часа; то же значение, что и `futures_vol.total_usd`; null, если собственных данных нет.
data.supply.oi_total_usdnumberUSDАгрегированный открытый интерес монеты по всем биржам и типам контрактов; то же значение, что и `oi.total_usd`; null, если собственных данных нет.
data.supply.high_24hstring(decimal)—Максимум за 24h.
data.supply.low_24hstring(decimal)—Минимум за 24h.
data.futures_vol_chg_pctnumber%Изменение фьючерсного объёма за 24h: по биржам, присутствующим и сейчас, и в почасовом снимке примерно 24 часа назад, (Σ текущих − Σ предыдущих) ÷ Σ предыдущих.
data.oi_chg_pctnumber%Изменение открытого интереса за 24h, рассчитанное по контрактам, присутствующим и сейчас, и в почасовом снимке, ближайшем к моменту 24 часа назад.
data.oiobject—Открытый интерес.
data.oi.total_usdnumberUSDВсего.
data.oi.local_usdnumberUSDОткрытый интерес, суммированный по данным собственного сбора CoinBoss по биржам; совпадает с `oi.total_usd`.
data.oi.by_exchangearray—Разбивка по биржам.
data.oi.by_exchange[]object—Разбивка по биржам.
data.oi.by_exchange[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
data.oi.by_exchange[].oi_usdnumberUSDОткрытый интерес (номинал в USD).
data.oi.n_exchangesnumber—Число учтённых бирж.
data.oi.asofnumbermsВремя самых новых использованных данных.
data.oi.chg_basisobject—Входные данные для `oi_chg_pct`: сопоставленные текущая и предыдущая суммы (`cur`, `prev`), число сопоставленных бирж, час базы сравнения и исключённые застывшие контракты.
data.oi.chg_basis.curnumber—Текущее значение.
data.oi.chg_basis.prevnumber—Предыдущее значение (база сравнения).
data.oi.chg_basis.n_matchednumber—Элементы, присутствующие на обоих концах сравнения.
data.oi.chg_basis.prev_hour_tsnumbermsНачало предыдущего часового интервала.
data.oi.chg_basis.frozen_excludedobject—Строки, исключённые потому, что значение источника не менялось.
data.oi.chg_basis.frozen_excluded.n_baselinenumber—Элементы в базовом снимке.
data.oi.chg_basis.frozen_excluded.n_currentnumber—Элементы в текущем снимке.
data.oi.chg_basis.frozen_excluded.cur_usdnumberUSDТекущее значение.
data.oi.chg_basis.frozen_excluded.prev_usdnumberUSDБазовое значение.
data.futures_volobject—Фьючерсный объём.
data.futures_vol.total_usdnumberUSDВсего.
data.futures_vol.n_exchangesnumber—Число учтённых бирж.
data.futures_vol.chg_basisobject—Входные данные для `futures_vol_chg_pct`: сопоставленные текущая и предыдущая суммы объёма (`cur`, `prev`), число сопоставленных бирж и час базы сравнения.
data.futures_vol.chg_basis.curnumber—Текущее значение.
data.futures_vol.chg_basis.prevnumber—Предыдущее значение (база сравнения).
data.futures_vol.chg_basis.n_matchednumber—Элементы, присутствующие на обоих концах сравнения.
data.futures_vol.chg_basis.prev_hour_tsnumbermsНачало предыдущего часового интервала.
data.fundingnumber—Блок или значение ставки финансирования.
data.funding_detailobject—Расшифровка `funding`: простое и взвешенное по открытому интересу средние ставок, приведённых к 8h, ставка в годовом выражении, число бирж и по одной записи на биржу.
data.funding_detail.basisstring—Цена фьючерса минус спотовая цена либо блок базиса.
data.funding_detail.avg_8hnumber—Среднее ставок, приведённых к 8h.
data.funding_detail.oi_weighted_8hnumber—Среднее ставок, приведённых к 8h, взвешенное по открытому интересу.
data.funding_detail.apr_pctnumber% per yearЗначение в процентах годовых.
data.funding_detail.n_exchangesnumber—Число учтённых бирж.
data.funding_detail.n_normalizednumber—Биржи, ставки которых приведены к 8h.
data.funding_detail.n_unknown_intervalnumber—Биржи с неизвестным интервалом финансирования.
data.funding_detail.by_exchangearray—Разбивка по биржам.
data.funding_detail.by_exchange[]object—Разбивка по биржам.
data.funding_detail.by_exchange[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
data.funding_detail.by_exchange[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
data.funding_detail.by_exchange[].ratenumber—Ставка.
data.funding_detail.by_exchange[].interval_hnumberhИнтервал.
data.funding_detail.by_exchange[].rate_8hnumber—Ставка, приведённая к 8-часовому периоду.
data.funding_detail.by_exchange[].next_funding_timenumber|nullmsМетка времени.
data.long_shortobject—Блок лонг/шорт.
data.long_short.longnumber—Значение стороны лонг.
data.long_short.shortnumber—Значение стороны шорт.
data.long_short.rationumber—Соотношение.
data.long_short.typestring—Тип.
data.long_short.n_exchangesnumber—Число учтённых бирж.
data.derivedobject—Периодически пересчитываемые индикаторы монеты (RSI, базис, агрегированный открытый интерес, среднее финансирование, доли лонгов и шортов, ликвидации за 24h); null, если они не рассчитаны.
data.derived.rsi_1hstring(decimal)—RSI(14) по свечам 1h.
data.derived.rsi_4hstring(decimal)—RSI(14) по свечам 4h.
data.derived.rsi_1dstring(decimal)—RSI(14) по дневным свечам.
data.derived.basis_pctstring(decimal)|null%(futures − spot) / spot × 100.
data.derived.basis_annual_pctnull% per yearБазис в годовом выражении с учётом числа дней до экспирации.
data.derived.oi_usd_aggstring(decimal)USDАгрегированный открытый интерес по всем биржам и типам контрактов на момент последнего обновления индикаторов; может немного отставать от `oi.total_usd`.
data.derived.funding_avgstring(decimal)—Средняя ставка финансирования по биржам.
data.derived.ls_accountstring(decimal)—Соотношение лонг/шорт по счетам.
data.derived.ls_takerstring(decimal)|null—Соотношение покупок/продаж тейкеров.
data.derived.liq_24h_usdstring(decimal)USDЛиквидации за 24h.
data.liquidationobject—Блок ликвидаций. динамические ключи: 1h,4h,12h,24h
data.liquidation.{*}object—Блок ликвидаций.
data.liquidation.{*}.winstring—Обозначение окна записи, повторяющее её ключ (`1h`, `4h`, `12h` или `24h`).
data.liquidation.{*}.long_usdnumberUSDСторона лонг.
data.liquidation.{*}.short_usdnumberUSDСторона шорт.
data.liquidation.{*}.total_usdnumberUSDВсего.
data.liquidation.{*}.cntnumber—Количество.

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

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

/api/currency/overview?coin=BTC · Реальный ответ, получен 2026-11-13 03:57:31 UTC. Длинные массивы и словари сокращены для отображения: data.liquidation: элементов было 4; data.oi.by_exchange: элементов было 22; data.funding_detail.by_exchange: элементов было 23.

  • {
    • "success": true,
    • "data": {
      • "coin": "BTC",
      • "supply": { … 22 },
      • "futures_vol_chg_pct": 67.76,
      • "oi_chg_pct": -3.65,
      • "oi": { … 6 },
      • "futures_vol": { … 3 },
      • "funding": 0.000057831612725940206,
      • "funding_detail": { … 8 },
      • "long_short": { … 5 },
      • "derived": { … 10 },
      • "liquidation": { … 2 }
      }
    }

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

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

ПараметрыHTTPЗадержкаРезультат
coin=ETH20086 msПройдено
coin=SOL20081 msПройдено
coin=ARKM20079 msПройдено

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

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
30s
Пограничный микрокеш
10s
Частота обновления
сторонний агрегатор рыночных данных — раз в 10 min; тикеры — раз в 1 min; OI / финансирование / лонг-шорт — раз в 5 min (основные монеты — раз в 1 min); спотовый объём — раз в 10 min; кеш в памяти 30 s
Окно
скользящие 24h для объёма и ликвидаций; последний снимок для OI / финансирования / лонг-шорт
Источники данных
Предложение, капитализация и ранг поступают от стороннего агрегатора рыночных данных; цена, открытый интерес, финансирование, лонг/шорт, фьючерсный и спотовый объём агрегируются самостоятельно из публичных API бирж; ликвидации — из потоков ликвидаций бирж.
Покрытие бирж
Любая монета из таблицы, построенной на данных стороннего агрегатора рыночных данных, либо монета с торгуемым деривативным контрактом
Пагинация
нет
Единицы измерения
USD; rates as decimals; changes in percent
Метод расчёта
OI = SUM(oi_usd) over fresh contracts incl. multiplier contracts (3h; CME 120h); funding = OI-weighted mean of rate normalized to 8h (rate * 8 / interval_hours)
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный

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

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

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

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

Ошибки

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

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

string — Base coin symbol (uppercase, e.g. BTC).

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