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

Распределение объёма опционов

Распределение объёма опционов (по страйкам или датам экспирации)

GET/api/options/volume-dist
Одна площадка: рассчитывается только по публичным данным об опционах Deribit. Поля вида `volume_usd` основаны на премии там, где площадка сообщает оборот по премии. Данные по шести площадкам с покрытием по каждой из них возвращает `/api/sd/options/overview`.

Запрос

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

ИмяТипОбязательныйПо умолчаниюДопустимые значенияОписание
currencystringНеобязательныйBTCBTC, ETHБазовый актив: `BTC` или `ETH`. Любое другое значение возвращает 400 `INVALID_PARAM`. Псевдоним: `coin`. Пример: BTC
dimstringНеобязательныйstrikestrike, expiryИзмерение распределения. Пример: strike

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

curl -s "https://www.coinboss.com/api/options/volume-dist?currency=BTC&dim=strike"

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
currencystring—Символ валюты / актива.
dimstring—Измерение группировки, применённое к `data`: `strike` (по умолчанию) или `expiry`.
index_pricenumber—Индексная цена базового актива.
dataarray—Полезные данные.
data[]object—Полезные данные.
data[].keynumber—Ключ.
data[].call_vol_usdnumberUSDОбъём коллов этой группы за 24 часа в USD по данным Deribit (оборот по премии, а не номинал).
data[].put_vol_usdnumberUSDОбъём путов этой группы за 24 часа в USD по данным Deribit (оборот по премии, а не номинал).
data[].call_volnumbercoinОбъём торгов коллами этой группы за 24 часа, в единицах базовой монеты.
data[].put_volnumbercoinОбъём торгов путами этой группы за 24 часа, в единицах базовой монеты.

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

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

/api/options/volume-dist?currency=BTC&dim=strike · Реальный ответ, получен 2026-11-13 04:02:55 UTC. Длинные массивы и словари сокращены для отображения: data: элементов было 88.

  • {
    • "success": true,
    • "currency": "BTC",
    • "dim": "strike",
    • "index_price": 69009.96,
    • "data": [
      • { … 5 },
      • { … 5 }
      ]
    }

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

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

ПараметрыHTTPЗадержкаРезультат
dim=strike&currency=ETH2002 msПройдено
dim=strike&currency=SOL4001 msПройдено возвращает ожидаемую ошибку

Проверено: 2026-11-13 03:58:25 UTC

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
5m
Пограничный микрокеш
10s
Частота обновления
раз в 10 min (полная замена снимка)
Окно
последний снимок объёма за 24h
Источники данных
Распределение объёма опционов за 24h по страйкам или датам экспирации из публичного API одной биржи (Deribit).
Покрытие бирж
Только Deribit, опционы на BTC и ETH; другие площадки (опционы Binance/OKX/Bybit, CME) не включены. Только будущие даты экспирации.
Сортировка
по возрастанию страйка или даты экспирации
Единицы измерения
USD and coins
Метод расчёта
Call and put 24h volume summed per strike (`dim=strike`, default) or per expiry (`dim=expiry`).
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный

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

ДоступенПроверено: 2026-11-13 03:58:25 UTCHTTP 2002 msСхема совпадает

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

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

Ошибки

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

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

string · по умолчанию BTC — Underlying: `BTC` or `ETH`. Any other value returns 400 `INVALID_PARAM`. Alias: `coin`.

string · по умолчанию strike — Distribution dimension.

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