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

Фьючерсный объём по одной монете

Собственный слой данных: фьючерсный объём по одной монете

GET/api/sd/volume

Запрос

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

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

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

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

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
coinstring—Символ монеты в верхнем регистре (например, BTC).
nownumbermsВремя сервера в момент формирования ответа.
futuresobject—Блок или значение фьючерсного рынка.
futures.total_usdnumberUSDФьючерсный объём за 24h по биржам (номинал в USD).
futures.n_exchangesnumber—Число учтённых бирж.
futures.by_exchangearray—Разбивка по биржам.
futures.by_exchange[]object—Разбивка по биржам.
futures.by_exchange[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
futures.by_exchange[].vol_usdnumberUSDОбъём (номинал в USD).
futures.by_exchange[].legacy_usdnumberUSDЧасть объёма, приходящаяся на набор тикеров бессрочных контрактов USDT.
futures.by_exchange[].sd_usdnumberUSDЧасть, приходящаяся на уже включённые дополнительные контракты (USDC, с маржой в монете, срочные).
futures.by_exchange[].share_pctnumber%Доля в общем значении.
futures.change_24hobject—Изменение за 24h.
futures.change_24h.pctnumber%Значение в процентах.
futures.change_24h.curnumber—Текущее значение.
futures.change_24h.prevnumber—Предыдущее значение (база сравнения).
futures.change_24h.n_matchednumber—Элементы, присутствующие на обоих концах сравнения.
futures.change_24h.n_totalnumber—Элементы, присутствующие сейчас.
futures.change_24h.prev_tsnumbermsВремя базового снимка.
futures.change_24h.basisstring—Цена фьючерса минус спотовая цена либо блок базиса.
futures.selfdata_contractsobject—Дополнительные контракты: что уже включено и что ещё ожидает включения.
futures.selfdata_contracts.included_usdnullUSDОбъём за 24h по дополнительно собираемым контрактам (с маржой в монете, в USDC, срочным), уже учтённый во фьючерсном итоге; null, если пока не учтён ни один.
futures.selfdata_contracts.n_includednumbercountЧисло дополнительно собираемых контрактов, учтённых во фьючерсном итоге (тех, у которых есть собственный снимок примерно 24-часовой давности).
futures.selfdata_contracts.pending_usdnumber|nullUSDСумма по ожидающим элементам; в итог не входит.
futures.selfdata_contracts.n_pendingnumbercountЧисло дополнительно собираемых контрактов, которые пока не учтены, поскольку у них нет собственной базы сравнения 24-часовой давности; крупнейшие перечислены в `pending`.
futures.selfdata_contracts.pendingarray—Элементы, которые собираются, но ещё не включены.
futures.selfdata_contracts.pending[]object—Элементы, которые собираются, но ещё не включены.
futures.selfdata_contracts.pending[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
futures.selfdata_contracts.pending[].symbolstring—Символ инструмента, нормализованный CoinBoss (например, BTCUSDT).
futures.selfdata_contracts.pending[].marginstring—Класс валюты маржи.
futures.selfdata_contracts.pending[].contract_typestring—`perpetual` или `delivery`.
futures.selfdata_contracts.pending[].vol_usdnumberUSDОбъём (номинал в USD).
futures.selfdata_contracts.pending[].reasonstring—Код причины.
spotobject—Блок или значение спотового рынка.
spot.total_usdnumberUSDСпотовый объём за 24h по биржам.
spot.n_exchangesnumber—Число учтённых бирж.
spot.asofnumbermsВремя самых новых использованных данных.
spot.by_exchangearray—Разбивка по биржам.
spot.by_exchange[]object—Разбивка по биржам.
spot.by_exchange[].exchangestring—Идентификатор биржи в нижнем регистре (например, `binance`).
spot.by_exchange[].vol_usdnumberUSDОбъём (номинал в USD).
spot.by_exchange[].quotestring—Валюты котировки, учтённые для этой биржи.
spot.by_exchange[].tsnumbermsМетка времени.
spot.by_exchange[].pricenumber—Последняя цена в валюте котировки (USD или USDT, если не указано иное).
spot.by_exchange[].age_snumbersЧисло секунд с последнего обновления этой строки.
spot.by_exchange[].share_pctnumber%Доля в общем значении.
spot.change_24hobject—Изменение за 24h.
spot.change_24h.pctnumber%Значение в процентах.
spot.change_24h.curnumber—Текущее значение.
spot.change_24h.prevnumber—Предыдущее значение (база сравнения).
spot.change_24h.n_matchednumber—Элементы, присутствующие на обоих концах сравнения.
spot.change_24h.n_totalnumber—Элементы, присутствующие сейчас.
spot.change_24h.prev_tsnumbermsВремя базового снимка.
spot.change_24h.basisstring—Цена фьючерса минус спотовая цена либо блок базиса.
ratiosobject—Отношения объёмов: `futures_to_spot` (фьючерсный объём за 24h ÷ спотовый объём за 24h) и `oi_to_futures_volume`; каждое равно null, если отсутствует одно из исходных значений.
ratios.futures_to_spotnumber—Фьючерсный объём, делённый на спотовый объём.
ratios.oi_to_futures_volumenumber—Открытый интерес, делённый на фьючерсный объём за 24h.
methodobject—Текстовое описание формул, использованных для этого ответа.
method.futuresstring—Блок или значение фьючерсного рынка.
method.spotstring—Блок или значение спотового рынка.
method.changestring—Изменение за указанный период.
method.oi_to_futures_volumestring—Текстовое определение `ratios.oi_to_futures_volume`: совокупный открытый интерес в USD ÷ фьючерсный объём за 24h в USD.

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

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

/api/sd/volume?coin=BTC · Реальный ответ, получен 2026-11-13 03:57:37 UTC. Длинные массивы и словари сокращены для отображения: spot.by_exchange: элементов было 14; futures.by_exchange: элементов было 23; futures.selfdata_contracts.pending: элементов было 5.

  • {
    • "success": true,
    • "coin": "BTC",
    • "now": 1794542257033,
    • "futures": {
      • "total_usd": 79049803843.06,
      • "n_exchanges": 23,
      • "by_exchange": [ … 2 ],
      • "change_24h": { … 7 },
      • "selfdata_contracts": { … 5 }
      },
    • "spot": {
      • "total_usd": 7929483908.44,
      • "n_exchanges": 14,
      • "asof": 1794541800000,
      • "by_exchange": [ … 2 ],
      • "change_24h": { … 7 }
      },
    • "ratios": {
      • "futures_to_spot": 9.9691,
      • "oi_to_futures_volume": 0.6197
      },
    • "method": {
      • "futures": "SUM of each exchange 24h quote turnover in USD for this coin's contracts (ticker fresh within 1h); self-collected coin-margined/USDC/delivery contracts are adde…",
      • "spot": "per exchange: 24h quote turnover summed over that exchange's USD/USDT/USDC-quoted spot pairs of the coin (quote = the largest pair); total = SUM over exchanges …",
      • "change": "same-exchange pairing: only exchanges with both a current value and a snapshot ~24h ago enter numerator and denominator",
      • "oi_to_futures_volume": "total open interest (USD) / 24h futures turnover (USD)"
      }
    }

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

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

ПараметрыHTTPЗадержкаРезультат
coin=ETH20038 msПройдено
coin=SOL20046 msПройдено
coin=ARKM20043 msПройдено
—4001 msПройдено возвращает ожидаемую ошибку

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

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
30s
Пограничный микрокеш
10s
Частота обновления
фьючерсные тикеры — раз в 60 s (контракты с маржой в монете / USDC / срочные — раз в 120 s); спотовые снимки — раз в 10 min
Окно
скользящий объём за 24 h в том виде, в каком его сообщает каждая площадка; изменение за 24 h — относительно собственного архива примерно 24 h назад
Источники данных
Фьючерсный объём за 24h от собственных коллекторов тикеров (24 площадки деривативов) и спотовый объём за 24h от собственных коллекторов спотовых тикеров (14 спотовых бирж, например binance, okx, bybit, coinbase, kraken, upbit).
Покрытие бирж
фьючерсы: до 24 площадок; спот: 14 бирж, пары с котировкой в USD / USDT / USDC
Единицы измерения
volumes in USD; changes in percent; ratios dimensionless
Метод расчёта
futures total = SUM(volume_usd) of tickers fresh within 1 h, plus non-USDT-perp contracts once they have their own ~24 h baseline; spot total = SUM of the latest per-exchange snapshot within 30 min; 24 h change by same-exchange pairing; ratios futures_to_spot and oi_to_futures_volume
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный
Доступен с
2026-11-11

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

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

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

Пройдено 100% из 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/sd/volumeДоступен
Параметры

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

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