Опционы
Опционы Deribit, Binance, Bybit и OKX по цепочкам — базы с ликвидностью, каталог с правилом поставки, экспирации с max pain, GEX, ATM IV и ожидаемым ходом, цепочка минуты, ряд волатильности книги, экспозиция и уровни GEX, живой поток, история цепочки за диапазон минут, покрытие сбора.
Опционы четырёх площадок — deribit, binance, bybit, okx — по цепочкам базы: базы площадок с ликвидностью, каталог инструментов, экспирации с суммами объёма и OI и расчётом (max pain, GEX, ATM IV, ожидаемый ход), цепочка одной минуты (котировки, mark, подразумеваемая волатильность, OI, объёмы, форвард и индекс), история одной цепочки за диапазон минут, ряд волатильности книги, экспозиция GEX, DEX, VEX и CEX новейшей минуты по страйкам, история уровней книги (zero gamma, стены, max pain), покрытие сбора и живой поток цепочек по WebSocket. Все десять маршрутов и поток — одна группа тарифа options.
База — монета, на которую выписаны опционы: BTC, ETH, SOL. У базы бывает несколько цепочек — например, у Deribit BTC (inverse) и BTC_USDC (linear). Инструмента в виде venue:market:SYMBOL здесь нет: площадку выбирает venue, базу — base, цепочку — chain.
Доступ
- Группа тарифа —
options. Пока тариф не задаёт ей своих лимитов, запросы к ней расходуют общие лимиты ключа (лимиты групп). Тариф, закрывший группу, получает403 route_not_in_plan. - Область —
derivatives. API-ключу нужна областьmarket:read— та же, что у остальных маршрутов. Токен терминала должен нести областьderivatives: у бесплатного её нет, ответ —403 insufficient_scope, к источнику запрос не уходит. - Площадка по умолчанию —
deribit, кроме/v1/options/bases: безvenueон отдаёт все четыре площадки. Какие базы и цепочки есть у площадки, говорит/v1/options/bases; база без опционов или чужая цепочка —400 upstream_rejectedсparam: "base"или"chain".
Единицы и null
| Что | Как приходит | Где |
|---|---|---|
| Время | Unix-мс UTC, целым | expiry_ms, ts_min, snap_ts, oi_asof_ms, last_ts_min, from_ms, to_ms, from, to, ts_ms, asof_ms, expiries_ms, max_pain_expiry_ms |
| Деньги | *_usd_e8 — целым числом строкой, USD, USDT или USDC × 10⁸: "16400000" — 0,164 USDT у binance. Валюта и смысл — по площадке, цепочке и полю, в таблице ниже. Со знаком — только gamma_usd_e8, gex_usd_e8, dex_usd_e8, vex_usd_e8, cex_usd_e8, gex_put_usd_e8 и net_gex_usd_e8 |
volume_usd_e8, volume_notional_usd_e8 — объёмы за 24 ч в деньгах; volume_24h_usd_e8, oi_usd_e8 — ликвидность баз, max_pain_payout_usd_e8, gamma_usd_e8 — расчёт экспираций, gex_usd_e8, dex_usd_e8, vex_usd_e8, cex_usd_e8, gex_call_usd_e8, gex_put_usd_e8 — экспозиция, net_gex_usd_e8 — история уровней, валюта — рядом в ответе |
| Цены | точной десятичной записью строкой, за 1 монету базы в валюте котировки цепочки: у settle: inverse — в монете базы (0.005 — BTC), у linear — в USD, USDT или USDC |
bid, ask, mark, tick_size, tick_steps |
| Форвард и индекс | десятичной строкой | forward, index |
| Страйк и размеры | десятичной строкой | strike, contract_size, min_trade |
| Количества | в контрактах, десятичной строкой; контракты × contract_size — монеты базы. volume — за 24 ч |
oi_asof, volume, bid_size, ask_size, oi_calls, oi_puts |
| OI экспирации в монетах | десятичной строкой: (Σ oi_asof call + Σ oi_asof put) × contract_size |
oi_coins |
| Волатильность | iv_bp — целым, в 0,01 пункта: 4872 — 48,72 % |
iv_bp, atm_iv_bp, IV ряда волатильности, rr25_bp_30d, bf25_bp_30d |
| Ожидаемый ход | целым, в базисных пунктах от форварда F: 273 — 2,73 % от F. Это доля цены, а не пункты волатильности |
move_straddle_bp, move_sigma_bp |
Деньги опционов — премия или номинал. Номинал в ответе есть только у Bybit, остальные деньги — премия. Валюта денег — не всегда валюта цен цепочки: у Deribit *_USDC цены в USDC, а volume_usd_e8 — в USD. Номинал у Deribit и Binance оценивайте сами: volume × contract_size × index. Премию с номиналом не сравнивайте, а суммы разных площадок не складывайте без оговорки: USDT — не USD. Разбирайте *_usd_e8 как целое произвольной длины или десятичный тип: значение бывает больше 2⁵³, а в число с плавающей точкой его не переводите. Деньги не округляются к шагу цены ни у нас, ни в ваших расчётах не должны. Цены и количества тоже не превращайте в double, пока не нужно: строка — точное значение площадки.
null — «нет данных», а не ноль. Поле, которого площадка не шлёт, — null всегда, в каждой строке цепочки и в суммах экспираций. Деньги и пропуски по цепочкам:
| Площадка | Цепочка BTC | volume_usd_e8 |
volume_notional_usd_e8 |
Не шлёт — всегда null |
|---|---|---|---|---|
deribit |
BTC — inverse |
премия, USD | нет | bid_size, ask_size, volume_notional_usd_e8 |
deribit |
BTC_USDC — linear, USDC |
премия, USD | нет | bid_size, ask_size, volume_notional_usd_e8 |
binance |
BTC — linear, USDT |
премия, USDT | нет | forward, bid_size, ask_size, volume_notional_usd_e8 |
bybit |
BTC — linear, USDT |
нет | номинал, USDT | volume_usd_e8 |
bybit |
BTC_USDC — linear, USDC; сейчас Bybit таких не листит |
нет | номинал, USDC | volume_usd_e8 |
okx |
BTC — inverse |
нет | нет | index, volume_usd_e8, volume_notional_usd_e8 |
okx |
BTC_UM — linear, USD |
нет | нет | index, volume_usd_e8, volume_notional_usd_e8 |
Остальное бывает null по случаю: нет котировки — null в bid или ask, а у Bybit и OKX — и в размере этой стороны; у Binance и OKX минута бывает записана без части снимка (в покрытии это дыра stream: oi или quotes) — тогда null в oi_asof или в полях тикера: котировках, их размерах, volume, у Binance ещё в volume_usd_e8 и index; суммы объёма экспирации без кадра — null; instrument: null — имени инструмента в каталоге нет.
OI — на момент oi_asof_ms, а не минуты. oi_asof строки — OI на момент oi_asof_ms её цепочки. У Deribit он на 8 часов раньше снимка минуты.
JSON — тело источника как есть: у catalog и chain поле venue первое, у expiries и coverage ключи по алфавиту. Разбирайте поля по именам, а не по порядку.
Валюта цепочки
Валюта цепочки — в ответе. settle, price_ccy, volume_usd_ccy и volume_notional_ccy приходят у цепочек каталога и минуты (chain, chain/latest) и у экспираций, settle и price_ccy — ещё у баз; в кадрах OPC1 и в ряду chain/range их нет — берите их из каталога или bases. price_ccy — валюта цен bid, ask, mark (у inverse — монета базы), volume_usd_ccy — валюта volume_usd_e8, volume_notional_ccy — валюта volume_notional_usd_e8; null — такого поля у цепочки нет. Все четыре — у цепочки, а не у инструмента: null в settle или price_ccy — у инструментов цепочки не одно значение.
| Площадка | Цепочка базы BTC | settle |
price_ccy |
volume_usd_ccy |
volume_notional_ccy |
|---|---|---|---|---|---|
deribit |
BTC |
inverse |
BTC |
USD |
null |
deribit |
BTC_USDC |
linear |
USDC |
USD |
null |
binance |
BTC |
linear |
USDT |
USDT |
null |
bybit |
BTC |
linear |
USDT |
null |
USDT |
bybit |
BTC_USDC |
linear |
USDC |
null |
USDC |
okx |
BTC |
inverse |
BTC |
null |
null |
okx |
BTC_UM |
linear |
USD |
null |
null |
Премия в долларах. volume_usd_e8 / 10⁸ — сумма в валюте volume_usd_ccy: у Deribit — USD (BTC и BTC_USDC) и у Binance — USDT. Долларами она становится только при volume_usd_ccy: "USD"; USDT и USDC переводите в USD своим курсом, а не 1 : 1. Номинал — так же, по volume_notional_ccy: у Bybit без суффикса — USDT, на *_USDC — USDC. Валюту берите из ответа, а не из этой таблицы: таблица — то, что площадки шлют сейчас.
Базы
/v1/options/basesБазы опционов и их цепочки по площадкам — то, что листингуется сейчас: settle, price_ccy, версия каталога, сколько инструментов и экспираций, ликвидность новейшей минуты. Группа тарифа — options.
| Параметр | Что |
|---|---|
venue |
площадка: deribit, binance, bybit, okx; строчными. Без параметра — все четыре: умолчания deribit у этого маршрута нет |
curl -s "https://market-api.lootx.trade/v1/options/bases" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"venues": [
{
"venue": "deribit",
"bases": [
{
"base": "BTC",
"volume_24h_usd_e8": "4810545000000000", "volume_ccy": "USD", "oi_usd_e8": null, "oi_ccy": null, "oi_asof_ms": 1795152664164,
"chains": [
{"chain": "BTC", "settle": "inverse", "price_ccy": "BTC", "catalog_ver": 13, "instruments": 950, "expiries": 12, "volume_24h_usd_e8": "4718235000000000", "volume_ccy": "USD", "oi_usd_e8": "1893412000000000000", "oi_ccy": "USD", "oi_asof_ms": 1795152664164},
{"chain": "BTC_USDC", "settle": "linear", "price_ccy": "USDC", "catalog_ver": 6, "instruments": 576, "expiries": 8, "volume_24h_usd_e8": "92310000000000", "volume_ccy": "USD", "oi_usd_e8": "61200000000000000", "oi_ccy": "USDC", "oi_asof_ms": 1795152665101}
]
}
]
},
{
"venue": "binance",
"bases": [
{
"base": "BTC",
"volume_24h_usd_e8": "51730000000000", "volume_ccy": "USDT", "oi_usd_e8": "38410000000000000", "oi_ccy": "USDT", "oi_asof_ms": 1795181462000,
"chains": [
{"chain": "BTC", "settle": "linear", "price_ccy": "USDT", "catalog_ver": 6, "instruments": 688, "expiries": 11, "volume_24h_usd_e8": "51730000000000", "volume_ccy": "USDT", "oi_usd_e8": "38410000000000000", "oi_ccy": "USDT", "oi_asof_ms": 1795181462000}
]
}
]
},
{
"venue": "bybit",
"bases": [
{
"base": "BTC",
"volume_24h_usd_e8": null, "volume_ccy": null, "oi_usd_e8": "29870000000000000", "oi_ccy": "USDT", "oi_asof_ms": 1795181413387,
"chains": [
{"chain": "BTC", "settle": "linear", "price_ccy": "USDT", "catalog_ver": 17, "instruments": 720, "expiries": 11, "volume_24h_usd_e8": null, "volume_ccy": null, "oi_usd_e8": "29870000000000000", "oi_ccy": "USDT", "oi_asof_ms": 1795181413387}
]
}
]
},
{
"venue": "okx",
"bases": [
{
"base": "BTC",
"volume_24h_usd_e8": null, "volume_ccy": null, "oi_usd_e8": null, "oi_ccy": null, "oi_asof_ms": 1795181461000,
"chains": [
{"chain": "BTC", "settle": "inverse", "price_ccy": "BTC", "catalog_ver": 12, "instruments": 770, "expiries": 13, "volume_24h_usd_e8": null, "volume_ccy": null, "oi_usd_e8": null, "oi_ccy": null, "oi_asof_ms": 1795181461000},
{"chain": "BTC_UM", "settle": "linear", "price_ccy": "USD", "catalog_ver": 9, "instruments": 626, "expiries": 9, "volume_24h_usd_e8": null, "volume_ccy": null, "oi_usd_e8": null, "oi_ccy": null, "oi_asof_ms": 1795181461000}
]
}
]
}
]
}Пример — ответ без venue, сокращённый до одной базы на площадку. Состав цепочек — живой ответ 20.11, числа ликвидности показывают форму, а не снимок рынка.
| Поле | Что |
|---|---|
venues[] |
площадки: присланная venue или все четыре |
bases[] |
базы площадки по имени; база, у которой ничего не листингуется, в список не попадает |
chains[] |
цепочки базы, где что-то листингуется: chain, settle, price_ccy — как у каталога (выше), catalog_ver — та же версия, что у каталога, instruments — сколько инструментов листингуется, expiries — сколько у них разных экспираций |
Ликвидность новейшей минуты — у каждой цепочки и у базы: премия за сутки и OI в деньгах, у каждой суммы — своя валюта. null, а не 0: у цепочки нет кадра, площадка поле не шлёт, у инструментов цепочки не одна валюта или сумма не уместилась в e8. Суммы считаются по новейшей минуте каждой цепочки, поэтому ETag ответа меняется с каждой минутой.
| Поле ликвидности | Что |
|---|---|
volume_24h_usd_e8 |
премия за 24 ч — сумма volume_usd_e8 строк новейшей минуты, целым e8 строкой |
volume_ccy |
валюта volume_24h_usd_e8 — та же, что volume_usd_ccy цепочки: у Deribit — USD (BTC и BTC_USDC) и у Binance — USDT; Bybit и OKX премию не шлют — null |
oi_usd_e8 |
OI в деньгах — Σ oi_asof × contract_size × index строк с OI, целым e8 строкой; это не премия и не номинал оборота |
oi_ccy |
валюта oi_usd_e8 — валюта котировки книги: у inverse — USD, у linear — price_ccy: USD — у OKX *_UM, USDT — у Binance и Bybit, USDC — у Deribit *_USDC; OKX индекс не шлёт — null |
oi_asof_ms |
на какой момент OI, Unix-мс: у Deribit — на 8 часов раньше снимка; у базы — самой старой цепочки |
Сумма базы — по всем её цепочкам и только когда значение есть у каждой и валюта одна, иначе null. У Deribit OI BTC — в USD, BTC_USDC — в USDC, поэтому oi_usd_e8 базы — null; премия у обеих — в USD, она сложена.
Список баз и цепочек — из каталога в памяти источника. ETag ответа — хэш тела: If-None-Match даёт 304, пока не пришла следующая минута или листинг.
Каталог
/v1/options/catalogИнструменты базы по цепочкам: страйк, экспирация, вид, расчёт, размер контракта, шаг цены и его ступени, наименьшая заявка, состояние на площадке; у цепочки — правило поставки. Группа тарифа — options.
| Параметр | Что |
|---|---|
base |
обязательный: база, 1–16 знаков из A-Z, 0-9 — BTC, ETH, SOL |
venue |
площадка: deribit, binance, bybit, okx, по умолчанию deribit; строчными |
chain |
одна цепочка базы: A-Z, 0-9, _, до 32 знаков — BTC_USDC. Без параметра — все цепочки |
curl -s "https://market-api.lootx.trade/v1/options/catalog?base=BTC&chain=BTC" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"venue": "deribit",
"base": "BTC",
"chains": [
{
"chain": "BTC",
"catalog_ver": 13,
"settle": "inverse",
"price_ccy": "BTC",
"volume_usd_ccy": "USD",
"volume_notional_ccy": null,
"settle_rule": {"kind": "twap", "window_s": 1800, "at_utc": "08:00"},
"instruments": [
{"instrument": "BTC-21NOV26-62500-C", "expiry_ms": 1795248000000, "strike": "62500", "type": "call", "settle": "inverse", "contract_size": "1", "tick_size": "0.0001", "tick_steps": [["0.005", "0.0005"]], "min_trade": "0.1", "settlement_period": "day", "settlement_currency": "BTC", "price_index": "btc_usd", "state": "open"}
]
}
]
}| Поле | Что |
|---|---|
catalog_ver |
версия каталога цепочки: растёт при листинге и делистинге |
settle, price_ccy, volume_usd_ccy, volume_notional_ccy |
у цепочки, а не у инструмента — выше |
settle_rule |
как цепочка поставляется: kind — twap (средняя индекса за окно перед поставкой), window_s — окно в секундах, at_utc — время поставки ЧЧ:ММ UTC. Сейчас у всех четырёх площадок — twap за 1800 с; spot и auction зарезервированы. null — правило не известно, листингов нет или экспирации цепочки поставляются в разное время суток |
instrument |
имя инструмента у площадки |
type |
call или put |
settle у инструмента |
linear или inverse |
tick_steps |
ступени шага цены: [цена от, шаг]; пусто — шаг один, tick_size |
min_trade |
наименьшая заявка, в контрактах |
settlement_period |
day, week, month, quarter; пустая строка — площадка периода не называет (все, кроме Deribit) |
state |
состояние на площадке, open — торгуется |
Каталог BTC — около полумегабайта. Его ETag строится из catalog_ver цепочек: пришлите метку в If-None-Match — пока листингов не было, ответ 304 без тела. Метка начинается с "cat3-; старая, выданная до settle_rule, даёт 200 с новым телом.
Экспирации
/v1/options/expiriesЭкспирации базы по цепочкам: сколько call и put, суммы объёма и OI новейшей минуты. Группа тарифа — options.
| Параметр | Что |
|---|---|
base |
обязательный, как у каталога |
venue |
площадка, как у каталога; по умолчанию deribit |
{
"base": "BTC",
"expiries": [
{"calls": 23, "chain": "BTC", "expiry_ms": 1795248000000, "oi_asof_ms": 1795152664164, "oi_calls": "1070.2", "oi_coins": "2871.5", "oi_puts": "1801.3", "oi_rows": 46, "price_ccy": "BTC", "puts": 23, "settle": "inverse", "settlement_period": "day", "volume_notional_ccy": null, "volume_notional_usd_e8": null, "volume_usd_ccy": "USD", "volume_usd_e8": "174016738000000"},
{"calls": 23, "chain": "BTC_USDC", "expiry_ms": 1795248000000, "oi_asof_ms": 1795152665101, "oi_calls": "76.41", "oi_coins": "229.93", "oi_puts": "153.52", "oi_rows": 46, "price_ccy": "USDC", "puts": 23, "settle": "linear", "settlement_period": "day", "volume_notional_ccy": null, "volume_notional_usd_e8": null, "volume_usd_ccy": "USD", "volume_usd_e8": "3401646000000"}
],
"venue": "deribit"
}Пример — живой ответ, сокращённый до экспирации на цепочку. volume_usd_e8 и volume_notional_usd_e8 — суммы по инструментам экспирации на новейшей минуте за 24 ч, валюта и смысл — как у строк цепочки (таблица выше). null — кадра ещё нет или площадка поле не шлёт.
| Поле | Что |
|---|---|
oi_calls, oi_puts |
OI call и put экспирации — сумма oi_asof строк новейшей минуты, в контрактах, точной десятичной строкой; null — OI нет ни у одной строки этой стороны, а не ноль |
oi_coins |
OI экспирации в монетах базы: (oi_calls + oi_puts) × contract_size |
oi_asof_ms |
к какому моменту относится OI — как у цепочки: у Deribit на 8 часов раньше снимка |
oi_rows |
сколько строк кадра вошло в суммы OI: меньше calls + puts — у части экспирации OI нет, суммы — по остальным |
settle, price_ccy, volume_usd_ccy, volume_notional_ccy |
как у каталога — выше |
Пока у цепочки нет ни одного кадра, все пять полей OI — null.
Расчёт экспирации — ещё шесть полей у каждой экспирации, по той же новейшей минуте: max pain, GEX, ATM IV и ожидаемый ход двумя способами.
{
"base": "BTC",
"expiries": [
{"atm_iv_bp": 5945, "chain": "BTC", "expiry_ms": 1795248000000, "gamma_usd_e8": "42000000000000", "max_pain": "62000", "max_pain_payout_usd_e8": "310000000000000", "move_sigma_bp": 327, "move_straddle_bp": 262, "price_ccy": "BTC", "settle": "inverse"},
{"atm_iv_bp": 5951, "chain": "BTC_USDC", "expiry_ms": 1795248000000, "gamma_usd_e8": "-3500000000000", "max_pain": "62000", "max_pain_payout_usd_e8": "21500000000000", "move_sigma_bp": 327, "move_straddle_bp": 259, "price_ccy": "USDC", "settle": "linear"}
],
"venue": "deribit"
}Пример — только поля расчёта, settle и price_ccy, остальные поля экспирации — как выше; числа показывают форму, а не снимок рынка.
Деньги расчёта — в валюте котировки книги: у inverse — USD, у linear — price_ccy: USD — у OKX *_UM, USDT — у Binance и Bybit, USDC — у Deribit *_USDC. Какая у экспирации — по её settle и price_ccy. Суффикс _usd_e8 в имени — по образцу volume_usd_e8, а не валюта: USDT — не USD, суммы разных цепочек без перевода курсом не складывайте.
| Поле расчёта | Что |
|---|---|
max_pain |
страйк, при котором держатели опционов экспирации получают меньше всего, — среди листингованных страйков; десятичной строкой в шкале страйка |
max_pain_payout_usd_e8 |
сколько продавцы заплатят держателям, если поставка пройдёт по max_pain; целым e8 строкой |
gamma_usd_e8 |
net GEX экспирации в режиме naive (знак по OI): Σ Γ × OI × F² × 0,01 — деньги на ход форварда в 1 %; call — плюсом, put — минусом. Целым e8 строкой со знаком |
atm_iv_bp |
ATM IV у форварда, целым в 0,01 пункта: 5945 — 59,45 % |
move_straddle_bp |
ожидаемый ход по рынку: ATMF-страддл по mark, интерполяция у форварда, / F — в базисных пунктах от F |
move_sigma_bp |
ожидаемый ход по модели: σ_ATM × √T, T — до поставки без поправки на окно поставки, в базисных пунктах от F |
null расчёта — «нет данных», а не 0. Нет OI в экспирации — max_pain и max_pain_payout_usd_e8; нет строк с греками — gamma_usd_e8; нет форварда или котировок у него — IV и ход; экспирации нет в новейшей минуте (листинг позже) или поставка уже прошла — все шесть полей; у цепочки нет кадра или у её инструментов не одна валюта — тоже все шесть; деньги, не уместившиеся в e8, — null.
Цепочка последней минуты
/v1/options/chain/latestНовейшая минута цепочек базы: строка на инструмент — котировки, mark, iv_bp, OI, объёмы, форвард и индекс. Группа тарифа — options.
| Параметр | Что |
|---|---|
base |
обязательный, как у каталога |
venue |
площадка, как у каталога; по умолчанию deribit |
chain |
одна цепочка базы; без параметра — все |
curl -s "https://market-api.lootx.trade/v1/options/chain/latest?base=BTC" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"venue": "deribit",
"base": "BTC",
"chains": [
{
"chain": "BTC",
"ts_min": 1795181400000,
"snap_ts": 1795181464164,
"oi_asof_ms": 1795152664164,
"catalog_ver": 13,
"settle": "inverse",
"price_ccy": "BTC",
"volume_usd_ccy": "USD",
"volume_notional_ccy": null,
"rows": [
{"expiry_ms": 1795248000000, "strike": "62500", "type": "call", "instrument": "BTC-21NOV26-62500-C", "bid": "0.0041", "ask": "0.0045", "mark": "0.00433933", "iv_bp": 5961, "oi_asof": "64.7", "volume": "151.5", "volume_usd_e8": "6985576000000", "volume_notional_usd_e8": null, "forward": "61415.57", "index": "61437.37", "bid_size": null, "ask_size": null}
]
},
{
"chain": "BTC_USDC",
"ts_min": 1795181400000,
"snap_ts": 1795181465101,
"oi_asof_ms": 1795152665101,
"catalog_ver": 6,
"settle": "linear",
"price_ccy": "USDC",
"volume_usd_ccy": "USD",
"volume_notional_ccy": null,
"rows": [
{"expiry_ms": 1795248000000, "strike": "63500", "type": "call", "instrument": "BTC_USDC-21NOV26-63500-C", "bid": "80", "ask": "95", "mark": "88.33583281", "iv_bp": 5903, "oi_asof": "13.53", "volume": "13.24", "volume_usd_e8": "566902000000", "volume_notional_usd_e8": null, "forward": "61416.63", "index": "61435.68", "bid_size": null, "ask_size": null}
]
}
]
}Пример — живой ответ, сокращённый до строки на цепочку. Номинал в ответе есть только у Bybit:
curl -s "https://market-api.lootx.trade/v1/options/chain/latest?base=BTC&venue=bybit" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"venue": "bybit",
"base": "BTC",
"chains": [
{
"chain": "BTC",
"ts_min": 1795181340000,
"snap_ts": 1795181413387,
"oi_asof_ms": 1795181413387,
"catalog_ver": 17,
"settle": "linear",
"price_ccy": "USDT",
"volume_usd_ccy": null,
"volume_notional_ccy": "USDT",
"rows": [
{"expiry_ms": 1795248000000, "strike": "62000", "type": "call", "instrument": "BTC-21NOV26-62000-C-USDT", "bid": "470", "ask": "475", "mark": "470.28075375", "iv_bp": 6043, "oi_asof": "33.15", "volume": "146.47", "volume_usd_e8": null, "volume_notional_usd_e8": "905865257399944", "forward": "61517.00049217", "index": "61510.93639245", "bid_size": "1.82", "ask_size": "37.54"}
]
}
]
}Пример с номиналом — живой ответ Bybit, сокращённый до строки. volume_notional_usd_e8 — номинал, USDT: 9 058 652,57 USDT при volume × index = 146,47 × 61 510,94 ≈ 9 009 507 — оборот набран за сутки по цене BTC во время сделок, а индекс взят на снимке. Размеры котировок есть, OI — на момент снимка.
curl -s "https://market-api.lootx.trade/v1/options/chain/latest?base=SOL" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"venue": "deribit",
"base": "SOL",
"chains": [
{
"chain": "SOL_USDC",
"ts_min": 1795181400000,
"snap_ts": 1795181465101,
"oi_asof_ms": 1795152665101,
"catalog_ver": 8,
"settle": "linear",
"price_ccy": "USDC",
"volume_usd_ccy": "USD",
"volume_notional_ccy": null,
"rows": [
{"expiry_ms": 1795248000000, "strike": "73", "type": "call", "instrument": "SOL_USDC-21NOV26-73-C", "bid": "0.17", "ask": "0.23", "mark": "0.20924689", "iv_bp": 7178, "oi_asof": "19", "volume": "211", "volume_usd_e8": "156548000000", "volume_notional_usd_e8": null, "forward": "70.722", "index": "70.7067", "bid_size": null, "ask_size": null}
]
}
]
}Пример по альту — живой ответ Deribit по SOL, сокращённый до строки. Количества и у альтов — в контрактах: у SOL_USDC контракт — 10 SOL (contract_size в каталоге, min_trade — "1"), монеты базы — volume или oi_asof × 10.
| Поле | Что |
|---|---|
ts_min |
начало минуты, мс |
snap_ts |
когда снят снимок площадки — сразу после закрытия минуты, мс |
oi_asof_ms |
к какому моменту относится oi_asof строк |
catalog_ver |
версия каталога цепочки, на которой собрана минута |
settle, price_ccy, volume_usd_ccy, volume_notional_ccy |
как у каталога — выше, по текущему каталогу источника, а не каталогу той минуты |
bid, ask, mark |
котировки и mark инструмента |
iv_bp |
подразумеваемая волатильность, 0,01 пункта |
volume, volume_usd_e8, volume_notional_usd_e8 |
объём за 24 ч: в контрактах и в деньгах, валюта и смысл денег — по площадке и цепочке в таблице выше |
forward, index |
форвард и индекс |
bid_size, ask_size |
объёмы лучших котировок, в контрактах |
Следующий ответ того же адреса — уже новая минута, поэтому chain/latest не кэшируется. Цепочки без минуты — в missing (неполная минута).
Цепочка минуты
/v1/options/chainЦепочки базы в минуту, закрытую в at или раньше; поля — как у chain/latest. Группа тарифа — options.
| Параметр | Что |
|---|---|
base |
обязательный, как у каталога |
venue |
площадка, как у каталога; по умолчанию deribit |
chain |
одна цепочка базы; без параметра — все |
at |
обязательный: момент, Unix-мс UTC или ISO-8601. Ответ — минута, закрытая в at или раньше. Глубина тарифа меряется по началу этой минуты |
Какая минута придёт. Шлюз берёт новейшую минуту, которая к at уже закрыта: её начало T = ⌊(at − 60 000) / 60 000⌋ · 60 000, она идёт от T до T + 60 000. at=1795110000000 (17:40:00 UTC) и at=1795110030000 (17:40:30) дают одну и ту же минуту 17:39–17:40 с ts_min: 1795109940000: минута 17:40–17:41 к 17:40:30 ещё не закрыта. Время в секундах или микросекундах — 400 bad_request с param: "at".
curl -s "https://market-api.lootx.trade/v1/options/chain?base=BTC&chain=BTC&at=2026-11-19T17:40:00Z" \
-H "Authorization: Bearer $LOOTX_API_KEY"Минуты нет ни у одной цепочки базы или у присланной chain — 404 not_found; минута, которую не восстановить из кадров источника, — тоже 404 not_found, со словом gap в message. Где дыры, говорит покрытие.
Неполная минута
Минута бывает не у всех цепочек базы. Тогда ответ 200, а цепочки без минуты перечислены в missing тела и в заголовке x-options-missing:
| Где | Что |
|---|---|
missing[] |
chain, reason, detail: no_frame — кадра нет, это дыра сбора; gap — минута не восстанавливается |
заголовке x-options-missing |
те же цепочки строкой ЦЕПОЧКА:причина через запятую: BTC_USDC:no_frame. Приходит в любом формате, у OPC1 это единственное место, где о них сказано |
detail — пояснение источника по-английски, для человека, а не для разбора. Так выглядит missing ответа /v1/options/chain за минуту, у которой нет кадра BTC_USDC:
[
{"chain": "BTC_USDC", "reason": "no_frame", "detail": "minute 1795137660000: no frame (a hole: see /v1/options/coverage)"}
]У chain/latest detail другой: no frame yet — у цепочки ещё нет ни одной минуты, newest minute <мс> cannot be rebuilt (…) — новейшая минута не собирается (gap). Поля missing нет — на месте все цепочки. Неполная минута не бывает неизменной: Cache-Control: private, no-cache, и кэш шлюза её не держит — повторите позже, когда источник дособерёт.
История цепочки
/v1/options/chain/rangeИстория одной цепочки за [from, to) — до 360 минут: JSON и protobuf — ряд одного инструмента по минутам, format=opc1 — кадры всей цепочки по минутам. Группа тарифа — options.
| Параметр | Что |
|---|---|
base |
обязательный, как у каталога |
venue |
площадка, как у каталога; по умолчанию deribit |
chain |
обязательный: одна цепочка базы, как у каталога. Диапазон — всегда одной цепочки |
from |
обязательный: начало, Unix-мс UTC или ISO-8601, целая минута. Глубина тарифа меряется по нему |
to |
обязательный: конец, в диапазон не входит; целая минута, from < to, не больше 360 минут после from — иначе 400 bad_request с param: "to" |
instrument |
инструмент цепочки — BTC-21NOV26-62500-C: A-Z, a-z, 0-9, -, _, ., до 64 знаков. Обязательный у JSON и protobuf: ответ — его ряд. У format=opc1 его нет — кадры всей цепочки; instrument с ним, как и JSON без него, — 400 bad_request с param: "instrument" |
curl -s "https://market-api.lootx.trade/v1/options/chain/range?base=BTC&chain=BTC&instrument=BTC-21NOV26-62500-C&from=2026-11-20T13:00:00Z&to=2026-11-20T13:03:00Z" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"venue": "deribit",
"base": "BTC",
"chain": "BTC",
"instrument": "BTC-21NOV26-62500-C",
"from": 1795179600000,
"to": 1795179780000,
"rows": [
{"ts_min": 1795179600000, "snap_ts": 1795179664261, "oi_asof_ms": 1795150864261, "catalog_ver": 13, "expiry_ms": 1795248000000, "strike": "62500", "type": "call", "instrument": "BTC-21NOV26-62500-C", "bid": "0.0043", "ask": "0.0046", "mark": "0.00439472", "iv_bp": 5718, "oi_asof": "64.7", "volume": "151.5", "volume_usd_e8": "6985576000000", "volume_notional_usd_e8": null, "forward": "61488.53", "index": "61517.02", "bid_size": null, "ask_size": null},
{"ts_min": 1795179660000, "snap_ts": 1795179720021, "oi_asof_ms": 1795150920021, "catalog_ver": 13, "expiry_ms": 1795248000000, "strike": "62500", "type": "call", "instrument": "BTC-21NOV26-62500-C", "bid": "0.0046", "ask": "0.0049", "mark": "0.00475026", "iv_bp": 5719, "oi_asof": "64.7", "volume": "151.5", "volume_usd_e8": "6985576000000", "volume_notional_usd_e8": null, "forward": "61555.04", "index": "61575.39", "bid_size": null, "ask_size": null},
{"ts_min": 1795179720000, "snap_ts": 1795179784781, "oi_asof_ms": 1795150984781, "catalog_ver": 13, "expiry_ms": 1795248000000, "strike": "62500", "type": "call", "instrument": "BTC-21NOV26-62500-C", "bid": "0.0045", "ask": "0.0048", "mark": "0.00469664", "iv_bp": 5720, "oi_asof": "64.7", "volume": "151.5", "volume_usd_e8": "6985576000000", "volume_notional_usd_e8": null, "forward": "61543.46", "index": "61565.5", "bid_size": null, "ask_size": null}
]
}Пример — живой ответ за три минуты. Строка минуты — шапка минуты /v1/options/chain (ts_min, snap_ts, oi_asof_ms, catalog_ver) и строка инструмента той минуты — поле в поле, как у /v1/options/chain?at= этой минуты. До листинга инструмента строк нет — это не пропуск.
| Поле | Что |
|---|---|
from, to |
диапазон запроса, мс; to не входит |
rows[] |
минуты, где инструмент есть, по порядку |
missing[] |
минуты, которых нет у цепочки: from_ms, to_ms (не входит), reason — no_frame (минута осела, кадра нет) или gap (кадр не связывается с отданным перед ним); соседние минуты одной причины — одним интервалом. Поля нет — на месте все. Минуты, ещё не закрытые к запросу (диапазон в настоящее), — не пропуск |
Вес запроса — час диапазона. Диапазон до 60 минут — 1 единица лимитов, 61–120 — 2, …, 301–360 — 6: столько запросов он списывает из ведра минуты и окон часа и суток (лимиты). Повтор из кэша шлюза (X-Cache: HIT) и 304 стоят столько же. Отказ формы запроса — чужой или повторённый параметр, нет chain, from или to, не целые минуты, from ≥ to, больше 360 минут — стоит 1; Глубже тарифа, CSV, JSON без instrument и format=opc1 с ним отказывают уже после списания полного веса.
Длинную историю читайте подряд диапазонами по 6 часов: to одного — from следующего. Кадры OPC1 (format=opc1) — вся цепочка за минуту, а ряд JSON — один инструмент: для всей цепочки берите кадры.
x-options-missing — одно имя, два синтаксиса. У /v1/options/chain и /v1/options/chain/latest — цепочки базы без минуты: ЦЕПОЧКА:причина через запятую (BTC_USDC:no_frame). У /v1/options/chain/range — интервалы минут без кадра: FROM_MS-TO_MS:причина через запятую, Unix-мс UTC, [FROM_MS, TO_MS), например 1795148100000-1795148220000:no_frame; заголовок не длиннее 1 КиБ, интервалы, которые не уместились, — последним элементом +N, полный список — в missing JSON. Разбирайте заголовок по маршруту, а не по виду строки. У кадров OPC1 о пропусках больше нигде не сказано.
Покрытие
/v1/options/coverageЦепочки базы — новейшая минута, отставание и минута, которую не собрать, — и дыры сбора окна. Группа тарифа — options.
| Параметр | Что |
|---|---|
base |
обязательный, как у каталога |
venue |
площадка, как у каталога; по умолчанию deribit |
from |
начало окна дыр, Unix-мс UTC или ISO-8601. По умолчанию — сутки до «сейчас». Глубина тарифа меряется по нему |
to |
конец окна; по умолчанию — сейчас. Нужно from < to, окно — до 31 суток, иначе 400 upstream_rejected с param: "from" |
curl -s "https://market-api.lootx.trade/v1/options/coverage?base=BTC&from=2026-11-20T03:00:00Z&to=2026-11-20T05:00:00Z" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"base": "BTC",
"chains": [
{"chain": "BTC", "lag_ms": 15018, "last_ts_min": 1795181520000},
{"chain": "BTC_USDC", "lag_ms": 15018, "last_ts_min": 1795181520000}
],
"from": 1795143600000,
"gaps": [
{"chain": "BTC", "from_ms": 1795148109131, "reason": "disconnect", "source": "btc_usd", "stream": "live", "to_ms": 1795148109353}
],
"to": 1795150800000,
"venue": "deribit"
}Пример — живой ответ: 20.11 в 04:15:09 UTC поток Deribit оборвался на 0,2 секунды (disconnect). Дыра записана под индексом btc_usd — он в source, а chain — цепочка, чья книга идёт по этому индексу. chains — состояние на «сейчас», окно from–to к нему не относится.
| Поле | Что |
|---|---|
last_ts_min |
новейшая минута цепочки у источника, мс; null — минуты ещё нет |
lag_ms |
насколько она отстала от «сейчас», мс |
unbuilt |
новее хранится минута, которую не собрать: ts_min, reason и detail — как у missing, например "reason": "gap", "detail": "cannot be rebuilt (reference: no key frame)"; поля нет — такой нет |
gaps[] |
дыры сбора окна: chain, source, stream, from_ms, to_ms, reason |
chain дыры |
цепочка (книга), к которой относится дыра. null — записанное имя не удалось сопоставить ни одной цепочке: единица опроса (*, ALL и подобные) или индекс, которого нет в каталоге; имя — в source, и такая дыра приходит в ответе каждой базы площадки |
source |
записанное имя, когда дыра записана не под своей цепочкой: индекс (btc_usd), базовый актив OKX (BTC-USD) или единица опроса. Поля нет — дыра записана под самой цепочкой |
stream |
что прервалось: chain — минута цепочки не записана; oi, quotes — у Binance и OKX минута записана без OI (у Binance — иногда без OI только части экспираций) или без тикера: эта часть снимка не получена в окне минуты; live — поток Deribit, имя индекса — в source; catalog — каталога площадки нет, минута потеряна |
reason |
почему: ошибка запроса к площадке — transport, rate_limited, http_status, rpc_error, decode; window_passed — окно минуты прошло, snapshot_time — снимок не из окна минуты; у chain ещё restart и leader_change — сборщик перезапущен или лидерство перешло к другому узлу, missed — минуты без учёта до следующей дыры или кадра, encode — кадр не собрался; у live — disconnect, silence, subscribe_refused; у catalog — no_catalog или ошибка запроса каталога |
Ряд волатильности книги
/v1/options/vol/book-rangeРяд волатильности одной книги — цепочки базы — по границам часа или суток: ATM IV постоянного срока 7, 30 и 90 суток, крылья 25Δ на 30 суток, RR, BF и индекс. Группа тарифа — options.
| Параметр | Что |
|---|---|
base |
обязательный, как у каталога |
venue |
площадка, как у каталога; по умолчанию deribit |
chain |
книга базы, как у каталога. Без параметра — книга с именем базы, а если её нет и книга у базы одна — она; иначе 404. Присылайте всегда: без неё ряд зависит от того, какие книги листингуются сейчас |
from |
обязательный: начало [from, to), Unix-мс UTC или ISO-8601; первая точка — первая граница шага не раньше него. Глубина тарифа — по нему |
to |
обязательный: конец, не входит; from < to, при step=1h — не больше 90 суток, при step=1d — не больше 365 суток |
step |
обязательный: 1h — границы часов, 1d — полночь UTC |
curl -s "https://market-api.lootx.trade/v1/options/vol/book-range?base=BTC&venue=deribit&chain=BTC&from=1795089600000&to=1795100400000&step=1h" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"venue": "deribit",
"base": "BTC",
"chain": "BTC",
"step": "1h",
"from": 1795089600000,
"to": 1795100400000,
"asof_ms": 1795096800000,
"coverage": {
"complete": false,
"gaps": [{"from_ms": 1795093200000, "to_ms": 1795093260000, "chain": "BTC", "stream": "chain", "reason": "no_frame"}]
},
"rows": [
{"ts_ms": 1795089600000, "index": "62480.15", "atm_iv_bp": {"d7": 4810, "d30": 5120, "d90": null}, "put25_iv_bp_30d": 5390, "call25_iv_bp_30d": 4980, "rr25_bp_30d": -410, "bf25_bp_30d": 65},
{"ts_ms": 1795096800000, "index": "62511.40", "atm_iv_bp": {"d7": null, "d30": 5105, "d90": null}, "put25_iv_bp_30d": null, "call25_iv_bp_30d": null, "rr25_bp_30d": null, "bf25_bp_30d": null}
]
}Пример — три часа шагом 1h: точка второго часа — дыра, у последней точки нет срока 7 суток и крыльев.
| Поле | Что |
|---|---|
venue, base, chain, step, from, to |
запрос, как его понял источник: chain — выбранная книга |
asof_ms |
ts_ms последней строки; строк нет — null |
rows[].ts_ms |
точка — минута, которая начинается ровно на границе шага: границы — кратные шага от 1970 года, сутки — по UTC |
rows[].index |
индекс минуты точной десятичной строкой; null — индекса нет (OKX его не шлёт) |
atm_iv_bp |
ATM IV постоянного срока: d7, d30, d90 — по полной дисперсии между экспирациями вокруг срока, по mark; срок раньше первой экспирации или позже последней — null, а не IV ближайшей |
put25_iv_bp_30d, call25_iv_bp_30d |
IV пута и колла с дельтой 25 % на сроке 30 суток; дельта — Black-76 по форварду |
rr25_bp_30d |
risk reversal: колл − пут |
bf25_bp_30d |
butterfly: (колл + пут) / 2 − ATM 30 суток |
coverage.complete |
true — ни одной дыры |
coverage.gaps[] |
дыры: точки подряд без строки с одной причиной — [from_ms, to_ms), to_ms — конец минуты последней точки; stream — chain; reason — no_frame (кадра нет), gap (кадр не восстанавливается), replay_limit (за один запрос не дошли — повторите запрос, точки догрузятся) |
IV, RR и BF — целым, в 0,01 пункта волатильности: 5120 — 51,2 %. Любое число строки бывает null — расчёту не хватило экспираций или котировок; дыра — это нет строки, а не строка из null. Границы после новейшей минуты книги ещё не настали — это не дыра: таких строк просто нет.
Вес ряда — границы шага на 64: число границ шага в [from, to) делится на 64 и округляется вверх, — от 1 до 34 единиц лимитов: сутки часами — 1, 90 суток часами — 34, год сутками — 6. Повтор из кэша шлюза и 304 стоят столько же. Отказ формы запроса — чужой или повторённый параметр, нет step, from или to, from ≥ to, окно длиннее предела — стоит 1; глубже тарифа (403 history_out_of_plan) и CSV (400 bad_format) отказывают уже после списания полного веса.
Экспозиция
/v1/options/exposure/latestGEX, DEX, VEX и CEX новейшей минуты одной книги — или всех книг базы разом — по страйкам группы экспираций: итоги группы, страйки и профиль net GEX по сетке цен. Знак дилера — naive. Группа тарифа — options.
| Параметр | Что |
|---|---|
base |
обязательный, как у каталога |
venue |
площадка, как у каталога, или all — все книги базы на всех площадках (ниже); по умолчанию deribit |
chain |
книга базы, как у ряда волатильности: без параметра — книга с именем базы, а если её нет и книга у базы одна — она; иначе 404. С venue=all — 400 bad_request (param: "chain"): книги берутся все |
expiry |
группа экспираций от метки снимка: 0dte — поставка до конца текущих суток UTC, 1d, 7d, 31d, 91d — не позже снимка + N суток, all — все; по умолчанию all. Иная — 400 bad_request |
mode |
знак дилера: только naive — коллы плюсом, путы минусом; по умолчанию naive. Иной — 400 bad_request |
curl -s "https://market-api.lootx.trade/v1/options/exposure/latest?base=BTC&venue=deribit&chain=BTC&expiry=7d" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"venue": "deribit",
"base": "BTC",
"chain": "BTC",
"expiry": "7d",
"mode": "naive",
"asof_ms": 1795096800000,
"coverage": {"complete": true, "gaps": []},
"usd_ccy": "USD",
"spot": "62511.40",
"expiries_ms": [1795161600000, 1795507200000],
"totals": {"gex_usd_e8": "-4260000000000000", "dex_usd_e8": "18240000000000000", "vex_usd_e8": "-81200000000000", "cex_usd_e8": "-2735000000000"},
"strikes": [
{"strike": "62000", "gex_call_usd_e8": "1520000000000000", "gex_put_usd_e8": "-2810000000000000", "dex_usd_e8": "-4120000000000000", "vex_usd_e8": "-31500000000000", "cex_usd_e8": "1240000000000", "oi_call_coins": "1204.5", "oi_put_coins": "2310.1"},
{"strike": "65000", "gex_call_usd_e8": "980000000000000", "gex_put_usd_e8": "-120000000000000", "dex_usd_e8": "8730000000000000", "vex_usd_e8": "26400000000000", "cex_usd_e8": "-950000000000", "oi_call_coins": "3150", "oi_put_coins": "212.4"}
],
"profile": [
{"price": "53134.69", "gex_usd_e8": "3905000000000000"},
{"price": "53290.97", "gex_usd_e8": "3871000000000000"},
{"price": "71888.11", "gex_usd_e8": "-1532000000000000"}
]
}Пример сокращён: страйков — два, точек профиля — три из 121.
| Поле | Что |
|---|---|
venue, base, chain, expiry, mode |
запрос, как его понял источник: chain — выбранная книга, у venue=all — null |
asof_ms |
минута расчёта; минуты нет — null |
usd_ccy |
валюта всех *_usd_e8 ответа — котировка книги: у inverse — USD, у linear — price_ccy: USD — у OKX *_UM, USDT — у Binance и Bybit, USDC — у Deribit *_USDC; у venue=all — валюта опорной книги (ниже) |
spot |
индекс точной десятичной строкой; у книги без индекса (OKX его не шлёт) — null, а профиль пуст |
expiries_ms |
экспирации группы, Unix-мс UTC |
totals |
итоги группы: gex_usd_e8 — net GEX, dex_usd_e8, vex_usd_e8, cex_usd_e8 — целым e8 строкой; книга без минуты, без расчёта или с переполнением — null |
strikes[] |
страйк группы: strike — десятичной строкой в шкале страйка; gex_call_usd_e8 и gex_put_usd_e8 — GEX коллов и путов, dex_usd_e8, vex_usd_e8, cex_usd_e8 — целым e8 строкой; oi_call_coins и oi_put_coins — OI коллов и путов в монетах базы десятичной строкой; у venue=all ещё venue_share |
profile[] |
net GEX группы, если бы цена была price: 121 точка, ±15 % от spot шагом 0,25 %; price — spot × (1 + x) в шкале цены |
coverage |
complete — ни одной дыры; gaps[] — {from_ms, to_ms, chain, stream: "chain", reason}: no_frame — у книги нет минуты, no_calc — расчёта нет, money_overflow — не уместилось в e8, иначе — причина сборки минуты |
Экспозиция — в деньгах котировки книги. D — позиция дилера в монетах по знаку naive (коллы плюсом, путы минусом), F — форвард строки. GEX = Γ × D × F² × 0,01 — хедж на ход цены в 1 %; DEX = Δ × D × F — дельта; VEX = vanna × D × F × 0,01 — сдвиг дельты на +1 пункт IV; CEX = charm × D × F / 365 — сдвиг дельты за сутки. Все *_usd_e8 — целым e8 строкой со знаком, кроме gex_call_usd_e8, в валюте usd_ccy: USDT — не USD, ответы книг разных котировок без перевода курсом не складывайте.
null и пусто — «нет данных», а не 0. Книга без минуты, без расчёта или с переполнением отвечает 200: totals: null, пустые strikes и profile и дыра в coverage.gaps. Группа 0dte с 08:00 до полуночи UTC пуста: expiries_ms: [], итоги — нули, strikes пуст.
Все площадки
venue=all — все книги базы на всех площадках разом: каждая книга переводится к индексу опорной — первой книги с индексом в порядке deribit, binance, bybit, okx, внутри площадки первой идёт книга с именем базы. Минута ответа — новейшая общая: пока последняя площадка не дописала новую минуту, приходит предыдущая у всех книг, а не часть книг.
У страйка — venue_share: доля каждой площадки в |net GEX| страйка по модулю, {deribit, binance, bybit, okx}, вместе — 1, четыре знака; площадка без вклада — 0, у страйка с нулевым GEX все доли — null.
Дыры книг у venue=all называют площадку: no_frame:okx, no_calc:binance, other_minute:deribit — книги нет в минуте ответа, no_index:okx — книга без индекса в ответ не входит. Дыры ответа целиком — без площадки, chain — база: no_index — ни одного индекса, sum_refused: …, money_overflow.
Ответ живой: Cache-Control: private, no-cache и ETag; пришлите метку в If-None-Match — та же минута придёт 304. Кэш шлюза его не держит. Вес экспозиции — 1 единица: окна и глубины тарифа у неё нет.
История уровней
/v1/options/levels/rangeИстория уровней одной книги по границам шага: индекс, форвард, zero gamma, стены коллов и путов, abs gamma, net GEX, max pain и ожидаемый ход ближайшей поставки группы. Знак дилера — naive. Группа тарифа — options.
| Параметр | Что |
|---|---|
base |
обязательный, как у каталога |
venue |
площадка, как у каталога; по умолчанию deribit. all — 400 bad_request: уровни — одной книги, ряда по всем площадкам пока нет |
chain |
книга базы, как у ряда волатильности. Присылайте всегда: без неё ряд зависит от того, какие книги листингуются сейчас |
expiry |
группа экспираций, как у экспозиции; по умолчанию all |
mode |
только naive, как у экспозиции |
from |
обязательный: начало [from, to), Unix-мс UTC или ISO-8601; первая точка — первая граница шага не раньше него. Глубина тарифа — по нему |
to |
обязательный: конец, не входит; from < to, при step=1m — не больше 7 суток, при step=5m — не больше 30 суток, при step=1h — не больше 90 суток (ровно предел проходит) |
step |
обязательный: 1m, 5m или 1h — границы, кратные шагу от 1970 года |
curl -s "https://market-api.lootx.trade/v1/options/levels/range?base=BTC&venue=deribit&chain=BTC&from=1795089600000&to=1795100400000&step=1h" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"venue": "deribit",
"base": "BTC",
"chain": "BTC",
"expiry": "all",
"mode": "naive",
"step": "1h",
"from": 1795089600000,
"to": 1795100400000,
"asof_ms": 1795096800000,
"coverage": {
"complete": false,
"gaps": [{"from_ms": 1795093200000, "to_ms": 1795093260000, "chain": "BTC", "stream": "calc", "reason": "no_calc"}]
},
"usd_ccy": "USD",
"rows": [
{"ts_ms": 1795089600000, "spot": "62480.15", "fwd": "62528.7", "zero_gamma": "61850.3", "zero_gamma_sticky_delta": null, "unstable": false, "call_walls": ["65000", "70000"], "put_walls": ["60000", "58000"], "abs_gamma": "60000", "net_gex_usd_e8": "-4115000000000000", "max_pain": "62000", "max_pain_expiry_ms": 1795161600000, "move_straddle_bp": 121, "move_sigma_bp": 152},
{"ts_ms": 1795096800000, "spot": "62511.40", "fwd": "62560.1", "zero_gamma": null, "zero_gamma_sticky_delta": null, "unstable": false, "call_walls": ["65000", "70000"], "put_walls": ["60000", "55000"], "abs_gamma": "60000", "net_gex_usd_e8": "-4260000000000000", "max_pain": "62000", "max_pain_expiry_ms": 1795161600000, "move_straddle_bp": 118, "move_sigma_bp": 148}
]
}Пример — три часа шагом 1h: у точки второго часа нет строки расчёта, у последней точки профиль не меняет знак.
| Поле | Что |
|---|---|
venue, base, chain, expiry, mode, step, from, to |
запрос, как его понял источник: chain — выбранная книга |
asof_ms |
ts_ms последней строки; строк нет — null |
usd_ccy |
валюта net_gex_usd_e8 — котировка книги: у inverse — USD, у linear — price_ccy: USD — у OKX *_UM, USDT — у Binance и Bybit, USDC — у Deribit *_USDC; строк нет — null |
rows[].ts_ms |
точка — минута, которая начинается ровно на границе шага |
spot, fwd |
индекс и форвард ближайшей поставки группы точной десятичной строкой |
zero_gamma |
цена, где профиль net GEX меняет знак; смены знака на сетке нет — null |
zero_gamma_sticky_delta, unstable |
второй режим волатильности — пока всегда null и false |
call_walls, put_walls |
две стены: страйки с наибольшим GEX коллов выше индекса и путов ниже, главная первой; стены — null или [null, null] у книги без индекса |
abs_gamma |
страйк с наибольшей суммой модулей GEX коллов и путов |
net_gex_usd_e8 |
net GEX группы в валюте usd_ccy — целым e8 строкой со знаком; нет экспирации в группе (у 0dte — с 08:00 до полуночи UTC) — "0" |
max_pain, max_pain_expiry_ms |
max pain ближайшей поставки группы и её срок; нет экспирации в группе — null |
move_straddle_bp, move_sigma_bp |
ожидаемый ход ближайшей поставки группы с ATM IV, в базисных пунктах от форварда: модельный ATMF-страддл и σ√T, T — до поставки от снимка |
coverage.complete |
true — ни одной дыры |
coverage.gaps[] |
дыры: точки подряд без строки с одной причиной — [from_ms, to_ms), to_ms — конец минуты последней точки; stream — calc; reason — no_calc (граница не позже новейшей минуты книги, а строки расчёта нет), no_frame (у книги нет ни одной минуты) |
Цены и страйки — точной десятичной строкой в шкале инструмента, null — «нет данных», а не 0: дыра — это нет строки, а не строка из null. Границы после новейшей минуты книги ещё не настали — это не дыра: таких строк просто нет. Дыру с осевшими границами источник держит до 10 минут: дозалитая строка появится не позже чем через 10 минут.
Вес истории уровней — точки шага на 1440: число границ шага в [from, to) делится на 1440 и округляется вверх, — от 1 до 7 единиц лимитов: сутки минутами — 1, 7 суток минутами — 7, 30 суток по 5 минут — 6, 90 суток часами — 2. Повтор из кэша шлюза и 304 стоят столько же. Отказ формы запроса — чужой или повторённый параметр, нет step, from или to, from ≥ to, окно длиннее предела, venue=all, иные expiry или mode — стоит 1; глубже тарифа (403 history_out_of_plan) и CSV (400 bad_format) отказывают уже после списания полного веса.
Живой поток
/v1/options/streamWebSocket кадров цепочек базы: сначала текст hello, затем кадры OPC1 — по одному на сообщение. Группа тарифа — options.
| Параметр | Что |
|---|---|
base |
обязательный, как у каталога |
venue |
площадка, как у каталога; по умолчанию deribit |
chain |
цепочки базы через запятую, до 64 цепочек; каждая — A-Z, 0-9, _, до 32 знаков. Без параметра — все цепочки базы на момент соединения; набор держится всё соединение, новая цепочка — только в новом соединении |
resume |
продолжение после обрыва: <epoch>:<цепочка>:<seq> через запятую, по одному на цепочку — ниже |
Адрес — wss://market-api.lootx.trade/v1/options/stream, отдельный от /v1/ws. Ключ — как у /v1/ws: заголовком или подпротоколом ["lx.v1", "key.<ключ>"] (подключение). Команд у потока нет: сообщения клиента читаются и отбрасываются.
const ws = new WebSocket("wss://market-api.lootx.trade/v1/options/stream?base=BTC", ["lx.v1", `key.${apiKey}`]);
ws.binaryType = "arraybuffer";Первое сообщение — текст JSON hello:
{"type": "hello", "epoch": "3f9c0a1b2c3d4e5f", "venue": "deribit", "base": "BTC", "chains": [{"chain": "BTC", "seq": 41, "live": true}, {"chain": "BTC_USDC", "seq": 7, "live": false}]}Поле hello |
Что |
|---|---|
epoch |
процесс источника, 16 hex: другой процесс — другая эпоха |
chains[].seq |
кадр, на котором цепочка стоит: с него начнётся её поток; 0 — кадров ещё не было, первый придёт ключевым |
chains[].live |
у цепочки есть живой канал: кроме кадров минуты идут живые кадры |
Кадры — по одному на бинарное сообщение, без uvarint-длины: раскладка та же, формат предварительный — байт 4 кадра сверяйте. По каждой цепочке сначала ключевой кадр на hello.seq (с resume — пропущенные кадры), затем каждый новый по порядку:
- кадр минуты — новейшая минута цепочки, та же, что у
/v1/options/chain/latest: дельта к кадру перед ней, когда строки и шкалы те же, иначе ключевой — листинг, новая строка; - живой кадр — только у цепочек с
live: true: дельта, в которой меняются толькоmarkиiv_bpстрок, не чаще раза в секунду на цепочку;ts_min,catalog_verи прочие поля — от минуты.
seq заголовка кадра — счёт потока, а не минуты: u32 на цепочку, +1 на кадр. Дельта ссылается на кадр перед ней (ref_ts_min, ref_snap_ts). Сверяйте, что seq — прошлый + 1 и звено дельты совпало; разрыв — переподключитесь с resume. Источник пингует раз в 20 с.
Продолжение потока
resume — epoch из hello и seq последнего принятого кадра каждой цепочки, элементы — через запятую: resume=3f9c0a1b2c3d4e5f:BTC:41. Тот же процесс и seq ещё в его памяти — придут ровно пропущенные кадры; новая эпоха, seq, которого уже нет в памяти, или seq из будущего — ключевой кадр. В новом hello seq — кадр, на котором вы теперь стоите.
Отказы — до апгрейда, обычным HTTP-ответом с телом ошибки, как у REST, а не 101 и закрытием: 400 bad_request — параметр не той формы, больше 64 цепочек, format или table; 400 upstream_rejected — bad_resume → resume, bad_chain → chain; 404 not_found — нет присланной цепочки или у базы нет ни одной; 429 ws_limit — заняты все ws_conns тарифа; 503 upstream_unavailable с Retry-After — источник загружает цепочки после запуска или держит предельное число соединений потока.
Отметка «поток выключен» на узле — выкладка, а не окончательный отказ: приходит 503 upstream_unavailable с Retry-After: 30.
| Код закрытия | Причина | Что делать |
|---|---|---|
4008 |
slow consumer |
клиент не успевал читать: очередь 64 кадра или отправка дольше 5 с. Переподключитесь с resume |
1011 |
hello |
источник не собрал hello. Переподключитесь |
1001 |
— | источник останавливается. Переподключитесь с resume: у нового процесса другая эпоха — придёт ключевой кадр |
1013 |
upstream_unavailable |
источник оборвал соединение. Переподключитесь с паузой и resume |
1008 |
daily_quota_exceeded, revoked_key, plan_inactive, invalid_key, insufficient_scope, route_not_in_plan |
кончился суточный объём или доступ — как у /v1/ws, но кадра error перед закрытием нет: код — только в причине |
Учёт. Соединение — один запрос группы options и одно место из ws_conns тарифа на всё время соединения. Байты hello и кадров идут в суточный объём аккаунта и группы options; пинги — нет.
Форматы
- JSON (по умолчанию) — тело источника байт в байт.
- protobuf — общий конверт
lootx.v1.Response(форматы): поля верхнего уровня — вmeta, вложенное (цепочки, строки, экспирации, дыры) — JSON-текстом. - CSV нет: ответы — вложенные объекты, таблицей их не разложить.
format=csvиAccept: text/csv—400 bad_format, вmessage— форматы маршрута. format=opc1— только у/v1/options/chain,/v1/options/chain/latestи/v1/options/chain/range: кадры OPC1 источника насквозь,application/octet-stream. У баз, каталога, экспираций, покрытия, ряда волатильности, экспозиции и истории уровней —400 bad_format. По заголовку кадры не выбираются:Accept: application/octet-streamбез параметра —406 not_acceptable.
JSON и protobuf — стабильные формы ответа: они меняются только вместе с версией API. Поток /v1/options/stream — не ответ, а WebSocket: hello текстом JSON и кадры OPC1 (живой поток); format у него нет.
Чего нет в ответе OPC1, сказано только в заголовке x-options-missing (два синтаксиса). Ошибки приходят JSON и при format=opc1: сначала проверьте код ответа. Как устроен ответ кадрами, коротко сказано и в спецификации — ответ application/octet-stream этих трёх маршрутов в /v1/openapi.json.
Раскладка кадров OPC1
Тело минуты (chain, chain/latest) — на каждую цепочку минуты uvarint-длина и один ключевой кадр, встык до конца тела; дельт в нём нет. Тело диапазона (chain/range) — кадры одной цепочки по минутам, у каждого uvarint-длина, встык до конца тела: первый — ключевой, следующие — как их хранит источник, ключевой кадр часа или дельта к кадру перед ней, версии 1 и 2 вперемешку. Проигрывайте их по порядку и сверяйте звено каждой дельты (ref_ts_min, ref_snap_ts) с кадром перед ней: не совпало — цепочка разорвана, не читайте дальше наугад. Шлюз тело не сжимает: DEFLATE уже внутри кадра. Заголовок кадра:
| Байты | Что |
|---|---|
| 0–3 | магия OPC1 |
| 4 | версия раскладки: сейчас пишется 2, бывает и 1. Незнакомую — отвергайте |
| 5 | флаги: бит 0 — тело сжато сырым DEFLATE. Незнакомые биты — отвергайте |
| 6–7 | длина заголовка, u16 little-endian: с этого байта начинается тело |
| 8 | вид кадра: 0 — ключевой, 1 — дельта (только в теле диапазона). Незнакомый — отвергайте |
| 9 | площадка: 1 — Deribit, 2 — Binance, 3 — Bybit, 4 — OKX |
| дальше | varint-ы: цепочка (uvarint-длина и ASCII), catalog_ver, ts_min, snap_ts − ts_min (zigzag), сдвиг OI назад от snap_ts в мс, номер кадра, число строк; затем у ключевого — шкалы значений и множитель контракта, у дельты — опорный кадр: ref_ts_min и ref_snap_ts − ref_ts_min (zigzag) |
Значения в теле — целые в шкалах заголовка, деньги — в e8, как *_usd_e8 в JSON. Пределы: кадр — до 8 МиБ и после распаковки, строк — до 16 384, экспираций — до 1 024, имя цепочки — до 32 байт. Раскладка тела меняется вместе с версией: читайте кадр, только если знаете его байт 4.
Кэш и ETag
У каждого ответа 200 есть ETag; одна метка у JSON, protobuf и сжатого тела того же ответа.
- Пришлите метку в
If-None-Match— если ответ не изменился, придёт304без тела с теми жеETag,Cache-Controlиx-options-missing: запрос засчитывается, а в суточный объём не идёт. Сравнение слабое:W/"…", список меток и*тоже подходят. - Неизменны —
Cache-Control: private, max-age=31536000, immutable— четыре ответа:/v1/options/chainза целую осевшую минуту (все цепочки базы на месте, у каждой строки есть имя инструмента, после закрытия прошло 2 минуты),/v1/options/chain/rangeза целый осевший диапазон (ни одной минуты без кадра, послеtoпрошло 2 минуты)/v1/options/vol/book-rangeза целый осевший ряд (ни одной дыры, у книги есть расчёт, после минуты последней границы прошло 2 минуты) и/v1/options/levels/rangeза целый осевший ряд (строка у каждой границы, последняя граница осела). Повтор шлюз отдаёт из своего кэша (X-Cache: HIT). - Свежая или неполная минута
chain, диапазонchain/rangeв настоящее или с пропусками, рядvol/book-rangeилиlevels/rangeс неосевшей границей или с дырами,chain/latest,exposure/latest,bases,catalog,expiriesиcoverage—private, no-cache: кэшируйте с меткой и спрашивайте сIf-None-Match.
curl -s -o /dev/null -w "%{http_code}\n" "https://market-api.lootx.trade/v1/options/chain/latest?base=BTC" \
-H "Authorization: Bearer $LOOTX_API_KEY" -H 'If-None-Match: "f42b9c0e7d1a3b55"'Глубина истории
Глубину проверяет тариф — history_days: меньший из общего и группового (группы options), если у группы свой. Меряется не у всех маршрутов:
/v1/options/chain— по минуте ответа. Меряется начало минуты, закрытой вat. Глубже тарифа —403 history_out_of_planсparam: "at";earliest_allowed_msв отказе — первыйat, который пройдёт./v1/options/chain/range— поfrom. Глубже тарифа —403 history_out_of_planсparam: "from".earliest_allowed_msв этом отказе бывает не кратен минуте, аfrom— целая минута: округлите его вверх до минуты./v1/options/coverage— поfrom. Безfrom— по суткам до «сейчас». Глубже тарифа —403 history_out_of_planсparam: "from"./v1/options/vol/book-range— поfrom. Глубже тарифа —403 history_out_of_planсparam: "from", уже после списания полного веса (до 34 единиц)./v1/options/levels/range— поfrom. Глубже тарифа —403 history_out_of_planсparam: "from", уже после списания полного веса (до 7 единиц). Сколько истории есть у книги, говорит покрытие: дыры расчёта в нём не видны — они вcoverage.gapsсамого ряда.bases,catalog,expiries,chain/latest,exposure/latestи поток окна не имеют и глубиной не меряются.
Отказы
Источник отказывает телом {"error", "detail"} — кодом и пояснением. Клиенту оно не приходит как есть: шлюз отвечает своим телом ошибки, код и пояснение источника — в message, параметр — в param.
| Ответ | Когда | Что делать |
|---|---|---|
400 bad_request |
параметр, которого нет у маршрута, или повтор параметра — и в процентной записи имени (b%61se — тоже base); нет base, at, а у chain/range — chain, from или to; base, venue, chain, instrument не той формы; at, from, to не мс и не ISO-8601, в секундах или микросекундах; у chain/range — не целые минуты, from ≥ to, больше 360 минут, JSON или protobuf без instrument, format=opc1 с instrument; у vol/book-range — нет step или он не 1h и не 1d, from ≥ to, больше 90 суток при step=1h или 365 суток при step=1d (param: "to"); у exposure/latest и levels/range — expiry не из групп, mode не naive; у exposure/latest — chain при venue=all; у levels/range — venue=all, нет step или он не 1m, 5m, 1h, from ≥ to, больше 7 суток при step=1m, 30 при 5m, 90 при 1h (param: "to") — до источника. param — его имя |
исправьте запрос по param и expected |
400 bad_format |
format=csv или Accept: text/csv; format=opc1 у баз, каталога, экспираций, покрытия, ряда волатильности, экспозиции или истории уровней; неизвестный format |
message называет форматы маршрута: format=json или protobuf, у цепочек — format=json, protobuf или opc1 |
406 not_acceptable |
в Accept нет ни одного известного шлюзу типа — в том числе Accept: application/octet-stream без параметра. Accept: text/csv — не 406, а 400 bad_format |
Accept: application/json или application/x-protobuf — типы маршрута в expected; кадры OPC1 — только ?format=opc1 |
400 upstream_rejected |
источник отверг значение; param — по его коду: bad_base → base, bad_venue → venue, bad_chain → chain, bad_at → at, bad_format → format, bad_range → from, range_too_long → to, bad_instrument → instrument, bad_resume → resume |
исправьте названный параметр |
403 insufficient_scope |
токен без области derivatives — например, бесплатный токен терминала |
запрашивайте с API-ключом |
403 route_not_in_plan |
тариф закрыл группу options |
смените тариф |
403 history_out_of_plan |
минута at или from глубже тарифа — выше |
at или from не раньше earliest_allowed_ms |
404 not_found |
у chain и chain/latest нет минуты у базы или у присланной chain, либо минута не восстанавливается (gap); у chain/range нет цепочки у базы, инструмента у цепочки или в диапазоне не отдать ни одной минуты (gap — ни одна не восстанавливается); у vol/book-range, exposure/latest и levels/range нет книги у базы — присланной chain или книги по умолчанию, у exposure/latest с venue=all — ни одной книги базы; у потока нет присланной цепочки или у базы нет ни одной |
другая минута или диапазон; дыры — в покрытии |
429 rate_limited и другие 429 |
лимит тарифа; chain/range весит 1–6 единиц — вес запроса, vol/book-range — 1–34 (вес ряда), levels/range — 1–7 (вес истории уровней); у потока ещё 429 ws_limit — заняты все ws_conns |
повторите после Retry-After |
503 upstream_unavailable |
источник загружает цепочки после запуска или склад не читается; у vol/book-range — источник уже собирает предельное число рядов со склада, у levels/range — уже читает предельное число рядов уровней; у потока — предельное число соединений или «поток выключен» (Retry-After: 30). Приходит с Retry-After источника — обычно Retry-After: 1, не дольше 60 с |
повторите через Retry-After |
502 upstream_error |
источник ответил ошибкой или телом не той формы (деньги числом, не кадры на format=opc1), маршрутов опционов у источника нет |
повторите позже; не проходит — напишите в поддержку с request_id |
502 upstream_unavailable, 504 upstream_timeout |
источник недоступен или не ответил вовремя | повторите позже |
Все коды — на странице ошибок.