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

Обзор опционов (все площадки)

Открытый интерес опционов, объём за 24h, соотношения пут/колл, макс. боль, подразумеваемая волатильность ATM, перекос 25-дельта и временная структура IV по одной монете — агрегат по шести площадкам с разбивкой по каждой из них.

GET/api/sd/options/overview
Деградация. Эндпоинт сообщает качество данных STALE

Запрос

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

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

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

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

Поля ответа

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

ПолеТипЕдиницаОписание
successboolean—true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
schemastring—Идентификатор схемы этого ответа. Меняется только тогда, когда у существующего поля меняется смысл или тип.
nownumbermsВремя сервера в момент формирования ответа.
coinstring—Символ монеты (в верхнем регистре).
index_pricenumber|nullUSDСпотовая индексная цена, используемая для пересчёта в USD (в агрегатах — медиана собственных индексных цен площадок).
n_contractsnumber|null—Число учтённых опционных контрактов.
oi_usdnumber|nullUSDОткрытый интерес как номинал в USD: количество монет × спотовая индексная цена. Односторонний.
call_oi_usdnumber|nullUSDОткрытый интерес по коллам, номинал в USD.
put_oi_usdnumber|nullUSDОткрытый интерес по путам, номинал в USD.
oi_coinnumber|nullcoinОткрытый интерес в единицах базовой монеты.
call_oi_coinnumber|nullcoinОткрытый интерес по коллам в единицах базовой монеты.
put_oi_coinnumber|nullcoinОткрытый интерес по путам в единицах базовой монеты.
vol_usd_24hnumber|nullUSDНоминальный объём за 24h: проторгованное количество монет × текущая спотовая индексная цена. Не является оборотом по премии.
call_vol_usd_24hnumber|nullUSDНоминальный объём коллов за 24h.
put_vol_usd_24hnumber|nullUSDНоминальный объём путов за 24h.
vol_coin_24hnumber|nullcoinКоличество, проторгованное за 24h, в единицах базовой монеты.
call_vol_coin_24hnumber|nullcoinКоличество коллов, проторгованное за 24h, в монетах.
put_vol_coin_24hnumber|nullcoinКоличество путов, проторгованное за 24h, в монетах.
vol_premium_usd_24hnumber|nullUSDОборот по премии за 24h (цена опциона × количество), если площадка его публикует; в остальных случаях `null`. Никогда не суммируется с номинальным объёмом.
pcr_oinumber|nullratioОткрытый интерес по путам ÷ открытый интерес по коллам, в единицах монеты; `null`, если сторона коллов равна 0.
pcr_volnumber|nullratioОбъём путов за 24h ÷ объём коллов за 24h, в единицах монеты; `null`, если сторона коллов равна 0.
n_expiriesnumber|null—Число учтённых дат экспирации.
vol_exchangesarray—Площадки, учтённые в номинальном объёме.
vol_exchanges[]string—Площадки, учтённые в номинальном объёме.
vol_premium_exchangesarray—Площадки, публикующие оборот по премии.
vol_premium_exchanges[]string—Площадки, публикующие оборот по премии.
max_pain_nearestobject|null—Макс. боль ближайшей даты экспирации с открытым интересом.
max_pain_nearest.expirystring—Дата экспирации (UTC), `YYYY-MM-DD`, или `all`.
max_pain_nearest.days_leftnumberdaysЧисло дней до экспирации.
max_pain_nearest.strikenumberUSDЦена страйка.
max_pain_nearest.pain_usdnumberUSDСуммарная выплата держателям опционов, если расчёт на экспирации пройдёт по этому страйку.
max_pain_nearest.oi_usdnumberUSDОткрытый интерес как номинал в USD: количество монет × спотовая индексная цена. Односторонний.
max_pain_nearest.exchangesarray—Площадки, учтённые в этой строке.
max_pain_nearest.exchanges[]string—Площадки, учтённые в этой строке.
max_pain_mainobject|null—Макс. боль основной даты экспирации: ближайшей даты экспирации, на которую приходится не менее 5 % общего открытого интереса.
max_pain_main.expirystring—Дата экспирации (UTC), `YYYY-MM-DD`, или `all`.
max_pain_main.days_leftnumberdaysЧисло дней до экспирации.
max_pain_main.strikenumberUSDЦена страйка.
max_pain_main.pain_usdnumberUSDСуммарная выплата держателям опционов, если расчёт на экспирации пройдёт по этому страйку.
max_pain_main.oi_usdnumberUSDОткрытый интерес как номинал в USD: количество монет × спотовая индексная цена. Односторонний.
max_pain_main.exchangesarray—Площадки, учтённые в этой строке.
max_pain_main.exchanges[]string—Площадки, учтённые в этой строке.
atm_iv_nearestnumber|null%ATM IV ближайшей даты экспирации.
atm_iv_mainnumber|null%ATM IV основной даты экспирации.
atm_iv_30dnumber|null%ATM IV, линейно интерполированная к постоянному сроку 30 дней; `null`, если 30 дней не попадают между двумя датами экспирации.
skew_25d_mainnumber|nullpercentage pointsПерекос 25-дельта основной даты экспирации.
term_structurearray—ATM IV по датам экспирации, начиная с ближайшей.
term_structure[]object—ATM IV по датам экспирации, начиная с ближайшей.
term_structure[].expirystring—Дата экспирации (UTC), `YYYY-MM-DD`, или `all`.
term_structure[].days_leftnumberdaysЧисло дней до экспирации.
term_structure[].atm_ivnumber%Подразумеваемая волатильность на деньгах: средняя IV по цене маркировки на страйке, ближайшем к форвардной цене.
term_structure[].oi_usdnumberUSDОткрытый интерес как номинал в USD: количество монет × спотовая индексная цена. Односторонний.
exchangesarray—Площадки, учтённые в этой строке.
exchanges[]object—Площадки, учтённые в этой строке.
exchanges[].exchangestring—Идентификатор биржи (в нижнем регистре).
exchanges[].oi_share_pctnumber%Доля в общем открытом интересе (номинал в USD) выборки.
exchanges[].n_contractsnumber—Число учтённых опционных контрактов.
exchanges[].oi_usdnumberUSDОткрытый интерес как номинал в USD: количество монет × спотовая индексная цена. Односторонний.
exchanges[].call_oi_usdnumberUSDОткрытый интерес по коллам, номинал в USD.
exchanges[].put_oi_usdnumberUSDОткрытый интерес по путам, номинал в USD.
exchanges[].oi_coinnumbercoinОткрытый интерес в единицах базовой монеты.
exchanges[].call_oi_coinnumbercoinОткрытый интерес по коллам в единицах базовой монеты.
exchanges[].put_oi_coinnumbercoinОткрытый интерес по путам в единицах базовой монеты.
exchanges[].vol_usd_24hnumberUSDНоминальный объём за 24h: проторгованное количество монет × текущая спотовая индексная цена. Не является оборотом по премии.
exchanges[].call_vol_usd_24hnumberUSDНоминальный объём коллов за 24h.
exchanges[].put_vol_usd_24hnumberUSDНоминальный объём путов за 24h.
exchanges[].vol_coin_24hnumbercoinКоличество, проторгованное за 24h, в единицах базовой монеты.
exchanges[].call_vol_coin_24hnumbercoinКоличество коллов, проторгованное за 24h, в монетах.
exchanges[].put_vol_coin_24hnumbercoinКоличество путов, проторгованное за 24h, в монетах.
exchanges[].vol_premium_usd_24hnumber|nullUSDОборот по премии за 24h (цена опциона × количество), если площадка его публикует; в остальных случаях `null`. Никогда не суммируется с номинальным объёмом.
exchanges[].pcr_oinumberratioОткрытый интерес по путам ÷ открытый интерес по коллам, в единицах монеты; `null`, если сторона коллов равна 0.
exchanges[].pcr_volnumberratioОбъём путов за 24h ÷ объём коллов за 24h, в единицах монеты; `null`, если сторона коллов равна 0.
exchanges[].n_expiriesnumber—Число учтённых дат экспирации.
exchanges[].oi_usd_inversenumber|nullUSDОткрытый интерес контрактов с расчётами в монете.
exchanges[].oi_usd_linearnumberUSDОткрытый интерес контрактов с расчётами в стейблкоине.
exchanges[].oi_usd_reportednumber|nullUSDСобственное значение открытого интереса в USD от площадки, если она его публикует. Только для перекрёстной проверки.
exchanges[].vol_usd_reported_24hnumber|nullUSDСобственное значение номинального оборота от площадки, если она его публикует. Только для перекрёстной проверки.
exchanges[].index_pricenumberUSDСпотовая индексная цена, используемая для пересчёта в USD (в агрегатах — медиана собственных индексных цен площадок).
exchanges[].received_atnumbermsВремя получения данных коллектором CoinBoss.
exchanges[].observed_atnumber|nullmsМетка времени, указанная источником для данных.
exchanges[].age_snumbersЧисло секунд с момента получения строки.
exchanges[].is_staleboolean—True, если данные старше своего окна актуальности.
coverageobject—Что входит и что не входит в эти значения. Сверьтесь с этим блоком, прежде чем сравнивать итоги с другим источником.
coverage.included_exchangesarray—Источники, актуальные данные которых учтены.
coverage.included_exchanges[]string—Источники, актуальные данные которых учтены.
coverage.unavailablearray—Источники, которые не удалось включить, с указанием причины для каждого. Они никогда не учитываются как 0.
coverage.unavailable[]object—Источники, которые не удалось включить, с указанием причины для каждого. Они никогда не учитываются как 0.
coverage.unavailable[].exchangestring—Идентификатор биржи (в нижнем регистре).
coverage.unavailable[].reasonstring—Машиночитаемый код причины.
coverage.unavailable[].detailstring—Понятное человеку объяснение причины.
coverage.stale_excludedarray—Строки, не учтённые потому, что их последнее обновление выходит за окно актуальности. пусто в образцах, по которым построена таблица
coverage.field_gapsarray—Столбцы, которые площадка не публикует; для этой площадки они равны `null`.
coverage.field_gaps[]object—Столбцы, которые площадка не публикует; для этой площадки они равны `null`.
coverage.field_gaps[].exchangestring—Идентификатор биржи (в нижнем регистре).
coverage.field_gaps[].fieldsarray—Названия отсутствующих столбцов.
coverage.field_gaps[].fields[]string—Названия отсутствующих столбцов.
coverage.field_gaps[].kindstring—Семейство контрактов: `inverse` (с расчётами в монете) или `linear` (с расчётами в стейблкоине).
methodobject—Текстовое описание формул, использованных для этого ответа, по одной записи на поле.
method.oi_usdstring—Пояснение к формуле для `oi_usd`, обычный текст.
method.vol_usd_24hstring—Пояснение к формуле для `vol_usd_24h`, обычный текст.
method.vol_premium_usd_24hstring—Пояснение к формуле для `vol_premium_usd_24h`, обычный текст.
method.pcr_oistring—Пояснение к формуле для `pcr_oi`, обычный текст.
method.pcr_volstring—Пояснение к формуле для `pcr_vol`, обычный текст.
method.max_painstring—Пояснение к формуле для `max_pain`, обычный текст.
method.atm_ivstring—Пояснение к формуле для `atm_iv`, обычный текст.
method.atm_iv_30dstring—Пояснение к формуле для `atm_iv_30d`, обычный текст.
method.skew_25dstring—Пояснение к формуле для `skew_25d`, обычный текст.
method.oi_share_pctstring—Пояснение к формуле для `oi_share_pct`, обычный текст.
method.index_pricestring—Пояснение к формуле для `index_price`, обычный текст.
method.max_pain_mainstring—Пояснение к формуле для `max_pain_main`, обычный текст.
method.oi_usd_reportedstring—Пояснение к формуле для `oi_usd_reported`, обычный текст. может отсутствовать
method.vol_usd_reported_24hstring—Пояснение к формуле для `vol_usd_reported_24h`, обычный текст. может отсутствовать
metaobject—Происхождение данных и актуальность этого ответа.
meta.schemastring—Идентификатор схемы этого ответа. Меняется только тогда, когда у существующего поля меняется смысл или тип.
meta.sourcearray—Публичные эндпоинты источников, из которых собраны данные.
meta.source[]object—Публичные эндпоинты источников, из которых собраны данные.
meta.source[].exchangestring—Идентификатор биржи (в нижнем регистре).
meta.source[].endpointstring—Публичный эндпоинт источника, который читает коллектор (показан для сведений о происхождении данных; клиенты его не вызывают).
meta.observed_atnumber|nullmsМетка времени, указанная источником для данных.
meta.received_atnumber|nullmsВремя получения данных коллектором CoinBoss.
meta.fetched_atnumbermsВремя формирования этого ответа.
meta.windowstring—Временное окно, которое охватывают значения.
meta.qualitystring—FRESH, PARTIAL, STALE, BROKEN или UNAVAILABLE — оценка по меткам времени данных и покрытию.
meta.is_staleboolean—True, если данные старше своего окна актуальности.
meta.cache_ttl_snumbersВремя жизни кеша этого ответа.
meta.fallbackstring—Что возвращает эндпоинт при сбое коллектора или источника.

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

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

/api/sd/options/overview?coin=BTC · Реальный ответ, получен 2026-11-13 03:58:21 UTC. Длинные массивы и словари сокращены для отображения: exchanges: элементов было 6; meta.source: элементов было 6; term_structure: элементов было 12; coverage.field_gaps: элементов было 4; coverage.unavailable: элементов было 12; coverage.stale_included: элементов было 6.

  • {
    • "success": true,
    • "schema": "coinboss.sd.options/1",
    • "now": 1794542301260,
    • "coin": "BTC",
    • "index_price": 71498.15576087,
    • "n_contracts": 5792,
    • "oi_usd": 32670143083.84,
    • "call_oi_usd": 18276964561.96,
    • "put_oi_usd": 14393178521.88,
    • "oi_coin": 457419.65,
    • "call_oi_coin": 255899.54,
    • "put_oi_coin": 201520.11,
    • "vol_usd_24h": 4295495191.7,
    • "call_vol_usd_24h": 2031780368.24,
    • "put_vol_usd_24h": 2263714823.46,
    • "vol_coin_24h": 60122.56,
    • "call_vol_coin_24h": 28436.77,
    • "put_vol_coin_24h": 31685.79,
    • "vol_premium_usd_24h": 34033631.12,
    • "pcr_oi": 0.7875,
    • "pcr_vol": 1.1143,
    • "n_expiries": 12,
    • "vol_exchanges": [
      • "binance",
      • "bybit",
      • "coincall",
      • "deribit",
      • "gate",
      • "okx"
      ],
    • "vol_premium_exchanges": [
      • "binance",
      • "deribit",
      • "gate"
      ],
    • "max_pain_nearest": {
      • "expiry": "2026-11-13",
      • "days_left": 0.1678,
      • "strike": 75000,
      • "pain_usd": 15831410,
      • "oi_usd": 3892192707.39,
      • "exchanges": [ … 6 ]
      },
    • "max_pain_main": {
      • "expiry": "2026-11-13",
      • "days_left": 0.1678,
      • "strike": 75000,
      • "pain_usd": 15831410,
      • "oi_usd": 3892192707.39,
      • "exchanges": [ … 6 ]
      },
    • "atm_iv_nearest": 40.28,
    • "atm_iv_main": 40.28,
    • "atm_iv_30d": 37.2,
    • "skew_25d_main": 6.6,
    • "term_structure": [
      • { … 4 },
      • { … 4 }
      ],
    • "exchanges": [
      • { … 28 },
      • { … 28 }
      ],
    • "coverage": {
      • "included_exchanges": [ … 6 ],
      • "unavailable": [ … 2 ],
      • "stale_excluded": [],
      • "field_gaps": [ … 2 ],
      • "stale_included": [ … 2 ]
      },
    • "method": {
      • "oi_usd": "sum over contracts of oi_coin x that exchange's spot index price (USDT/USDC treated 1:1 as USD); oi_coin is open interest in units of the underlying coin after …",
      • "vol_usd_24h": "NOTIONAL 24h volume = sum of vol_coin (24h traded quantity in underlying coin) x the exchange's CURRENT spot index price; not premium turnover. Binance statisti…",
      • "vol_premium_usd_24h": "PREMIUM turnover (option price x quantity) as reported by the exchange: Deribit volume_usd, Binance amount, Gate sum(|size| x multiplier x price) from the 24h t…",
      • "pcr_oi": "put open interest / call open interest, both in underlying-coin units; null when call side is 0 or missing",
      • "pcr_vol": "put 24h volume / call 24h volume, both in underlying-coin units; null when call side is 0 or missing",
      • "max_pain": "per expiry: settlement price S among strikes with OI>0 minimizing pain_usd(S) = sum_calls oi_coin x max(S-K,0) + sum_puts oi_coin x max(K-S,0); ties take the lo…",
      • "atm_iv": "per exchange and expiry: reference price F = median of the exchange-published forward/underlying price of that expiry (the exchange index price where no forward…",
      • "atm_iv_30d": "30-day constant-maturity ATM IV: linear interpolation in days between the two expiries bracketing 30 days; null when 30 days is not bracketed",
      • "skew_25d": "IV(put with delta closest to -0.25, within +-0.10) - IV(call with delta closest to +0.25, within +-0.10), in percentage points, using exchange-published deltas …",
      • "oi_share_pct": "exchange oi_usd / sum of oi_usd over included exchanges x 100",
      • "index_price": "median of the included exchanges' own spot index prices",
      • "max_pain_main": "main expiry = nearest expiry holding >=5% of total OI notional (same rule as legacy /api/options/overview); max_pain_nearest = nearest listed expiry with OI",
      • "oi_usd_reported": "sum of the exchange's own USD figure where it publishes one (Binance sumOpenInterestUsd, OKX oiUsd), for cross-checking only; null elsewhere",
      • "vol_usd_reported_24h": "exchange-reported notional turnover where published (Bybit turnover24h), for cross-checking only; null elsewhere"
      },
    • "meta": {
      • "schema": "coinboss.sd.options/1",
      • "source": [ … 2 ],
      • "observed_at": 1794522472654,
      • "received_at": 1794522473814,
      • "fetched_at": 1794542301260,
      • "window": "latest",
      • "quality": "STALE",
      • "is_stale": true,
      • "cache_ttl_s": 60,
      • "fallback": "on collector failure the last stored rows are served: an exchange whose newest batch is older than 25 min (collector cycle is 10 min) is excluded from totals (l…"
      }
    }

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

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

ПараметрыHTTPЗадержкаРезультат
coin=ETH20066 msПройдено STALE
coin=SOL20022 msПройдено STALE
coin=PEPE2002 msПройдено UNAVAILABLE
—4001 msПройдено возвращает ожидаемую ошибку

Проверено: 2026-11-13 03:28:18 UTC

Сведения

Аутентификация
Не требуется. Публичный эндпоинт.
Лимит запросов
1200 запросов в минуту на один IP
Серверный кеш
60s
Пограничный микрокеш
10s
Частота обновления
Цикл коллектора — каждые 10 минут; площадка считается актуальной в течение 25 минут после последнего успешного цикла.
Окно
Последний снимок; поля объёма охватывают последние 24 часа в том виде, в каком их сообщает каждая площадка.
Источники данных
Публичные REST-эндпоинты опционов Deribit, Binance, Bybit, OKX, Gate и Coincall; данные собирает и хранит CoinBoss (sd_opt_latest, sd_opt_summary_hourly). Сторонние агрегаторы не используются.
Покрытие бирж
Шесть опционных площадок. Для монеты, по которой на выбранных площадках нет торгуемых опционов, возвращается HTTP 200 с полями null, `meta.quality = "UNAVAILABLE"` и причиной в `coverage.unavailable`. Площадки без публичной ленты опционов также перечислены там.
Единицы измерения
USD notional = contracts × contract size × spot index price of the venue. `*_coin` fields are in units of the underlying coin. Implied volatility is in percent (55 = 55 %). `vol_premium_usd_24h` is premium turnover, reported separately and never added to notional volume.
Метод расчёта
pcr_oi = put OI ÷ call OI (coin units). Max pain = the strike that minimises the total intrinsic value paid to option holders at expiry. ATM IV = mean mark IV of the contracts at the strike closest to the forward price published by the venue for that expiry; `atm_iv_30d` is interpolated linearly between the two expiries that bracket 30 days. skew_25d = IV(put with delta closest to −0.25) − IV(call with delta closest to +0.25), in percentage points, using deltas published by the venues only.
Метки времени
Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа
json
Стабильность
Стабильный
Доступен с
2026-11-11

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

ДеградацияПроверено: 2026-11-13 03:52:55 UTCHTTP 20057 msСхема совпадаетВозраст самой новой точки данных: 5.4h

Эндпоинт сообщает качество данных STALE

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

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

Расхождение схемы, обнаруженное последней автопроверкой
  • Возвращается, но не документировано: coverage.stale_included, coverage.stale_included[], coverage.stale_included[].exchange, coverage.stale_included[].age_s

Ошибки

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

Код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/options/overviewДеградация
Параметры

string — Coin symbol, case-insensitive (for example `BTC`). Missing or malformed values return 400.

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