{
  "openapi": "3.1.0",
  "info": {
    "title": "Lootx Market Data API",
    "description": "Единый API рыночных данных Lootx: свечи, футпринт, открытый интерес, фандинг, long/short ratio,\nmark и index, плотности стакана, скринер, ликвидации — одна дверь, один ключ, одинаковые имена и\nвремя.\n\nДокументация — [https://docs.lootx.trade/ru/market-api](https://docs.lootx.trade/ru/market-api): [начало работы](https://docs.lootx.trade/ru/market-api/getting-started),\n[соглашения](https://docs.lootx.trade/ru/market-api/conventions), [SDK](https://docs.lootx.trade/ru/market-api/sdk), [лимиты и заголовки](https://docs.lootx.trade/ru/market-api/limits),\n[коды ошибок](https://docs.lootx.trade/ru/market-api/error-codes), [форматы](https://docs.lootx.trade/ru/market-api/formats), [потоки](https://docs.lootx.trade/ru/market-api/websocket). У каждого\nмаршрута ниже — ссылка на его страницу.\n\n## Ключ\n\nКлюч выдаётся в личном кабинете Lootx и показывается один раз. Передавайте его заголовком:\n\n```\nAuthorization: Bearer lx_live_...\n```\n\nили `X-API-Key: lx_live_...`. Ключ в строке запроса **не принимается** (ответ `400 key_in_query`):\nстроки запросов оседают в логах прокси и браузеров. Для WebSocket из браузера — подпротоколом:\n`new WebSocket(url, [\"lx.v1\", \"key.lx_live_...\"])`; сервер выберет `lx.v1`.\n\nКлючи `lx_test_...` работают так же и предназначены для разработки.\n\n## Инструменты\n\nИнструмент пишется как `venue:market:SYMBOL`: `binance:perp:BTCUSDT`, `bybit:spot:ETHUSDT`,\n`hyperliquid:perp:BTC`, `coinbase:spot:BTC-USD`, акции Hyperliquid — `hyperliquid:perp:AAPLUSDC.XYZ`.\n`market` — `spot`, `perp`, `future`, `option`.\nКотировки USDT, USDC и USD — разные инструменты и никогда не сливаются. Что есть у какого\nисточника — `GET /v1/instruments` (колонка `sources`).\n\n**Сумма площадок.** `/v1/candles`, `/v1/series`, `/v1/oi` и `/v1/liquidations/bars` принимают\nвместо `instrument` список `instruments=binance:perp:BTCUSDT,bybit:perp:BTCUSDT` — одна монета\nна одном рынке, 2–12 площадок, котировки USDT, USDC и USD складываются 1:1. Объёмы, сделки, OI,\nликвидации и дельта — суммой (точно, без округления); цены свечей — первой площадки списка\n(`price_anchor`); `cvd` — нарастающая сумма суммарной дельты. В конце каждой строки —\n`venues_present` (сколько площадок в точке) и `venues_mask` (бит i — площадка i из массива\n`instruments` ответа): площадки без данных в точке в сумму не входят. Порядок списка ответа не\nменяет, кроме якоря цены. Сумма N площадок весит N запросов. Ставки, отношения и маршруты по\nуровню цены (`/v1/funding`, `/v1/ls-ratio`, `/v1/footprint`, `/v1/delta`, `/v1/trades`) и полосы\nкниги (`/v1/book/bands`), события и профиль ленты (`/v1/tape/*`) суммы не знают: два и больше\nинструментов — `400`.\n\n## Время и страницы\n\nВремя везде — Unix-миллисекунды UTC; окно `[from, to)`. У `/v1/candles` и `/v1/series` `from`/`to`\nможно дать и ISO-8601: дата `2024-01-01` (полночь UTC) или `2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm]`\n(без зоны — UTC, `+` — `%2B`). Ряды отдаются колонками:\n`{\"columns\":[...],\"rows\":[[...],...],\"next_cursor\":\"...\"}`. Если `next_cursor` не `null`,\nпередайте его как `cursor=` с теми же остальными параметрами — получите следующую страницу.\n\nСвечи и ряды глубже записи сделок — свечи бирж с листинга. `deep_until` ответа (мс) — шов этого\nяруса: приходит у любого символа со свечами склада, и в живом окне, поэтому само поле не значит, что\nна странице есть `null`. Левее шва стороны и базового объёма нет — `null` (`volume`, `buy_*`, а у\nрядов — `delta`, `cvd`, `volume` в монетах), `quote_volume` и OHLC — числа; `cvd` копится со шва.\n`from`/`to` от `10000000000000` (14 знаков и больше — микро- и наносекунды) — `400`.\n\n## Потоки\n\n`wss://…/v1/ws` — одно соединение на несколько каналов: `densities`, `screener`, `trades`,\n`oi`, `candles` (`liquidations` пока `channel_unavailable`; живые ликвидации — отдельный\nпоток `/v1/liquidations/stream`, кадры цепочек опционов — поток `/v1/options/stream`, см.\n«Форматы»). Команды JSON:\n\n```json\n{\"op\":\"subscribe\",\"id\":1,\"channel\":\"trades\",\"instruments\":[\"binance:perp:BTCUSDT\"]}\n{\"op\":\"unsubscribe\",\"id\":2,\"channel\":\"trades\",\"instruments\":[\"binance:perp:BTCUSDT\"]}\n{\"op\":\"ping\",\"id\":3}\n```\n\nОтветы: `subscribed`/`unsubscribed`/`pong` с вашим `id`; данные — `snapshot` (состояние\nцеликом, по инструменту ровно один перед обновлениями; придёт заново после сбоя источника)\nи `update`: `{\"type\":\"update\",\"channel\":\"trades\",\"instrument\":\"binance:perp:BTCUSDT\",\"t\":1793751079406,\"data\":{…}}`.\nИмена — `venue:market:SYMBOL`, время — Unix-мс, деньги — как есть, без округления к шагу цены.\nСбой источника соединение не рвёт: `{\"type\":\"status\",\"state\":\"reconnecting\"}`, затем `live` и\nновые снимки. Ошибки — `{\"type\":\"error\",\"code\":…}`: `rate_limited` (10 сообщений/с; открытие\nрыночной подписки канала чаще раза в секунду, см. ниже),\n`too_many_subscriptions` (200 на соединение), `slow_consumer` (клиент не успевает читать —\nсоединение закрывается), `route_not_in_plan`. Подробно — [https://docs.lootx.trade/ru/market-api/websocket](https://docs.lootx.trade/ru/market-api/websocket).\n`/v1/ws/{stream}` — прежний сырой режим (кадры источника, бета).\n\nВесь рынок `densities` или `screener` с фильтрами — без списка инструментов:\n\n```json\n{\"op\":\"subscribe\",\"id\":4,\"channel\":\"densities\",\"scope\":\"market\",\"params\":{\"venues\":[\"binance\"],\"markets\":[\"perp\"],\"min_usd\":250000,\"max_dist_pct\":2}}\n{\"op\":\"subscribe\",\"id\":5,\"channel\":\"screener\",\"scope\":\"market\",\"params\":{\"markets\":[\"perp\"],\"fields\":[\"last_price\",\"volume_24h_usd\"],\"filters\":[{\"metric\":\"volume_24h_usd\",\"op\":\"gt\",\"value\":1000000}]}}\n{\"op\":\"unsubscribe\",\"id\":6,\"channel\":\"densities\",\"scope\":\"market\"}\n```\n\nВ ответ — `subscribed` с нормализованными `params`, затем `snapshot` частями и `update` со\n`scope: \"market\"` и `items: [{\"instrument\", \"data\"}]`; инструмент вышел из фильтров скринера —\n`removed`. Повторная подписка заменяет прежнюю (одна на канал в соединении). Открывать подписку\nканала на соединении, заменой или снятием с повторной подпиской, можно раз в секунду: чаще —\n`rate_limited` с `retry_after`, и если подписка была, она остаётся с прежними фильтрами. Сколько\nтаких подписок держит аккаунт, задаёт тариф (`ws_market_subs`, сверх — `market_subs_limit`); потолок шлюза —\n`channel_unavailable`. Параметры вне списка — `bad_params`; окна и сортировки (`top_n`, `sort_by`)\nнет.\n\n## Лимиты\n\nЛимиты задаёт тариф, и считаются они на **аккаунт**: все ключи одного человека делят один\nзапас. Что может ограничивать тариф:\n\n- запросов в минуту (с допустимым всплеском);\n- запросов в час и в сутки — окна UTC, с `hh:00` и с `00:00`;\n- байт выдачи в сутки (сброс в 00:00 UTC) — кадры WebSocket считаются вместе с REST: кончился\n  объём — кадр `error` `daily_quota_exceeded` и закрытие 1008;\n- глубину истории в днях;\n- одновременные WebSocket и рыночные подписки на них.\n\nСумма площадок (`instruments=`) весит столько запросов, сколько в ней площадок: столько же\nвызовов источника. Окну, где осталось меньше, — `429` целиком, остаток не тронут.\n\nТариф может задать свои лимиты группе маршрутов — например, `heatmap` или секундным свечам\n`candles_1s` (`/v1/candles` с `tf` меньше минуты) — или закрыть группу: тогда ответ\n`403 route_not_in_plan`. Лимит группы действует вместе с общим, а не вместо него.\n\nКаждый ответ с ключом (успешный и с ошибкой) несёт заголовки лимитов ([подробно](https://docs.lootx.trade/ru/market-api/limits#zagolovki)). `X-RateLimit-*` — самое\nтесное из действующих окон (где осталось меньше всего), IETF `RateLimit-Policy`/`RateLimit`\n(draft-ietf-httpapi-ratelimit-headers) — все окна тарифа запроса:\n\n| заголовок | смысл |\n|---|---|\n| `X-RateLimit-Limit` | величина лимита |\n| `X-RateLimit-Remaining` | сколько запросов ещё можно сделать |\n| `X-RateLimit-Reset` | момент сброса, Unix-секунды: запас восстановится (минута) или сменится окно (час, сутки). **С 04.11.2026** — до этого заголовок означал «через сколько секунд»; сколько ждать — `Retry-After` и `t=` в `RateLimit` |\n| `X-RateLimit-Scope` | `account` — общий лимит аккаунта, `route:<группа>` — лимит группы |\n| `X-RateLimit-Window` | `minute`, `hour`, `day` или `bytes_day` |\n| `RateLimit-Policy` | окна тарифа: `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\", \"route:heatmap:day\";q=5000;w=86400` |\n| `RateLimit` | остаток (`r`) и секунд до сброса (`t`): `\"minute\";r=412;t=12, \"day\";r=45000;t=3600` |\n| `Retry-After` | (при `429` и `503`) через сколько секунд повторить |\n| `X-Request-Id` | идентификатор запроса — свой (до 64 знаков `A-Za-z0-9._-`) или выданный шлюзом |\n| `Link` | (у постраничных) `<…&cursor=…>; rel=\"next\"` — адрес следующей страницы; курсор — и в `X-Next-Cursor` |\n\nЖивое состояние всех окон — `GET /v1/usage` (по ключу; сам запрос списывается из общих окон\nаккаунта — минуты, часа, суток и байт, — в окна групп не идёт; счётчики недоступны — `503 usage_unavailable`):\nтариф, лимиты аккаунта и групп, окна «сейчас» (у минуты — целые жетоны ведра с пополнением),\nотказы по лимиту за сутки и последний из них.\n\nОтказы `429`: `rate_limited` (минута), `hourly_limit` (час), `daily_limit` (сутки),\n`daily_quota_exceeded` (объём; `X-RateLimit-Limit` у него — в байтах). В теле отказа —\n`limit`, `remaining`, `window`, `scope`, `retry_after`, `reset_at_ms`. Объём учитывается после\nответа: запрос, начатый до исчерпания, отдаётся целиком, следующий получит `429`. Отказ по\nлимиту не расходует ни одного счётчика.\n\nИсточники за шлюзом защищены очередью: у каждого — свой потолок одновременных запросов шлюза.\nОчередь полна дольше 2 с — `503 upstream_busy` с `Retry-After`; SDK повторяют такой запрос\nсами. Ответы на закрытые диапазоны (конец раньше «сейчас − 2 минуты») шлюз помнит до 10 минут\n(бинарь тепловой карты — до часа): заголовок `X-Cache: HIT` — ответ из памяти шлюза, `MISS` —\nот источника; у открытого края заголовка нет. Попадание считается в лимитах и объёме как\nобычный ответ.\n\nЗапрос глубже разрешённой истории (общей или группы) получает `403 history_out_of_plan` с\n`history_days` и самой ранней допустимой отметкой `earliest_allowed_ms` в теле. Токены терминала Lootx (JWT) работают по лимитам своего тарифа:\nfree — 60 запросов/мин и 30 дней истории, basic — 300/мин и 365 дней, pro — 900/мин,\napi — 6000/мин, без ограничения глубины.\n\n## Форматы\n\nПо умолчанию ответ — JSON. Тот же ответ можно получить бинарным protobuf или CSV:\n`?format=json|protobuf|csv` или заголовок `Accept: application/json | application/x-protobuf |\ntext/csv` (параметр главнее заголовка). Неизвестный `?format=` — `400 bad_format`, `Accept` без\nизвестного типа — `406 not_acceptable`. Ошибки — всегда JSON, в любом формате. Ответы сжимаются\ngzip или br по `Accept-Encoding` (кроме бинаря тепловой карты). Суточный объём считается по\nотданному телу ДО сжатия — сжатие на него не влияет: protobuf на\n20–30 % короче JSON (1000 минутных свечей: 101 КБ → 74 КБ; после gzip — 41 → 37 КБ).\n\n**protobuf** — `Content-Type: application/x-protobuf; messageType=lootx.v1.Response`. Схема —\n`GET /v1/proto` (без ключа): один конверт на любой маршрут, таблицы по колонкам (`sint64` для\nцелых и времени в мс, `double`, `string`, `bool`; null — номерами строк), прочие поля ответа —\nв `meta`, курсор — `next_cursor`. Перевод взаимно однозначный: из protobuf восстанавливается\nровно тот же JSON, целые больше 2^53 не теряются. SDK делают это сами:\n\n```python\nfrom lootx import Client                      # pip install \"lootx[protobuf]\"\n\nlx = Client(\"lx_live_...\", format=\"protobuf\")\nbars = lx.candles(\"binance:perp:BTCUSDT\", tf=\"1m\", limit=1000)\ndf = bars.to_dataframe()                       # то же, что из JSON\n```\n\n```ts\nimport { Client, records } from \"@lootx/sdk\";\n\nconst lx = new Client({ apiKey: \"lx_live_...\", format: \"protobuf\" });\nconst bars = await lx.candles({ instrument: \"binance:perp:BTCUSDT\", tf: \"1m\", limit: 1000 });\nconst rows = records(bars);                    // то же, что из JSON; большие целые — bigint\n```\n\n**CSV** — `Content-Type: text/csv; charset=utf-8`, RFC 4180: первая строка — имена колонок,\nnull — пустое поле, пустая строка — `\"\"`, массивы и объекты — JSON-текстом. Курсор следующей\nстраницы — в заголовке `X-Next-Cursor`. CSV — одна таблица: у `/v1/footprint` и\n`/v1/hyperliquid/footprint` их две, выберите\n`?format=csv&table=levels` или `table=windows`. У ответов без таблицы (`/v1/status`) CSV нет.\n\n**Бинарь тепловой карты** — только у `/v1/heatmap`: `?format=hmp1` (объёмы точными целыми,\n`application/octet-stream`) или `?format=hmp2` (объём кодом в 6–9 бит, в 3–4 раза меньше,\n`application/x-hmp2`; `qbits`, `layout`). Тело идёт потоком от источника, закрытые диапазоны\nотдаются с `ETag` и `Cache-Control: immutable` — `If-None-Match` даёт `304`. Разбор —\n[https://docs.lootx.trade/ru/market-api/heatmap-binary](https://docs.lootx.trade/ru/market-api/heatmap-binary).\nТот же бинарь — у `/v1/hyperliquid/liquidation-map/heatmap` (карта ликвидаций позиций по минутам)\nи `/v1/hyperliquid/triggers/heatmap` (книга TP/SL по минутам, `kind=tp|sl` обязателен): таблицы у\nних нет, `format=hmp2|hmp1` обязателен, ответ не кэшируется (`Cache-Control: no-store`).\nУ остальных маршрутов `format=hmp1|hmp2` — `400 bad_format`.\n\n**Кадры OPC1 опционов** — только у `/v1/options/chain/latest`, `/v1/options/chain` и\n`/v1/options/chain/range` и только параметром `?format=opc1` (`application/octet-stream`; `Accept:\napplication/octet-stream` без параметра — `406 not_acceptable`). У минуты — на цепочку uvarint-длина и\nключевой кадр с магией `OPC1` (DEFLATE внутри), цепочки без минуты — в заголовке `x-options-missing`\n(`ЦЕПОЧКА:причина,…`); у `chain/range` — кадры одной цепочки по минутам, у каждого uvarint-длина, первый\n— ключевой, следующие — как хранит источник, а минуты без кадра — в том же заголовке интервалами\n(`FROM_MS-TO_MS:причина,…`): синтаксис заголовка различают по маршруту. Валюты цепочки в кадрах нет — она\nв `/v1/options/catalog` и `/v1/options/bases`. **Предварительный формат:\nверсия кадра (байт 4 после магии `OPC1`) может вырасти без смены версии API; клиент обязан\nотвергать незнакомую версию. JSON и protobuf — стабильны.** У остальных маршрутов `format=opc1` —\n`400 bad_format`, CSV у `/v1/options/*` нет. Живые кадры — WebSocket `/v1/options/stream`\n(`base`, `venue`, `chain` до 64, `resume`): первым — текст `hello` (`epoch` процесса источника,\nцепочки и их `seq`), дальше — по кадру OPC1 на сообщение, без uvarint-длины; после обрыва —\n`resume=<epoch>:<цепочка>:<seq>,…`, и источник шлёт ровно пропущенные кадры или снова ключевой.\nЗакрытия источника (`4008 slow consumer`, `1011`, `1001`) приходят как есть, обрыв — `1013`.\n\n## Данные и единицы\n\nЦены — в валюте котировки инструмента, количества — в монетах (базовой валюте), деньги\n(`*_quote`, `quote_qty`, `usd_*`, `min_usd`) — в долларах (у USDT/USDC-пар — в валюте\nкотировки) и никогда не округляются до шага цены. У опционов (`/v1/options/*`) иначе: количества\n(`oi_asof`, `volume`, `bid_size`, `ask_size`, `min_trade`, `oi_calls`, `oi_puts`) — в контрактах\n(× `contract_size` — монеты базы), цены `bid`, `ask`, `mark` — за 1 монету базы в валюте котировки\nцепочки (`price_ccy`; inverse — в монете базы), деньги `*_usd_e8` — в валюте площадки\n(`volume_usd_ccy`, `volume_notional_ccy`).\n\n| маршрут | что | заметки |\n|---|---|---|\n| `/v1/series` | ряд `t, value`: `metric=cvd\\|delta\\|volume\\|trades_n`, `unit=quote\\|base`; размер сделки — `metric=delta_size\\|cvd_size`, `by=hit\\|print` (по умолчанию `hit`): `t`, 10 корзин `b0_1k … b5m_plus` (дельта в монетах по размеру сделки в $, сетка — `bins`), `partial` | CVD копится от `from`; курсор несёт сумму — следующая страница её продолжает. `tf` меньше минуты — секундная история тарифа. У рядов размера `unit` — только `base`, суммы площадок нет |\n| `/v1/delta` | дельта агрессора по окнам 1s…1d: покупки, продажи, дельта, её экстремумы внутри окна — в монетах и в $ | окна без сделок не приходят |\n| `/v1/trades` | ленты сделок: `t, price, qty, quote_qty, side, aggregated, fills, trade_id, seq`; `side` — `buy`/`sell` агрессора | **не все сделки**: хранятся сделки от порога символа ($200–$5000 по обороту) в горячем слое за последние дни и от $5000 в архиве (бессрочно). Порог слоя — `source_min_usd` ответа, свой порог — `min_usd` |\n| `/v1/heatmap` | тепловая карта стакана: только ненулевые ячейки `t, side, price, qty` (объём в монетах, `agg=avg\\|max`) | до 4096 колонок и 500 000 ячеек в таблице — больше `413 too_large`: сузьте окно, укрупните `tf`/`price_step` или возьмите `format=hmp1\\|hmp2` |\n| `/v1/book/bands` | полосы книги по окнам: `ts, sample_ms, best_bid, best_ask, mid`, нарастающие полосы `bid_bp10_e8 … bid_bp1000_e8`, `ask_bp10_e8 … ask_bp1000_e8` (±0,1 … ±10 % от mid), `reach_bid_bp, reach_ask_bp, complete_bid, complete_ask, closed` | уровень, а не поток: значение окна — последний срез. `tf` — `1s, 5s, 10s, 15s, 30s` (секунды — только у символов правила s1, 7 суток) или `1m … 1d`; прочие — `400`. Полосы — e8 USD строкой; полоса `k` полная ⇔ `k < complete_*`, иначе это нижняя граница. Окно без среза — строки нет. До 20 000 окон — больше `413 too_large`. `bands=deep` — 11 полос: ещё `bid_bp300_e8`, `bid_bp800_e8`, `bid_bp1500_e8`, `bid_bp10000_e8` (вся сторона) и те же `ask_…`; ячейка `null` — «неизвестно», а не 0; полосу брать по `bands_bp`, а не по номеру |\n| `/v1/tape/events` | события ленты одного инструмента за `[from, to)` (`from`, `to` обязательны: мс или ISO-8601), колонками длины `n` по `first_ms`: `id`, `kind` (`hit` — крупный удар, `run` — агрессивная серия, `level` — сделки на одной цене), `side`, `state`, `end`, `price_first, price_last, price_lo, price_hi, price_scale, qty_scale`, `first_ms, last_ms, dur_ms`, `hits, trades, levels`, `qty_side, qty_counter`, `usd_side_e8, usd_counter_e8, usd_max_hit_e8`, `move_ticks, move_bp, speed_bp_s, impact_bp_per_musd`, `score`, `run_id, link_ice_id, actor`, `quality, source`; скаляры `exchange, market_type, symbol` (имена источника), `n, units_revision, det_rev, limit, truncated, asof_ms` | `id`, `run_id`, `link_ice_id` и деньги `usd_*_e8` (e8 USD) — строкой; цены и количества — целыми в шкале строки. Окно — не шире 31 суток (шире — `400`). `end`: `gap`, `reversal`, `counter`, `max_dur`, `absorbed`, `reset`, у уровня итог `held`/`broke`; `lost` — событие потеряно (закрытие не дошло), `state` при этом `open`; `null` — у удара всегда, у серии и уровня — пока `open`. Фильтры: `kind` (через запятую), `side=buy\\|sell`, `state=open\\|closed\\|all` (`open` — идущие, `closed` — закрытые и потерянные), `source=live\\|archive\\|all`, `min_score` 0–1000, `min_usd` — доллары десятичной записью (до 10 цифр целой части и 8 после точки), `limit` от 1 (больше 50 000 — 50 000, скаляр `limit` — действующий; больше найденных — `truncated`). `asof_ms` — знак склада, `null` — нет. Вес — сутки окна, вверх (1–31). Закрытое осевшее окно без потерянных событий источник отдаёт `immutable` — повтор из кэша, иначе `no-store`; у каждого ответа `ETag` вида `\"t…-…-o…\"` (`If-None-Match` — `304`). Только `json` и `protobuf` |\n| `/v1/tape/profile` | квантили метрики символа по последнему снимку профиля (`metric=` обязателен: `hit_usd`, `run_usd`, `level_usd`, `run_move_bp`, `hit_gap_ms`, `trade_gap_ms`): `exchange, market_type, symbol, metric, unit, units_revision, samples, ts_ms, quantiles` (`p50, p90, p99, p99_5`) и ровно одно из `values_e8` / `values_bp` / `values_ms` по `unit` (`usd_e8` / `bp` / `ms`) | по нему событиям дана сила `score`; деньги `values_e8` — e8 USD строкой, ход — б. п., промежутки — мс. Снимка нет — `200`, `samples` 0, `ts_ms` и значения `null`. `no-store`, без `ETag`. Только `json` и `protobuf` |\n| `/v1/hyperliquid/footprint` | HL-футпринт NL/NS: уровни `ts, price, dl_taker, ds_taker, dl_maker, ds_maker, n_fills` и окна `ts, closed` | изменение лонгов (`dl`) и шортов (`ds`) в монетах: + открыли, − закрыли. NL/NS по всем — `dl_taker + dl_maker` = `ds_taker + ds_maker` = ΔOI; тейкер — `dl_taker`/`ds_taker`; мейкер — `dl_maker`/`ds_maker`. `tf` от `1m`; HIP-3 — `hyperliquid:perp:AAPLUSDC.XYZ` |\n| `/v1/funding/events` | начисления фандинга: `t, rate, mark_price` | ставка — доля за период выплаты биржи |\n| `/v1/ls-ratio` | long/short ratio по бакетам 5 минут: `ts, as_of, kind, long_ratio, short_ratio, long_short_ratio, buy_vol, sell_vol, unit`; `kind=global_account\\|top_account\\|top_position\\|taker_volume\\|global_account_ccy`, без `kind` — все виды | `as_of` — момент значения: у долей Binance и Bybit — `ts`, у `taker_volume` Binance и всех видов OKX — `ts` + 5 минут; ряды разных бирж сводите по `as_of`. Объёмы тейкера `buy_vol`, `sell_vol` — строкой, точно, в монетах. Идущий бакет дописывается — перечитывайте последние ~10 минут |\n| `/v1/ls-ratio/latest` | новейшая строка каждого вида за 35 дней, колонки как у `/v1/ls-ratio` | строк нет — `404 not_found` |\n| `/v1/mark` | mark и index перпа: `tf=1s` — `ts, mark, index, premium`; `tf=1m` (по умолчанию) — `ts, mark_open, mark_high, mark_low, mark_close, index_close, premium, secs` | цены — строкой в точности биржи, разбирайте как decimal; `premium` = mark / index − 1 числом. Секунды — 7 суток, окно `1s` — до часа за запрос; секунда без строки держит прошлое значение. Идущая минута не отдаётся. У Hyperliquid index — оракульная цена |\n| `/v1/mark/latest` | новейшая секунда, колонки как у `/v1/mark?tf=1s` | строки нет — `404 not_found` |\n| `/v1/margin/assets` | активы пула маржи Binance за окно `window=1d\\|7d\\|30d\\|90d` (по умолчанию `7d`): займы, возвраты, чистые займы и их z, изменения, запас, цена, ставки Binance, OKX, Bybit и Gate | `as_of` — минута кэша источника. `units=usdt` — деньги `*_usd_e8` целым строкой (USDT × 10⁸); количества, цены и ставки — десятичной строкой; `null` — данных нет (без ключа Binance у источника — запас и суммы), а не ноль. Глубина тарифа меряется окном: отказ называет `window` |\n| `/v1/margin/series` | ряд одного актива `asset=` по шагу `step=1m\\|5m\\|1h`: `ts` и колонки метрик `metrics=` | окно по умолчанию — 1, 7 или 30 суток по шагу; глубина тарифа — по `from`, округлённому вниз к шагу, как его округлит источник. Закрытое окно — со слабым `ETag`: `If-None-Match` — `304`, повтор — из кэша шлюза |\n| `/v1/margin/compare` | чистые займы нескольких активов `assets=` в USDT по бакетам и цена BTC: `ts, btc_price_usdt, net_usd_e8:<АКТИВ>` | окно и глубина — как у `/v1/margin/assets` |\n| `/v1/margin/events` | эпизоды «пул пуст», задевшие окно, новые первыми: `asset, kind, start, end, end_reason, borrow_24h, borrow24h_usd_e8, growth_pct, empty_for_s` | эпизодов нет (и без ключа Binance) — пустые `rows`, `200` |\n| `/v1/margin/rates` | ставки по активу: `ts, venue, side, vip_level, rate_apr, src_unit, borrow_limit`; Binance, OKX, Bybit — заёмщика (`side=borrow`), Gate — кредитора (`side=lend`) | `rate_apr` — годовая доля строкой; окно по умолчанию — сутки, до 31; `side=borrow` строк Gate не даёт; `ETag` и `304` — как у series |\n| `/v1/margin/coverage` | покрытие источников маржи: состояние, новейшая минута, дыры за сутки | таблицы нет — CSV `400`; без ключа Binance у запаса `state: no_key`, остальное отвечает; `events_truncated: true` — эпизодов за 90 суток больше 5 000, в `events` — новейшие 5 000 |\n| `/v1/options/bases` | базы опционов площадок и их цепочки с тем, что листингуется: `venues[{venue, bases[{base, chains[{chain, settle, price_ccy, catalog_ver, instruments, expiries}]}]}]` | без `venue=` — все четыре площадки; `price_ccy` — валюта цен цепочки (валюта котировки цепочки); `ETag` — хэш тела, `If-None-Match` — `304` |\n| `/v1/options/catalog` | инструменты опционов базы `base=` по цепочкам (`chains[{chain, catalog_ver, settle, price_ccy, volume_usd_ccy, volume_notional_ccy, instruments}]`): валюта цепочки (`price_ccy` — валюта котировки цепочки, в ней цены); страйк, экспирация, `type`, размер контракта, шаг цены и его ступени, наименьшая заявка | площадки — `venue=deribit` (по умолчанию), `binance`, `bybit`, `okx`; `chain=` — одна цепочка. Числа — десятичной строкой. `ETag` — по `catalog_ver`: `If-None-Match` — `304`. Подробно — [https://docs.lootx.trade/ru/market-api/options](https://docs.lootx.trade/ru/market-api/options) |\n| `/v1/options/expiries` | экспирации по цепочкам: `calls`, `puts`, `settlement_period`, валюта цепочки, суммы объёма новейшей минуты `volume_usd_e8`, `volume_notional_usd_e8` и OI новейшей минуты (`oi_calls`, `oi_puts` — в контрактах, `oi_coins` — монеты базы, `oi_asof_ms`, `oi_rows`) | ключи — по алфавиту; деньги — целым строкой (× 10⁸) в валюте площадки: `volume_usd_e8` — премия за 24 ч (Deribit — USD, Binance — USDT), `volume_notional_usd_e8` — номинал за 24 ч, только Bybit (в монете расчёта: USDT; на `_USDC` — USDC); USDT — не USD; `null` — поля у площадки нет или кадра ещё нет |\n| `/v1/options/chain/latest` | последняя минута цепочек базы: `chains[{chain, ts_min, snap_ts, oi_asof_ms, catalog_ver, settle, price_ccy, volume_usd_ccy, volume_notional_ccy, rows}]`, строка — `expiry_ms, strike, type, instrument, bid, ask, mark, iv_bp, oi_asof, volume, volume_usd_e8, volume_notional_usd_e8, forward, index, bid_size, ask_size`. | цены (`bid`, `ask`, `mark`) — за 1 монету базы, десятичной строкой в валюте котировки цепочки (`price_ccy`; inverse — в монете базы), количества (`oi_asof`, `volume`, `bid_size`, `ask_size`) — в контрактах (× `contract_size` — монеты базы), деньги — как у `expiries`, `iv_bp` — 0,01 пункта волатильности, OI — на момент `oi_asof_ms`. Цепочки без минуты — в `missing` и заголовке `x-options-missing`. `format=opc1` — кадры OPC1 как есть (`application/octet-stream`, предварительный формат — см. «Форматы»). CSV нет |\n| `/v1/options/chain` | минута, закрытая в `at` или раньше (`at` обязателен: мс или ISO-8601), колонки — как у `chain/latest` | глубина тарифа — по началу этой минуты (`param: at`). Целая осевшая минута — `immutable`, повтор — из кэша шлюза; неполная (`missing`) — `no-cache` |\n| `/v1/options/chain/range` | история одной цепочки (`chain=` обязателен) за `[from, to)` — целые минуты, до 360: `format=opc1` — кадры цепочки по минутам, JSON — ряд одного инструмента (`instrument=` обязателен) `rows[{ts_min, snap_ts, oi_asof_ms, catalog_ver, …строка chain}]` | глубина тарифа — по `from`; вес запроса — час диапазона (1–6 единиц). Минуты без кадра — в `missing` и интервалами в `x-options-missing`; целый осевший диапазон — `immutable`, повтор — из кэша шлюза; диапазон в настоящее — `no-cache` |\n| `/v1/options/vol/book-range` | ряды волатильности книги базы (с `chain=` — одной цепочки) за `[from, to)` по шагу `step` — `1h` или `1d` (`from`, `to`, `step` обязательны): `rows[{ts_ms, index, atm_iv_bp{d7, d30, d90}, put25_iv_bp_30d, call25_iv_bp_30d, rr25_bp_30d, bf25_bp_30d}]`, `coverage{complete, gaps}` — IV и улыбка 25Δ в базисных пунктах целым, `index` — строкой, `null` — нет данных | `1h` — до 90 суток, `1d` — до 365, иначе `400` до источника; глубина тарифа — по `from`; вес — 1 единица на 64 точки шага (1–34). Целый осевший ряд — `immutable`, повтор — из кэша шлюза; `503` с `Retry-After` — источник уже читает предельное число холодных рядов |\n| `/v1/options/exposure/latest` | экспозиция новейшей минуты книги базы (с `chain=`) или суммы площадок (`venue=all`, без `chain`) по группе экспираций `expiry` — `0dte`, `1d`, `7d`, `31d`, `91d`, `all` (`mode` — только `naive`): `totals{gex_usd_e8, dex_usd_e8, vex_usd_e8, cex_usd_e8}`, `strikes[{strike, gex_call_usd_e8, gex_put_usd_e8, dex_usd_e8, vex_usd_e8, cex_usd_e8, oi_call_coins, oi_put_coins, venue_share?}]`, `profile[{price, gex_usd_e8}]`, `coverage{complete, gaps}` — деньги целым строкой (× 10⁸) в валюте `usd_ccy` (USDT — не USD), OI — монеты базы строкой, `null` — нет данных | `venue=all` с `chain` — `400` до источника; без окна и глубины; вес — 1; живой ответ — `no-cache`, `ETag`/`304` насквозь, мимо кэша шлюза |\n| `/v1/options/levels/range` | история уровней одной книги за `[from, to)` по шагу `step` — `1m`, `5m` или `1h` (`from`, `to`, `step` обязательны; `expiry`, `mode` — как у экспозиции): `rows[{ts_ms, spot, fwd, zero_gamma, zero_gamma_sticky_delta, unstable, call_walls, put_walls, abs_gamma, net_gex_usd_e8, max_pain, max_pain_expiry_ms, move_straddle_bp, move_sigma_bp}]`, `coverage{complete, gaps}` — `net_gex_usd_e8` целым строкой (× 10⁸) в валюте `usd_ccy` (USDT — не USD), цены строкой, `null` — нет данных | `1m` — до 7 суток, `5m` — до 30, `1h` — до 90, иначе `400` до источника; `venue=all` — `400`; глубина тарифа — по `from`; вес — 1 единица на 1440 точек шага (1–7). Целый осевший ряд — `immutable` от источника, повтор — из кэша шлюза; `503` с `Retry-After` — источник уже читает предельное число рядов уровней |\n| `/v1/options/stream` | WebSocket кадров цепочек базы: текст `hello` (`epoch`, `chains[{chain, seq, live}]`), затем кадры OPC1 по одному на сообщение (предварительный формат), по порядку `seq` цепочки | параметры — `base`, `venue`, `chain` (до 64), `resume=<epoch>:<цепочка>:<seq>,…`; отказ до апгрейда — HTTP-статусом (`400`, `404`, `503` с `Retry-After`); закрытия источника `4008`, `1011`, `1001` — как есть; соединение — один запрос, байты — в суточный объём |\n| `/v1/options/coverage` | покрытие базы: цепочки (`last_ts_min`, `lag_ms`, несобираемая минута `unbuilt`) и дыры сбора окна `from`–`to` (`stream`: `chain`, `live`, `catalog`, `oi`, `quotes`; `chain: null` с `source` — дыра неопознанной единицы опроса) | окно по умолчанию — сутки до сейчас, до 31 суток; глубина тарифа — по `from` |\n| `/v1/densities/history` | закрытые стены плотностей: `kind=pulled\\|eaten`, цена, объём и $ на открытии и на пике, длительность | глубина хранения — 90 дней; страницы — от свежих к старым |\n| `/v1/icebergs` | айсберги и поглощения: `state=active\\|ended\\|all` | из памяти узла: идущие и последние 2000 закончившихся |\n| `/v1/hyperliquid/liquidation-map` | уровни ликвидаций позиций Hyperliquid по цене за последнюю минуту книги: `price, long_usd, short_usd, long_count, short_count, long_isolated_usd, short_isolated_usd` | одна монета: `instrument=hyperliquid:perp:BTC`, HIP-3 — `hyperliquid:perp:AAPLUSDC.XYZ` (монета `xyz:AAPL`). `fresh: false` — минута несвежая у источника или старше 3 минут; `coverage` — какая доля OI известна. `*_e8` — строкой, USD × 10⁸; `*_usd` — оценка числом |\n| `/v1/hyperliquid/positions/top`, `/v1/hyperliquid/whales` | крупнейшие позиции монеты: адрес, сторона, размер, $, вход, цена ликвидации, расстояние до неё, плечо | `fresh` и `coverage` — как у карты |\n| `/v1/hyperliquid/whales/journal` | журнал китов: `ts, instrument, user, action, size_before, size_after, px, notional_e8, fee_e8, fee_token, closed_pnl_e8, tid, block`, новые первыми | без `instrument` — весь рынок; `*_e8` и `tid` — строкой; `fresh` нет (лента) |\n| `/v1/hyperliquid/long-short` | счета и суммы лонгов и шортов: `instrument, long_accounts, short_accounts, long_e8, short_e8, collateral` | без `instrument` — все монеты; суммы — строкой в залоге дека × 10⁸ |\n| `/v1/hyperliquid/coverage` | покрытие книги позиций монеты: доли, суммы, свежесть снимка | таблицы нет — CSV `400` |\n| `/v1/hyperliquid/triggers` | книга TP/SL монеты сейчас — неисполненные тейк-профиты и стоп-лоссы всех счетов по ячейкам цены: `price`, `tp_long_size … sl_short_size` (монеты), `tp_long_usd … sl_short_usd`, `tp_long_count … sl_short_count` | `coverage.notional_e8` по видам — строкой, USD × 10⁸; `*_usd` — оценка числом. `fresh: false` — строк нет: «неизвестно», а не «ордеров нет». Книга не включена на узле — `404 not_available` |\n| `/v1/screener/metrics` | справочник метрик скринера: ключ, имя, единица, окно, группа, описание | `/v1/screener?names=long` (по умолчанию) — колонки длинными именами, `names=short` — ключами |\n\n## Ошибки\n\nЛюбая ошибка — HTTP-код и тело\n`{\"error\":{\"code\":\"snake_case\",\"message\":\"...\",\"request_id\":\"...\",\"docs_url\":\"...\", …детали}}` —\nна любом пути, включая `404`/`405` (с `Allow`), `406`, `413` и внутренние сбои. Детали —\nтолько к месту: `param`/`expected` (неверный параметр), `limit`/`remaining`/`window`/`scope`/\n`retry_after`/`reset_at_ms` (лимит), `history_days`/`earliest_allowed_ms` (глубина истории).\n`docs_url` ведёт на описание именно этого кода — `https://docs.lootx.trade/ru/market-api/error-codes#<код>`. `401` несёт `WWW-Authenticate: Bearer realm=\"lootx\"`.\n`request_id` совпадает с заголовком `X-Request-Id` — пришлите его в поддержку.\n`message` предназначен человеку и может меняться; разбирайте `code`.\n\nПустой список — нормальный ответ: в окне нет данных. На всех маршрутах, кроме `/v1/candles` и `/v1/series`, он не означает, что инструмент существует, это верно и для опечатки: сверяйтесь с `/v1/instruments`. На `/v1/candles` и `/v1/series` символ, по которому у источника нет истории вообще и которого нет ни в одном списке, получает `400 unsupported_instrument` с `param: \"symbol\"` ([условия и пределы](https://docs.lootx.trade/ru/market-api/error-codes#unsupported_instrument)). Тот же код с `param: \"instrument\"` — рынок или биржа, которых у источника нет. На `/v1/oi`, `/v1/funding`, `/v1/funding/events`, `/v1/ls-ratio`, `/v1/mark` и `/v1/screener?instruments=` этот отказ получает ещё и символ с неразобранной котировкой, например `okx:perp:BTC-USDT-SWAP`. Биржу не сверяет только `/v1/screener?instruments=`: неизвестная биржа там даёт не отказ, а отсутствие строки. У `/v1/screener` без `instruments=` биржу сверяет фильтр `venue=`, отказ у него другой: `400 bad_request` с `param: \"venue\"`.\n\n\n## Ошибки {#errors}\n\nЧто значит каждый код и что делать — [https://docs.lootx.trade/ru/market-api/error-codes](https://docs.lootx.trade/ru/market-api/error-codes); `docs_url` ошибки ведёт прямо на её код.\n\n| код | HTTP | когда |\n|---|---|---|\n| `bad_request` | 400 | Параметры запроса не разобрались |\n| `bad_instrument` | 400 | Инструмент не в виде venue:market:SYMBOL |\n| `unsupported_instrument` | 400 | Такого рынка у источника нет; у `/v1/candles` и `/v1/series` — и символа, истории по которому нет |\n| `bad_cursor` | 400 | Курсор не разобрался: он повреждён. С параметрами запроса он не сверяется |\n| `bad_format` | 400 | Неизвестный формат ответа; CSV — только для одной таблицы |\n| `key_in_query` | 400 | Ключ передан в строке запроса — так нельзя, он попадает в логи |\n| `missing_key` | 401 | Нет ключа: заголовок Authorization: Bearer или X-API-Key |\n| `invalid_key` | 401 | Ключ неизвестен |\n| `invalid_token` | 401 | JWT не прошёл проверку |\n| `token_expired` | 401 | Срок JWT истёк |\n| `revoked_key` | 403 | Ключ отозван |\n| `plan_inactive` | 403 | Тариф не активен |\n| `insufficient_scope` | 403 | У ключа нет нужной области доступа |\n| `history_out_of_plan` | 403 | Запрошена история глубже, чем разрешает тариф (общий лимит или лимит группы маршрутов) |\n| `route_not_in_plan` | 403 | Группа маршрутов не входит в тариф |\n| `invalid_secret` | 401 | Служебный маршрут: неверный X-Internal-Secret |\n| `forbidden` | 403 | Доступ запрещён |\n| `not_found` | 404 | Нет такого маршрута |\n| `not_available` | 404 | Маршрут известен, но таких данных ещё не собирается (карты, сводки и прогнозные уровни ликвидаций `/v1/liquidations/*`) или они не включены на узле (книга TP/SL Hyperliquid `/v1/hyperliquid/triggers*`) — это не ошибка запроса и не сбой источника |\n| `method_not_allowed` | 405 | Метод не поддерживается маршрутом; разрешённые — в заголовке Allow |\n| `not_acceptable` | 406 | Accept без известного типа: application/json, application/x-protobuf или text/csv |\n| `request_timeout` | 408 | Запрос не дошёл до шлюза вовремя |\n| `payload_too_large` | 413 | Тело запроса больше допустимого |\n| `too_large` | 413 | Ответ слишком велик: сузьте окно, укрупните шаг или возьмите бинарный формат |\n| `rate_limited` | 429 | Превышен лимит запросов в минуту (аккаунта или группы маршрутов); у потока — команд в секунду или открытий рыночной подписки канала (`window: second`, `scope: connection`, прежняя подписка, если она есть, остаётся); `scope: ip` — предохранитель по адресу до проверки ключа (`window: second`); см. Retry-After |\n| `hourly_limit` | 429 | Исчерпан лимит запросов в час; сброс в начале следующего часа UTC |\n| `daily_limit` | 429 | Исчерпан лимит запросов в сутки; сброс в 00:00 UTC |\n| `daily_quota_exceeded` | 429 | Исчерпан суточный объём выдачи (аккаунта или группы маршрутов); сброс в 00:00 UTC |\n| `ws_limit` | 429 | Превышено число одновременных WebSocket-соединений |\n| `upstream_rejected` | 400 | Источник отверг параметры запроса |\n| `upstream_error` | 502 | Источник ответил ошибкой |\n| `upstream_unavailable` | 502 | Источник недоступен; у потока — закрытие 1013 с этой причиной: источник оборвал соединение (у `/v1/options/stream` — и без кадра закрытия), переподключиться позже |\n| `upstream_timeout` | 504 | Источник не ответил вовремя |\n| `upstream_busy` | 503 | Очередь шлюза к источнику полна — повторите через Retry-After |\n| `upstream_not_configured` | 503 | Источник не подключён к шлюзу |\n| `auth_unavailable` | 503 | Проверка ключа временно недоступна |\n| `usage_unavailable` | 503 | Журнал выдачи или счётчики лимитов временно недоступны (/internal/usage, /v1/usage) — повторите через Retry-After |\n| `unavailable` | 503 | Сервис временно недоступен — повторите через Retry-After |\n| `internal` | 500 | Внутренняя ошибка шлюза |\n| `bad_params` | поток | Поток: неверные `params`/`scope` — у подписки по инструментам параметров нет, у рыночной (`scope: market`) — только перечисленные в описании протокола; что не так — в тексте ошибки |\n| `market_subs_limit` | поток | Поток: аккаунт уже держит столько рыночных подписок, сколько разрешает тариф (`limit`, `remaining`, `scope: account`) — снимите лишнюю |\n| `unknown_channel` | поток | Поток: нет такого канала; список — в тексте ошибки |\n| `channel_unavailable` | поток | Поток: канал не подключён к источнику или заполнен (в том числе потолок рыночных соединений шлюза, `scope: market`) — повторите позже |\n| `too_many_instruments` | поток | Поток: аккаунт держит в канале больше инструментов, чем его доля ёмкости шлюза — отпишитесь от ненужных |\n| `too_many_subscriptions` | поток | Поток: превышен потолок подписок на соединение (`limit`, `remaining`, `window: concurrent`) |\n| `slow_consumer` | поток | Поток: клиент не успевает читать — очередь переполнена, соединение закрыто кодом 1008. У `/v1/options/stream` медленного клиента закрывает источник: код 4008 и причина `slow consumer` — переподключиться с `resume`; там же 1011 `hello` (источник не собрал hello) и 1001 (источник останавливается) — код и причина источника как есть |\n",
    "license": {
      "name": "UNLICENSED",
      "identifier": "UNLICENSED"
    },
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://market-api.lootx.trade"
    }
  ],
  "paths": {
    "/v1/book/bands": {
      "get": {
        "tags": [
          "market"
        ],
        "summary": "Полосы книги.",
        "description": "Уровень, а не поток: значение окна — последний срез окна. Деньги — e8 USD строкой, неполные\nполосы помечены `complete_*`, открытые окна — `closed: false`. `bands=deep` — одиннадцать\nполос до всей стороны, `null` — «неизвестно».",
        "operationId": "book_bands",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/heatmap",
          "description": "Тепловая карта"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "tf",
            "in": "query",
            "description": "Окно: 1s, 5s, 10s, 15s, 30s (секунды — у символов правила s1) или 1m, 5m, 15m, 30m, 1h,\n4h, 1d. Прочие — 400: полосы — уровень, а не поток. По умолчанию 1m.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1m"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс; выравнивается вниз к сетке tf. По умолчанию — 60 окон назад от `to`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс, не включительно; выравнивается вверх к сетке tf.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "bands",
            "in": "query",
            "description": "Набор полос. Без параметра — семь полос ±0,1 … ±10 % (24 колонки, ответ прежний). `deep` —\nодиннадцать: плюс ±3, ±8, ±15 % и `10000` — вся сторона (биды до нуля, аски до 2·mid), 32\nколонки; полоса `null` — «неизвестно» (строки до миграции 021 источника), а не 0. Номера\nполос в наборах разные: полосу брать по `bands_bp`, а не по номеру. Иное (`DEEP`, пусто,\n`classic`) — 400.",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Набор полос: `deep` — одиннадцать полос до всей стороны; без параметра — семь полос\n±0,1 … ±10 % от mid.",
              "enum": [
                "deep"
              ]
            },
            "example": "deep"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Полосы колонками: ts, sample_ms, best_bid, best_ask, mid, bid_bp10_e8 … bid_bp1000_e8, ask_bp10_e8 … ask_bp1000_e8 (e8 USD строкой, нарастающие), reach_bid_bp, reach_ask_bp, complete_bid, complete_ask, closed; скаляры bands_bp, units_revision, source, asof_ms. Окно без среза — строки нет. Секунды — только у символов правила s1, у прочих пусто. bands=deep — 32 колонки: полосы bid_bp{10,25,50,100,200,300,500,800,1000,1500,10000}_e8 и ask_… (10000 — вся сторона), e8 строкой или null — «неизвестно» (строки до миграции 021), а не 0; complete_* — до 11, полосу брать по bands_bp, а не по номеру",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BandsResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры; tf не из словаря (полосы — уровень, а не поток); bands не deep (param: bands); instruments= с двумя и больше инструментами — суммы полос нет; источник отверг запрос (upstream_rejected)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области clusters, группа heatmap не в тарифе или история глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "413": {
            "description": "Окон больше 20 000 — сузьте окно или возьмите tf крупнее",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или полосами не той формы (в том числе не того набора: на bands=deep узел без миграции 021 ответил семью полосами); у узла нет таблиц полос (миграция 020)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/candles": {
      "get": {
        "tags": [
          "market"
        ],
        "summary": "Свечи. Источник — data `/v2/bars` (data-api/src/v2.rs:182; формат проверен по коду):\n`{\"d\":[{\"t\":сек,\"o\",\"h\",\"l\",\"c\",\"v\",\"qv\",\"vb\",\"qvb\",\"n\",\"nb\",...}],\"cov\":{\"oldest\",\"newest\"},\n\"deep_until\"?:сек}`. Левее `deep_until` — глубокий ярус (свечи `ohlc_*` с листинга): у бара\n`v = vb = qvb = nb = 0` числом, `n = 0` у бирж без счётчика — шлюз отдаёт их `null`\n([`candle_cell`]), шов — в `deep_until` ответа, мс. data отдаёт шов у любого символа со\nстроками `ohlc_*` при любом окне — и в живом, целиком правее шва.",
        "description": "Пустое окно — первый целый бакет не раньше `to` (`candle_page` округляет начало вверх, и data\nполучает `from >= to`) — тот же вызов data: `/v2` отвечает на него не отказом, а пустой\nстраницей с `cov` (и швом, как у любого окна; data timerange.rs `from_query_or_empty` — нарочно\nдля шлюза и навсегда). По этому `cov` дверь опечатки (`require_known`) отличает неизвестный\nсимвол (`400 unsupported_instrument`) от пустого окна известного (`200` с `coverage`).",
        "operationId": "candles",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/candles",
          "description": "Свечи"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Инструмент `venue:market:SYMBOL`. Обязателен, если нет `instruments`.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "instruments",
            "in": "query",
            "description": "Сумма площадок одной монеты вместо `instrument`: 2..12 инструментов через запятую\n(docs/CONTRACTS.md, «Сумма площадок»). Объёмы и сделки — суммой, OHLC — первого в списке\n(`price_anchor`); в конце строки — `venues_present` и `venues_mask`. Вес запроса — N.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT,bybit:perp:BTCUSDT"
          },
          {
            "name": "tf",
            "in": "query",
            "description": "Шаг свечи: `1s`, `1m`, `5m`, `1h`, `1d` или любое число с суффиксом s/m/h/d, до суток.\nШаг меньше минуты требует секундной истории в тарифе.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1m"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало окна, включительно: Unix-мс UTC или ISO-8601 — `2024-01-01` (полночь UTC),\n`2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm]` (без зоны — UTC; `+` зоны в query — `%2B`). По\nумолчанию `to - limit * tf`. Число — меньше `10000000000000` (13 знаков; больше — 400:\nмикро- или наносекунды), дата — раньше 2286-11-20T17:46:40Z.",
            "required": false,
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unix-миллисекунды UTC, меньше 10000000000000 (больше — 400: микро- или наносекунды)"
                },
                {
                  "type": "string",
                  "description": "ISO-8601: 2024-01-01 (полночь UTC) или 2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm], без зоны — UTC; «+» зоны в query — %2B; раньше 2286-11-20T17:46:40Z"
                }
              ]
            },
            "example": 1791331200000
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец окна, НЕ включительно: Unix-мс UTC или ISO-8601, как у `from`, с тем же потолком. По\nумолчанию — сейчас.",
            "required": false,
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unix-миллисекунды UTC, меньше 10000000000000 (больше — 400: микро- или наносекунды)"
                },
                {
                  "type": "string",
                  "description": "ISO-8601: 2024-01-01 (полночь UTC) или 2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm], без зоны — UTC; «+» зоны в query — %2B; раньше 2286-11-20T17:46:40Z"
                }
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Свечей на страницу, 1..10000, по умолчанию 1000.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "fill",
            "in": "query",
            "description": "Заполнять ли пустые интервалы плоскими свечами (по умолчанию да, как в источнике).",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Курсор из `next_cursor` предыдущей страницы.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Свечи колонками: ts, open, high, low, close, volume, quote_volume, buy_volume, buy_quote_volume, trades, buy_trades. `deep_until` — шов глубокого яруса (свечи бирж с листинга): приходит у любого символа со свечами склада, и в живом окне; null — только у строк левее него: volume, buy_volume, buy_quote_volume, buy_trades — null, trades — null, если биржа не даёт число сделок; quote_volume и OHLC — числа",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SeriesResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры; неизвестный инструмент (unsupported_instrument)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области market:read, история глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или ответил ошибкой",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/delta": {
      "get": {
        "tags": [
          "market"
        ],
        "summary": "Дельта агрессора по окнам. Источник — clusters `/v1/delta/range` (delta_history.rs:258;\nформат проверен по коду и живому ответу, tests/fixtures/real/clusters_delta.json):\nколонки целыми — объёмы в `qty_scale`, цена в `price_scale`, деньги в `quote_scale`\n(фиксированная 1e-4 $, не шкала цены). Окна без сделок не приходят.",
        "operationId": "delta",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/order-flow",
          "description": "Поток ордеров"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "tf",
            "in": "query",
            "description": "Окно: 1s, 30s, 1m, 5m, 15m, 30m, 1h, 4h, 1d. По умолчанию 1m.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1m"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс; выравнивается вниз по окну. По умолчанию — `limit` окон назад от `to`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс, не включительно.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Окон на страницу, 1..10000, по умолчанию 1000.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Окна колонками: t (начало окна), buy, sell, delta, delta_min, delta_max (монеты; min/max — экстремумы бегущей дельты внутри окна), trades, buy_quote, sell_quote, delta_quote, delta_quote_min, delta_quote_max ($), close (цена), closed",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeltaResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области, группа не в тарифе, глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/densities": {
      "get": {
        "tags": [
          "market"
        ],
        "summary": "Плотности стакана (крупные лимитные стены), текущий снимок. Источник — densities\n`/v1/densities` (один инструмент) или `/v1/densities/top` (сводка); формат стены —\ndens-domain/src/density.rs:135-205, проверен по коду.",
        "operationId": "densities",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/densities",
          "description": "Плотности"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Один инструмент. Без него — сводка по рынку с фильтрами ниже.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "venue",
            "in": "query",
            "description": "Биржи через запятую.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance,bybit"
          },
          {
            "name": "market",
            "in": "query",
            "description": "Рынки через запятую: spot, perp.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "coins",
            "in": "query",
            "description": "Монеты через запятую (`BTC,ETH`), не символы.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "side",
            "in": "query",
            "description": "`bid` или `ask`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_usd",
            "in": "query",
            "description": "Минимальный размер стены, USD.",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "max_dist_bp",
            "in": "query",
            "description": "Максимальное расстояние до середины стакана, б.п. (200 = ±2%).",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Сколько стен, по умолчанию 200.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Сортировка: `usd` (по умолчанию), `age`, `dist`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Стены колонками: instrument, side, price, qty, usd, dist_bp, first_ts, age_ms, peak_usd, state, touched, size, score, agg, wall_id (строкой: 64-битное целое)",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SnapshotResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/densities/history": {
      "get": {
        "tags": [
          "market"
        ],
        "summary": "История закрытых стен плотностей. Источник — densities `/v1/densities/history`\n(dens-api/src/rest.rs:410; формат проверен по коду и живому ответу,\ntests/fixtures/real/dens_history.json): `{\"d\":[...]}` от свежих к старым по `first_ms`,\nцены, количества и $ — дробью. Хранение — 90 суток (TTL `keep_hours` = 2160 у\ndensity_events).",
        "description": "Курсора у источника нет: он отдаёт `limit` свежих. Шлюз просит на одну больше, а\nпродолжение — конец окна у первой не вошедшей стены; стены той же миллисекунды уходят на\nследующую страницу целиком, без потерь и повторов.",
        "operationId": "densities_history",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/densities",
          "description": "Плотности"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс, по моменту появления стены. По умолчанию — сутки назад от `to`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс, не включительно.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "description": "Как закрылась стена: `pulled` (снята), `eaten` (съедена сделками), через запятую.\nПо умолчанию — обе.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "eaten"
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Стен на страницу, 1..10000, по умолчанию 1000.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Курсор из `next_cursor`: страницы идут от свежих к старым.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Закрытые стены колонками от свежих к старым: t (появление, мс), side, kind (pulled/eaten), price, qty_open, qty_close (монеты), usd_open, usd_peak ($), end_ts, duration_ms, dist_bp_open, mid_at_close, touched, size. Глубина — 90 суток",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventsResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области, группа не в тарифе, глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/footprint": {
      "get": {
        "tags": [
          "market"
        ],
        "summary": "Футпринт. Источник — clusters `/v1/clusters/range` (cluster_history.rs:94-166; формат\nпроверен по коду): колонки целыми со шкалами `price_scale`/`qty_scale`, время в мс,\nпродолжение — `truncated` + `next_from_ms`; стороны сделок `trades_buy`/`trades_sell` —\nс миграции 018 (API.md, «Кластера и дельта»), правило «неизвестно» — [`trade_sides`]. Сумма\nплощадок — один вызов `/v1/clusters/range/sum` (те же колонки на общей сетке плюс\nприсутствие и курс по окнам).",
        "operationId": "footprint",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/order-flow",
          "description": "Поток ордеров"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Инструмент `venue:market:SYMBOL`. Обязателен, если нет `instruments`.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "instruments",
            "in": "query",
            "description": "Сумма площадок одной монеты по цене вместо `instrument`: 2..8 инструментов через запятую,\nperp и spot вместе, пары к USDT, USDC и USD. Уровни слагаемых — на общей сетке цены в USDT\n(USD и USDC — по курсу окна), объёмы и сделки — суммой (стороны сделок тоже: слагаемое без\nразбивки делает уровень `null`); OHLC — первого в списке (`price_anchor`). В окнах —\n`complete`, `venues_present`, `venues_mask` и курс по окну. Вес запроса — N.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT,coinbase:spot:BTC-USD"
          },
          {
            "name": "tf",
            "in": "query",
            "description": "Окно кластера: 30s, 1m, 5m, 15m, 30m, 1h, 4h, 1d. По умолчанию 1m.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1m"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс. По умолчанию — 60 окон назад от `to`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс, не включительно.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "price_step",
            "in": "query",
            "description": "Только у суммы площадок: шаг общей сетки в единицах цены (`0.5`). По умолчанию — единица\nсамой грубой шкалы цены слагаемых; явный — не мельче её и кратен ей, иначе 400.",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Кластеры: уровни (ts, price, bid_qty, ask_qty, trades, trades_buy, trades_sell; стороны null — разбивки нет, а не ноль) и окна; у суммы площадок (instruments=) — общая сетка в USDT, присутствие и курс по окнам",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FootprintResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры; набор не одной монеты, больше 8, дубль, инверсный перп; price_step у одного инструмента",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области или глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "413": {
            "description": "Сумма: окно больше потолка строк источника — сузьте окно или возьмите tf крупнее",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/funding": {
      "get": {
        "tags": [
          "derivatives"
        ],
        "summary": "Фандинг, минутные снимки. Источник — oi-funding `/v1/funding/range/:exchange/:symbol`\nс `fmt=col` (проверено по коду): `ts` мс, `r` — ставка строкой, `nft` — следующее\nначисление мс, `ih` — период в часах.",
        "operationId": "funding",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/oi-funding",
          "description": "Открытый интерес и фандинг"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "from",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Ставка фандинга: ts, rate, next_funding_ts, interval_hours",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SeriesResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры; не перп",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области или глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/funding/events": {
      "get": {
        "tags": [
          "derivatives"
        ],
        "summary": "Начисления фандинга (моменты расчёта). Источник — oi-funding\n`/v1/funding/events/range/:exchange/:symbol` (oi-api/src/rest.rs:581; формат проверен по\nкоду и живому ответу, tests/fixtures/real/funding_events.json): массив\n`{settlement_ts: RFC3339, rate: строка, mark_price: строка|null}`; `fmt=col` этот путь не\nпонимает.",
        "operationId": "funding_events",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/oi-funding",
          "description": "Открытый интерес и фандинг"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Только перпы. Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс. По умолчанию — 30 суток назад от `to`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс, не включительно.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Начисления колонками: t (момент расчёта, мс), rate (ставка долей за период: 0.0001 = 0.01 %), mark_price",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventsResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры; не перп",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области, группа не в тарифе, глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/heatmap": {
      "get": {
        "tags": [
          "market"
        ],
        "summary": "Тепловая карта стакана.",
        "description": "Таблица — только ненулевые ячейки `t, side, price, qty` (объём в монетах). Бинарь\n`format=hmp1|hmp2` — тело источника потоком, с `ETag`/`Cache-Control`; разбор —\n[формат HMP](https://docs.lootx.trade/ru/market-api/heatmap-binary). Сумма площадок\n(`instruments=`) — ячейки на общей сетке в USDT, `presence` — маска и курс по кадрам.",
        "operationId": "heatmap",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/heatmap",
          "description": "Тепловая карта"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Инструмент `venue:market:SYMBOL`. Обязателен, если нет `instruments`.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "instruments",
            "in": "query",
            "description": "Сумма площадок одной монеты по цене вместо `instrument`: 2..8 инструментов через запятую,\nperp и spot вместе, пары к USDT, USDC и USD (USD и USDC — в USDT по курсу минуты\nколонки). Ячейки — сумма на общей сетке цены, `presence` — какие площадки есть в кадре\n(нет снимка — бит 0, а не ноль). `layout=1` у суммы нет. Вес запроса — N.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT,coinbase:spot:BTC-USD"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс. По умолчанию — час назад от `to`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс, не включительно. По умолчанию — сейчас.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "tf",
            "in": "query",
            "description": "Шаг колонки времени: `1s`, `5s`, `1m`, ... (кратно секунде). По умолчанию — самый\nмелкий, при котором окно влезает в 4096 колонок. Старше суток хранится только\nминутная свёртка — шаг округлится вверх до минуты.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1s"
          },
          {
            "name": "price_step",
            "in": "query",
            "description": "Высота ячейки цены в единицах цены (`10` — ячейки по $10 у BTCUSDT). Округляется\nвверх до сетки хранения; итоговый шаг — `price_step` ответа. По умолчанию — шаг\nхранения. Шкалу книги шлюз берёт из минуты перед `to`: нет там кадров и шкала ещё не\nизвестна — `400 bad_request`, запрашивайте без `price_step`. У суммы площадок — шаг общей\nсетки: не мельче самой крупной ячейки слагаемых, вверх до кратного; без пробы шкалы.",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "agg",
            "in": "query",
            "description": "`avg` (по умолчанию) — средний объём за колонку, `max` — максимум.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "price_from",
            "in": "query",
            "description": "Нижняя граница цены (только парой с `price_to`). Без окна — ±20 % от середины книги.",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "price_to",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "qbits",
            "in": "query",
            "description": "Только `format=hmp2`: бит мантиссы кода объёма, 6..9 (по умолчанию 6).",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "layout",
            "in": "query",
            "description": "Только `format=hmp2`: `0` — кадры (как HMP1), `1` — ряды цены сериями.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Курсор из `next_cursor` (если источник обрезал ответ по объёму).",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf`, `csv` — разрежённая таблица;                  `hmp1` (точные целые объёмы) или `hmp2` (объём 6–9-битным кодом, в 3–4 раза                  меньше) — бинарь источника потоком, разбор — https://docs.lootx.trade/ru/market-api/heatmap-binary. Ошибки —                  всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv",
                "hmp1",
                "hmp2"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Таблица ненулевых ячеек (t, side, price, qty) или бинарь HMP1/HMP2 (format=hmp1|hmp2, потоком; разбор — https://docs.lootx.trade/ru/market-api/heatmap-binary). Сумма площадок (instruments=) — ячейки на общей сетке в USDT, presence — маска и курс по кадрам; бинарь суммы — с FLAG_SUM и заголовком x-fx-source",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HeatmapResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              },
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "HMP1 (format=hmp1) — тело источника как есть; формат — https://docs.lootx.trade/ru/market-api/heatmap-binary"
                }
              },
              "application/x-hmp2": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "HMP2 (format=hmp2) — тело источника как есть; формат — https://docs.lootx.trade/ru/market-api/heatmap-binary"
                }
              }
            }
          },
          "304": {
            "description": "Бинарь: не изменился с If-None-Match",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "description": "Неверные параметры; набор не одной монеты, больше 8, дубль, инверсный перп, layout=1 у суммы",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области, группа не в тарифе, глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "413": {
            "description": "Больше 4096 колонок или 500 000 ячеек: сузьте окно, укрупните tf/price_step или возьмите format=hmp1|hmp2",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/hyperliquid/coverage": {
      "get": {
        "tags": [
          "liquidations"
        ],
        "summary": "Покрытие книги позиций Hyperliquid по монете: какая доля открытого интереса известна, у\nскольких позиций есть цена ликвидации, свежесть снимка узла.",
        "operationId": "hl_coverage",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/conventions",
          "description": "Соглашения: имена, время, страницы"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Перп Hyperliquid: `hyperliquid:perp:BTC` или рынок HIP-3 `hyperliquid:perp:AAPLUSDC.XYZ`\n(деки xyz, io, para, mkts). Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "hyperliquid:perp:BTC"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "coverage — доли (ratio, long_ratio, short_ratio, mapped_ratio, oi_check), суммы *_usd_e8 и прежние *_e8 (строкой, USD × 10⁸ — одно число) и *_usd (числом из него же), счётчики позиций, свежесть снимка (fresh, base_age_ms, fills_lag_ms). fresh наверху — как у liquidation-map. Таблицы нет: CSV — 400",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HlCoverageResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры; не перп Hyperliquid (unsupported_instrument)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа liquidations не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или ответил не по договору (в том числе без точных сумм *_usd_e8)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/hyperliquid/footprint": {
      "get": {
        "tags": [
          "market"
        ],
        "summary": "HL-футпринт NL/NS.",
        "description": "Изменение лонгов и шортов тейкера и мейкера по уровням цены. NL/NS по всем — `dl_taker +\ndl_maker` (= ΔOI), тейкер — `dl_taker`/`ds_taker`, мейкер — `dl_maker`/`ds_maker`.",
        "operationId": "hl_footprint",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/order-flow",
          "description": "Поток ордеров"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Перп Hyperliquid: `hyperliquid:perp:BTC`, рынок HIP-3 — `hyperliquid:perp:AAPLUSDC.XYZ`.\nОбязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "hyperliquid:perp:BTC"
          },
          {
            "name": "tf",
            "in": "query",
            "description": "Окно: 1m, 5m, 15m, 30m, 1h, 4h, 1d (минута — шаг источника, секунд нет). По умолчанию 1m.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1m"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс. По умолчанию — 60 окон назад от `to`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс, не включительно.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Уровни (levels): ts, price, dl_taker, ds_taker, dl_maker, ds_maker (монеты: + открыли, − закрыли), n_fills; окна (windows): ts, closed. Три вида NL/NS: по всем dl_taker + dl_maker = ds_taker + ds_maker = ΔOI; тейкер dl_taker/ds_taker; мейкер dl_maker/ds_maker",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HlFootprintResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры; tf не из 1m…1d (секунд нет); не перп Hyperliquid или монета, которой у источника нет (unsupported_instrument); instruments= с двумя и больше инструментами",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области clusters, группа footprint не в тарифе или история глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "413": {
            "description": "Одно окно длиннее потолка строк источника — возьмите tf меньше",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или ответил ошибкой; у узла нет маршрута HL-футпринта",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/hyperliquid/liquidation-map": {
      "get": {
        "tags": [
          "liquidations"
        ],
        "summary": "Карта ликвидаций Hyperliquid по цене: сколько позиций (USD) ликвидируется на каждом уровне\nцены, лонги и шорты, кросс и изолированная маржа. Последняя минута книги позиций liq-server\n(снимок узла + сделки после него), мимо кэша шлюза.",
        "operationId": "hl_liquidation_map",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/conventions",
          "description": "Соглашения: имена, время, страницы"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Перп Hyperliquid: `hyperliquid:perp:BTC` или `hyperliquid:perp:AAPLUSDC.XYZ`. Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "hyperliquid:perp:BTC"
          },
          {
            "name": "price_step",
            "in": "query",
            "description": "Высота уровня цены в единицах цены; не мельче сетки источника (у BTC — 100, иначе `400\nupstream_rejected` с текстом источника). По умолчанию — сетка источника.",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            },
            "example": 100.0
          },
          {
            "name": "range_pct",
            "in": "query",
            "description": "Окно цены от mark, % (0, 1000]. По умолчанию — окно источника.",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            },
            "example": 10.0
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Колонки price (нижняя граница уровня), long_usd, short_usd (USD позиций с ликвидацией на уровне), long_count, short_count, long_isolated_usd, short_isolated_usd, затем те же суммы точно — long_usd_e8, short_usd_e8, long_isolated_usd_e8, short_isolated_usd_e8 (строкой, USD × 10⁸; *_usd — число из них). fresh — false, если минута несвежая (coverage.fresh источника) или старше 3 минут. coverage — покрытие книги: суммы *_usd_e8 и прежние *_e8 строкой (USD × 10⁸), *_usd числом",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HlMapResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры; не перп Hyperliquid или имя, которого источник не примет (unsupported_instrument); price_step мельче сетки источника (upstream_rejected)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа liquidations не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или ответил не по договору (в том числе без точных сумм *_usd_e8)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/hyperliquid/liquidation-map/heatmap": {
      "get": {
        "tags": [
          "liquidations"
        ],
        "summary": "Карта ликвидаций Hyperliquid по минутам — бинарь HMP источника как есть, потоком.",
        "description": "Кадр — минута (или шаг `tf`), уровни цены — ряды; сторона `bid` — лонги (ликвидируются ниже\nцены), `ask` — шорты. Объём — USD позиций с ликвидацией на уровне, `price_scale` 8. Таблицы\nнет: `format=hmp2` или `format=hmp1` обязателен. Свежести в бинаре нет — `/coverage`.\nРазбор — [формат HMP](https://docs.lootx.trade/ru/market-api/heatmap-binary).",
        "operationId": "hl_liquidation_heatmap",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/conventions",
          "description": "Соглашения: имена, время, страницы"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Перп Hyperliquid: `hyperliquid:perp:BTC` или `hyperliquid:perp:AAPLUSDC.XYZ`. Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "hyperliquid:perp:BTC"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс (`0 < from < to`). По умолчанию — сутки назад от `to`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс. По умолчанию — сейчас.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "tf",
            "in": "query",
            "description": "Шаг кадра: `1m`, `5m` (по умолчанию), `15m`, `1h`, `4h`, `1d`. Кадров — не больше 2000.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "5m"
          },
          {
            "name": "qbits",
            "in": "query",
            "description": "Только `format=hmp2`: бит мантиссы кода объёма, 6..9.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "layout",
            "in": "query",
            "description": "Только `format=hmp2`: `0` — кадры, `1` — ряды цены сериями.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа — только бинарь: `hmp2` (объём 6–9-битным кодом, `qbits`, `layout`) или `hmp1` (точные целые). Таблицы у карты по минутам нет — `json`, `protobuf`, `csv` и без `format` — `400 bad_format`. Ошибки — всегда JSON.",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "hmp1",
                "hmp2"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Бинарь HMP2 (format=hmp2, application/x-hmp2) или HMP1 (format=hmp1, application/octet-stream) — тело источника как есть, Cache-Control источника (no-store)",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "HMP1 (format=hmp1) — тело источника как есть; формат — https://docs.lootx.trade/ru/market-api/heatmap-binary"
                }
              },
              "application/x-hmp2": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "HMP2 (format=hmp2) — тело источника как есть; формат — https://docs.lootx.trade/ru/market-api/heatmap-binary"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры; format не hmp1|hmp2 (bad_format); tf не из 1m,5m,15m,1h,4h,1d; больше 2000 кадров; qbits/layout без format=hmp2",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа liquidations не в тарифе, from глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или ответил не тем форматом",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/hyperliquid/long-short": {
      "get": {
        "tags": [
          "liquidations"
        ],
        "summary": "Long/short Hyperliquid по монетам: счета и суммы позиций в залоге дека за последнюю минуту.",
        "operationId": "hl_long_short",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/conventions",
          "description": "Соглашения: имена, время, страницы"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Перп Hyperliquid. Нет — все монеты с позициями.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "hyperliquid:perp:BTC"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Колонки instrument, long_accounts, short_accounts, long_e8, short_e8 (строкой, × 10⁸ в залоге дека), collateral, long_usd_e8, short_usd_e8 (то же число под каноническим именем источника). Без instrument — все монеты с позициями. fresh — по покрытию монеты запроса (всего рынка — BTC)",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HlLongShortResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры; не перп Hyperliquid (unsupported_instrument)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа liquidations не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или ответил не по договору (в том числе без точных сумм *_usd_e8)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/hyperliquid/positions/top": {
      "get": {
        "tags": [
          "liquidations"
        ],
        "summary": "Крупнейшие позиции монеты Hyperliquid: кто, сторона, размер, вход, цена ликвидации, плечо.",
        "operationId": "hl_positions_top",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/conventions",
          "description": "Соглашения: имена, время, страницы"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Перп Hyperliquid: `hyperliquid:perp:BTC` или `hyperliquid:perp:AAPLUSDC.XYZ`. Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "hyperliquid:perp:BTC"
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Позиций, 1..500 (по умолчанию 50), крупнейшие по `notional_usd`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            },
            "example": 50
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Колонки user (адрес), side (long/short), size (монеты, у шорта со знаком минус), notional_usd, entry_px, liquidation_px (null — без ликвидации в окне книги), distance_pct (от mark до ликвидации, %), leverage (null — неизвестно), margin (cross/isolated), polled_ms. fresh и coverage — как у liquidation-map",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HlTopResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры, limit вне 1..500; не перп Hyperliquid (unsupported_instrument)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа liquidations не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или ответил не по договору (в том числе без точных сумм *_usd_e8)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/hyperliquid/triggers": {
      "get": {
        "tags": [
          "liquidations"
        ],
        "summary": "Книга TP/SL Hyperliquid: неисполненные тейк-профиты и стоп-лоссы всех счетов по уровням цены\n— сколько монет и долларов сработает на каждом уровне. Живая книга liq-server (снимок узла и\nстатусы ордеров после него), посчитанная на запрос, мимо кэша шлюза.",
        "operationId": "hl_triggers",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/conventions",
          "description": "Соглашения: имена, время, страницы"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Перп Hyperliquid: `hyperliquid:perp:BTC` или рынок HIP-3 `hyperliquid:perp:AAPLUSDC.XYZ`\n(деки xyz, io, para, mkts). Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "hyperliquid:perp:BTC"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Колонки price (нижняя граница ячейки), tp_long_size, tp_short_size, sl_long_size, sl_short_size (монеты), tp_long_usd, tp_short_usd, sl_long_usd, sl_short_usd (USD по цене срабатывания, числом из *_usd_e8), tp_long_count, tp_short_count, sl_long_count, sl_short_count, tp_long_usd_e8, tp_short_usd_e8, sl_long_usd_e8, sl_short_usd_e8 (строкой, USD × 10⁸). tp_long — тейк лонга (выше mark), tp_short — тейк шорта (ниже), sl_long — стоп лонга (ниже), sl_short — стоп шорта (выше). fresh — false, если книга несвежая у источника (тогда rows пусты — неизвестно, а не «ордеров нет») или ответу больше 3 минут (тогда шлюз ставит fresh: false, а строки отдаёт как есть). Свежая книга без строк — TP/SL у монеты нет. coverage — покрытие: notional_usd_e8 и прежнее notional_e8 по видам строкой (USD × 10⁸), notional_usd (из того же целого) и count по видам числом",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HlTriggersResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры, чужой параметр (bad_request с param); не перп Hyperliquid или имя, которого источник не примет (unsupported_instrument)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа liquidations не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или ответил не по договору (в том числе без точных сумм *_usd_e8; 404 без кода — нет маршрута у старого источника)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/hyperliquid/triggers/heatmap": {
      "get": {
        "tags": [
          "liquidations"
        ],
        "summary": "Книга TP/SL Hyperliquid по минутам — бинарь HMP источника как есть, потоком.",
        "description": "Кадр — минута (или шаг `tf`), уровни цены — ряды; ряд — на той стороне mark, откуда ордер\nсрабатывает: `kind=tp` — bid `tp_short` (ниже mark), ask `tp_long` (выше); `kind=sl` — bid\n`sl_long`, ask `sl_short`. Объём — монеты (`10^-qty_scale`). Несвежая минута кадра не даёт:\nпропуск — «неизвестно». Не больше 200 000 ячеек: дальше ответ обрезан по времени и помечен\n`FLAG_TRUNCATED` (бит 1 `flags`). Таблицы нет: `format=hmp2` или `format=hmp1` обязателен.\nРазбор — [формат HMP](https://docs.lootx.trade/ru/market-api/heatmap-binary).",
        "operationId": "hl_triggers_heatmap",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/conventions",
          "description": "Соглашения: имена, время, страницы"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Перп Hyperliquid: `hyperliquid:perp:BTC` или `hyperliquid:perp:AAPLUSDC.XYZ`. Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "hyperliquid:perp:BTC"
          },
          {
            "name": "kind",
            "in": "query",
            "description": "Вид ордеров: `tp` — тейк-профиты (bid — `tp_short`, ask — `tp_long`), `sl` — стоп-лоссы\n(bid — `sl_long`, ask — `sl_short`). Обязателен; иное (`TP`, пусто, два раза) — `400`\n(нет или не тот — после проверки ключа: без области derivatives — `403`).",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Вид ордеров карты по минутам: `tp` или `sl`.",
              "enum": [
                "tp",
                "sl"
              ]
            },
            "example": "sl"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс (`0 < from < to`). По умолчанию — сутки назад от `to`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс. По умолчанию — сейчас.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "tf",
            "in": "query",
            "description": "Шаг кадра: `1m`, `5m` (по умолчанию), `15m`, `1h`, `4h`, `1d`. Кадров — не больше 2000.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "5m"
          },
          {
            "name": "qbits",
            "in": "query",
            "description": "Только `format=hmp2`: бит мантиссы кода объёма, 6..9.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "layout",
            "in": "query",
            "description": "Только `format=hmp2`: `0` — кадры, `1` — ряды цены сериями.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа — только бинарь: `hmp2` (объём 6–9-битным кодом, `qbits`, `layout`) или `hmp1` (точные целые). Таблицы у карты по минутам нет — `json`, `protobuf`, `csv` и без `format` — `400 bad_format`. Ошибки — всегда JSON.",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "hmp1",
                "hmp2"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Бинарь HMP2 (format=hmp2, application/x-hmp2) или HMP1 (format=hmp1, application/octet-stream) — тело источника как есть, Cache-Control источника (no-store). Объём — монеты; kind=tp: bid tp_short, ask tp_long; kind=sl: bid sl_long, ask sl_short; FLAG_TRUNCATED — обрезан по времени на 200 000 ячеек",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "HMP1 (format=hmp1) — тело источника как есть; формат — https://docs.lootx.trade/ru/market-api/heatmap-binary"
                }
              },
              "application/x-hmp2": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "HMP2 (format=hmp2) — тело источника как есть; формат — https://docs.lootx.trade/ru/market-api/heatmap-binary"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры, чужой параметр (bad_request с param); kind не tp|sl или нет kind (после проверки ключа); format не hmp1|hmp2 (bad_format); tf не из 1m,5m,15m,1h,4h,1d; больше 2000 кадров; qbits/layout без format=hmp2",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа liquidations не в тарифе, from глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или ответил не тем форматом",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/hyperliquid/whales": {
      "get": {
        "tags": [
          "liquidations"
        ],
        "summary": "Киты монеты Hyperliquid: все позиции от порога `threshold_usd`.",
        "operationId": "hl_whales",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/conventions",
          "description": "Соглашения: имена, время, страницы"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Перп Hyperliquid: `hyperliquid:perp:BTC` или рынок HIP-3 `hyperliquid:perp:AAPLUSDC.XYZ`\n(деки xyz, io, para, mkts). Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "hyperliquid:perp:BTC"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Колонки как у positions/top. threshold_usd_e8 — порог строкой (USD × 10⁸), threshold_usd — число из него. fresh — по покрытию той же монеты (свидетель, второй вызов источника)",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HlWhalesResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры; не перп Hyperliquid (unsupported_instrument)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа liquidations не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или ответил не по договору (в том числе без точных сумм *_usd_e8)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/hyperliquid/whales/journal": {
      "get": {
        "tags": [
          "liquidations"
        ],
        "summary": "Журнал китов Hyperliquid: открытия, наращивания, сокращения, закрытия и ликвидации крупных\nпозиций по сделкам узла, новые первыми.",
        "operationId": "hl_whales_journal",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/conventions",
          "description": "Соглашения: имена, время, страницы"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Перп Hyperliquid. Нет — журнал всего рынка.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "hyperliquid:perp:BTC"
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Событий, 1..5000 (по умолчанию 200), новые первыми.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            },
            "example": 200
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Колонки ts (сделка, мс), instrument, user, action, size_before, size_after, px, notional_e8 (строкой, × 10⁸ в залоге дека), fee_e8 (строкой; токен — fee_token, пусто — залог дека), fee_token, closed_pnl_e8 (строкой), tid (строкой), block. threshold_usd_e8 и min_fill_usd_e8 — пороги строкой (USD × 10⁸), *_usd — числа из них. Журнал живой: fresh нет, ts — время ответа",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HlJournalResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры, limit вне 1..5000; не перп Hyperliquid (unsupported_instrument)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа liquidations не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или ответил не по договору (в том числе без точных сумм *_usd_e8)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/icebergs": {
      "get": {
        "tags": [
          "market"
        ],
        "summary": "Айсберги и поглощения. Источник — densities `/v1/icebergs` (dens-api/src/rest.rs:346;\nформат проверен по коду и живому ответу, tests/fixtures/real/dens_icebergs.json):\n`{\"items\":[...],\"ts\"}` из памяти узла — идущие и кольцо последних 2000 закончившихся,\nглубже истории нет.",
        "operationId": "icebergs",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/densities",
          "description": "Плотности"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Один инструмент. Без него — по рынку с фильтрами ниже.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "venue",
            "in": "query",
            "description": "Биржи через запятую.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "market",
            "in": "query",
            "description": "Рынки через запятую: spot, perp.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "coins",
            "in": "query",
            "description": "Монеты через запятую (`BTC,ETH`), до 100.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "side",
            "in": "query",
            "description": "`bid` или `ask`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "description": "`iceberg` (скрытый объём, добиваемый по кусочку), `absorption` (поглощение рыночного\nпотока на уровне) или `all` (по умолчанию).",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_usd",
            "in": "query",
            "description": "Минимальный скрытый исполненный объём, $.",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "state",
            "in": "query",
            "description": "`active` (по умолчанию — идущие), `ended` (закончившиеся, последние 2000) или `all`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Сколько, 1..5000, по умолчанию 200.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Айсберги колонками: instrument, id (строкой: 64-битное целое), side, kind, price, first_ts, last_ts, trades, executed_qty, hidden_qty, visible_max, clip_qty (монеты), executed_usd, hidden_usd ($; hidden — нижняя оценка), refills, end (null — идёт; idle/broken/reset)",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SnapshotResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области, группа не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/instruments": {
      "get": {
        "tags": [
          "reference"
        ],
        "operationId": "instruments",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/instruments",
          "description": "Инструменты"
        },
        "parameters": [
          {
            "name": "venue",
            "in": "query",
            "description": "Биржа.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance"
          },
          {
            "name": "market",
            "in": "query",
            "description": "spot, perp, future, option.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "source",
            "in": "query",
            "description": "Где инструмент есть: candles, footprint, densities, screener.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "description": "Подстрока символа, без учёта регистра.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "BTC"
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Строк на страницу, 1..10000, по умолчанию 1000.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Инструменты колонками: instrument, venue, market, symbol, sources",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstrumentsResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/liquidations/bars": {
      "get": {
        "tags": [
          "liquidations"
        ],
        "summary": "Ликвидации по барам. Источник — data `/v1/liquidations/agg` (свёртка событий на чтении,\nбар — `intDiv(ts, step) × step`). Страница — не больше `limit` баров по сетке шага: data\nотвергает окно шире 50 000 баров, шлюз до этого не доводит и листает курсором.",
        "operationId": "liquidation_bars",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/conventions",
          "description": "Соглашения: имена, время, страницы"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Перп. Обязателен, если нет `instruments`.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "instruments",
            "in": "query",
            "description": "Сумма площадок одной монеты вместо `instrument` (2..12 перпов через запятую): notional и\nqty по сторонам — суммой, в конце строки — `venues_present` и `venues_mask`, дыры всех\nплощадок — в `gaps` с полем `instrument`. Вес запроса — N.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT,bybit:perp:BTCUSDT"
          },
          {
            "name": "tf",
            "in": "query",
            "description": "Бар: 1m, 5m, 15m, 1h, 4h, 1d. По умолчанию 1m.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "5m"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс; выравнивается вниз по бару. По умолчанию — `limit` баров назад от `to`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс, не включительно. По умолчанию — сейчас.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Баров на страницу (по сетке шага, включая бары без событий), 1..10000, по умолчанию 1000.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Бары колонками: t, long_qty, short_qty, long_notional_e8, short_notional_e8 (строкой), count_long, count_short, unknown_count, unknown_notional_e8 (строкой), completeness_min; дыры ленты — в gaps",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LiqBarsResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры; tf не из списка; не перп (unsupported_instrument)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области, группа не в тарифе, история глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или у него не включены ликвидации",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/liquidations/coverage": {
      "get": {
        "tags": [
          "liquidations"
        ],
        "summary": "Что собирается: строка на каждую площадку data, и без ленты (`supported: false`) — у них\nпустой ответ значит «не собираем», а не «ноль». Источник — data `/v1/liquidations/coverage`;\nэто живое состояние, мимо кэша закрытых диапазонов.",
        "operationId": "liquidation_coverage",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/conventions",
          "description": "Соглашения: имена, время, страницы"
        },
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Ленты по площадкам: venue, market, supported, feed, connected, feed_seen_ms, completeness, last_event_ms, last_gap",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LiqCoverageResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области, группа не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или у него не включены ликвидации",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/liquidations/events": {
      "get": {
        "tags": [
          "liquidations"
        ],
        "summary": "События ликвидаций по возрастанию времени биржи. Источник — data\n`/v1/liquidations/range` (окно в мс, `[from, to)`, порядок `(ts_exchange_ms, source_id)`).",
        "description": "Страницы. data отвечает первыми `limit` событиями окна и флагом `truncated`; событий одной\nмиллисекунды бывает много (у Gate время до секунды), поэтому курсор несёт время, ключ\nпоследнего отданного события и сколько событий этой миллисекунды уже отдано: следующая\nстраница читает с той же миллисекунды и отбрасывает отданные ключи — без потерь и повторов.",
        "operationId": "liquidation_events",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/conventions",
          "description": "Соглашения: имена, время, страницы"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Перп `venue:perp:SYMBOL`. Ленты: binance, aster, okx, bitget, lighter (выборка биржи) и\nbybit, gate, hyperliquid (все; рынки HIP-3 — `hyperliquid:perp:AAPLUSDC.XYZ`); у остальных\n— пустой ответ с дырой `not_collected`.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс, включительно (по времени биржи). По умолчанию — час назад от `to`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс, не включительно. По умолчанию — сейчас.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Событий на страницу, 1..10000, по умолчанию 1000.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Курсор из `next_cursor`; остальные параметры — те же.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "События колонками: t, t_recv, side, price, price_kind, qty, qty_native, notional_e8 (строкой), completeness, flags, source, source_id (строкой); дыры ленты — в gaps",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LiqEventsResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры; не перп или биржа без такого рынка (unsupported_instrument); параметра нет у маршрута",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области, группа не в тарифе, история глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или у него не включены ликвидации",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/liquidations/stream": {
      "get": {
        "tags": [
          "liquidations"
        ],
        "summary": "WebSocket: живые ликвидации (data `/v1/liquidations/stream`, узел приёма).",
        "description": "Кадры — текст JSON: событие того же вида, что строка `range` у data, плюс `instrument`\nпервым полем: `{\"instrument\":\"bybit:perp:BTCUSDT\",\"venue\":\"bybit\",\"market\":\"perp\",\n\"symbol\":\"BTCUSDT\",\"ts_exchange_ms\":…,\"ts_recv_ms\":…,\"side\":\"long\",\"price\":\"…\",\n\"price_kind\":\"bankruptcy\",\"qty_native\":\"…\",\"qty\":…,\"notional_e8\":\"…\",\"completeness\":\"full\",\n\"flags\":0,\"source\":\"live\",\"source_id\":\"…\"}`. Деньги и `source_id` — строкой. Только свежие\nсобытия, без повторов. Отставший клиент закрывается кодом 1008 с причиной\n(`lagged: N events missed; …`, `send timeout: …`), остановка источника — 1001: переподключитесь\nи доберите пропуск через `/v1/liquidations/events` с последнего виденного времени (ключ —\n`source_id`). Кадры клиента не нужны.",
        "operationId": "liquidation_stream",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/websocket",
          "description": "Потоки WebSocket"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Один перп `venue:perp:SYMBOL`.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "bybit:perp:BTCUSDT"
          },
          {
            "name": "venue",
            "in": "query",
            "description": "Или вся площадка (`bybit`). Без обоих — все площадки.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "101": {
            "description": "Соединение установлено",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "description": "Неверный инструмент или площадка; не перп (unsupported_instrument)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Группа liquidations не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/ls-ratio": {
      "get": {
        "tags": [
          "derivatives"
        ],
        "summary": "Long/Short ratio, 5-минутные ряды. Источник — oi-funding `/v1/ls-ratio/range/:exchange/:symbol`\n(время RFC 3339, `from <= bucket_ts < to`, порядок `(bucket_ts, kind)`, `limit` — до 50 000).",
        "description": "Страницы. Длинное окно режет шлюз (как у `/v1/oi`, до `max_window_hours`). Источник отдаёт\nпервые 10 000 строк окна; на один `ts` приходится несколько строк (виды), и упор может\nразрезать их группу — тогда последний `ts` целиком уходит на следующую страницу: курсор\nначинает с него, без потерь и повторов.",
        "operationId": "ls_ratio",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/oi-funding",
          "description": "Открытый интерес и фандинг"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Перп `venue:perp:SYMBOL`. Ряды есть у binance (`global_account`, `top_account`,\n`top_position`, `taker_volume`), bybit (`global_account`) и okx (те же четыре и\n`global_account_ccy`); у остальных — пустой ответ. Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "kind",
            "in": "query",
            "description": "Вид ряда: `global_account`, `top_account`, `top_position`, `taker_volume`,\n`global_account_ccy`. По умолчанию — все.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "top_position"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс, по `ts` (= `bucket_ts`). По умолчанию — сутки назад от `to`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс, не включительно.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Курсор из `next_cursor`; остальные параметры — те же.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Ряды колонками, tf 5m: ts (bucket_ts биржи, мс), as_of (момент значения, мс: у долей Binance и Bybit — ts, у taker_volume Binance и всех видов OKX — ts + 5 мин, у иных пар — ts), kind, long_ratio, short_ratio, long_short_ratio (числа; чего биржа не публикует — null), buy_vol, sell_vol (объём тейкера строкой — точная десятичная запись, в unit), unit (`base` — монеты). Порядок — (ts, kind); идущий бакет может измениться — перечитывайте последние ~10 минут",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SeriesResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры, неизвестный kind; не перп или биржа без такого рынка (unsupported_instrument)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа не в тарифе, история глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или ответил ошибкой",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/ls-ratio/latest": {
      "get": {
        "tags": [
          "derivatives"
        ],
        "summary": "Новейшая строка каждого вида (или вида `kind`) за последние 35 суток, по порядку вида.\nИсточник — oi-funding `/v1/ls-ratio/latest/:exchange/:symbol`, мимо кэша шлюза. Строк нет —\n`404 not_found` («нет long/short данных»); ряд, замолчавший дольше, читайте `/v1/ls-ratio`.",
        "operationId": "ls_ratio_latest",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/oi-funding",
          "description": "Открытый интерес и фандинг"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Перп `venue:perp:SYMBOL`. Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "kind",
            "in": "query",
            "description": "Вид ряда (как у `/v1/ls-ratio`). По умолчанию — все.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "taker_volume"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "По строке на вид, колонки как у /v1/ls-ratio: ts, as_of, kind, long_ratio, short_ratio, long_short_ratio, buy_vol, sell_vol (строкой), unit; next_cursor — null. Строк нет — 404 not_found",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SeriesResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры, неизвестный kind; не перп или биржа без такого рынка (unsupported_instrument)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или ответил ошибкой",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/margin/assets": {
      "get": {
        "tags": [
          "margin"
        ],
        "summary": "Активы пула маржи Binance: займы, возвраты, чистые займы и их z за окно, запас, цена и ставки\nчетырёх площадок (базовый уровень, не старше 15 минут). Источник — oi-funding\n`/v1/margin/assets` из своего кэша (пересобирается раз в минуту), мимо кэша шлюза.",
        "operationId": "margin_assets",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/margin",
          "description": "Маржинальное кредитование"
        },
        "parameters": [
          {
            "name": "window",
            "in": "query",
            "description": "Окно сумм: `1d`, `7d` (по умолчанию), `30d`, `90d` — от начала часа, текущий час\nвключён. Глубина тарифа меряется окном.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "7d"
          },
          {
            "name": "change_period",
            "in": "query",
            "description": "Период изменений и z: `5m`, `15m`, `30m`, `1h` (по умолчанию), `4h`, `12h`, `1d`, `7d`,\n`30d` — целые периоды, текущий неполный не входит.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "z_window",
            "in": "query",
            "description": "Выборка z: `3d`, `7d` (по умолчанию), `14d`, `30d`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "units",
            "in": "query",
            "description": "`base` (по умолчанию) — в единицах актива, `usdt` — деньги `*_usd_e8`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "description": "Пул: `margin` (кросс, по умолчанию) или `isolated`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Строка на актив; as_of — минута кэша источника. Количества, цены и ставки — точной десятичной строкой, деньги *_usd_e8 — целым строкой (USDT × 10⁸), z и проценты — числом; нет данных (минута не собрана, нет цены, без ключа Binance — запас и суммы) — null, а не ноль",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MarginAssetsResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута; window не из 1d, 7d, 30d, 90d; источник отверг параметр (upstream_rejected, param — его имя)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа margin не в тарифе, окно глубже тарифа (param window)",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или маршрутов маржи на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/margin/compare": {
      "get": {
        "tags": [
          "margin"
        ],
        "summary": "Чистые займы нескольких активов в USDT по бакетам и цена BTC. Источник — oi-funding\n`/v1/margin/compare` из своего кэша, мимо кэша шлюза.",
        "operationId": "margin_compare",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/margin",
          "description": "Маржинальное кредитование"
        },
        "parameters": [
          {
            "name": "assets",
            "in": "query",
            "description": "Активы через запятую, до 8. По умолчанию — `BTC,ETH,USDT,USDC`.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "BTC,ETH"
          },
          {
            "name": "window",
            "in": "query",
            "description": "Окно: `1d`, `7d` (по умолчанию), `30d`, `90d`. Глубина тарифа меряется окном.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "step",
            "in": "query",
            "description": "Шаг: `5m` (окна до `1d`), `1h` (по умолчанию), `1d`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "description": "`margin` (по умолчанию) или `isolated`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "ts, btc_price_usdt (строкой), net_usd_e8:<АКТИВ> по активу (целым строкой, USDT × 10⁸; без запаса — null); as_of — минута кэша источника",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MarginCompareResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута; window не из 1d, 7d, 30d, 90d; источник отверг параметр (upstream_rejected, param — его имя)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа margin не в тарифе, окно глубже тарифа (param window)",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или маршрутов маржи на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/margin/coverage": {
      "get": {
        "tags": [
          "margin"
        ],
        "summary": "Покрытие источников маржи: запас пула (и по пулам), цены, ставки площадок — состояние,\nновейшая минута, дыры за сутки. Источник отвечает всегда (и до прогрева — `warming`).",
        "operationId": "margin_coverage",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/margin",
          "description": "Маржинальное кредитование"
        },
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "as_of и sources по порядку: inventory, inventory_margin, inventory_isolated, prices, rates_binance, rates_okx, rates_bybit, rates_gate. Без ключа Binance у запаса state no_key — остальное отвечает. Не таблица: CSV нет",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MarginCoverageResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута; format=csv (не таблица)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа margin не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или маршрутов маржи на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/margin/events": {
      "get": {
        "tags": [
          "margin"
        ],
        "summary": "Эпизоды «пул пуст», задевшие окно, новые сначала: займ за сутки до начала выше порога и рост\nзайма выше порога. Источник — oi-funding `/v1/margin/events` из своего кэша.",
        "operationId": "margin_events",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/margin",
          "description": "Маржинальное кредитование"
        },
        "parameters": [
          {
            "name": "window",
            "in": "query",
            "description": "Окно: `1d`, `7d` (по умолчанию), `30d`, `90d` — эпизоды, задевшие его. Глубина тарифа\nмеряется окном.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "borrow24h_min_usd",
            "in": "query",
            "description": "Порог займа за сутки до начала, USDT, десятичной записью ≥ 0; `0` — без порога. По\nумолчанию `10000`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "growth_period",
            "in": "query",
            "description": "Только `15m`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "growth_min_pct",
            "in": "query",
            "description": "Порог роста займа, %, десятичной записью; `0` — без порога. По умолчанию `100`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "description": "`margin` или `isolated`; без параметра — оба пула.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "asset, kind, start, end (null — ещё пуст), end_reason, borrow_24h (строкой), borrow24h_usd_e8 (целым строкой), growth_pct, empty_for_s; эпизодов нет (и без ключа Binance) — rows пустой",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MarginEventsResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута; window не из 1d, 7d, 30d, 90d; источник отверг параметр (upstream_rejected, param — его имя)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа margin не в тарифе, окно глубже тарифа (param window)",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или маршрутов маржи на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/margin/rates": {
      "get": {
        "tags": [
          "margin"
        ],
        "summary": "Ставки площадок по одному активу, старые сначала: Binance, OKX, Bybit — заёмщика (`borrow`),\nGate — кредитора (`lend`). Источник — oi-funding `/v1/margin/rates` со склада; закрытое окно\n— с `ETag` и `304`, как у series.",
        "operationId": "margin_rates",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/margin",
          "description": "Маржинальное кредитование"
        },
        "parameters": [
          {
            "name": "asset",
            "in": "query",
            "description": "Актив (как у series). Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "USDT"
          },
          {
            "name": "venues",
            "in": "query",
            "description": "Площадки через запятую: `binance`, `okx`, `bybit`, `gate`. По умолчанию — все четыре.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс UTC. По умолчанию — сутки до `to`. Глубина тарифа — по нему.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс UTC, не позже сейчас. Окно — до 31 суток.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "vip_level",
            "in": "query",
            "description": "Уровень VIP для каждой площадки запроса. По умолчанию — базовый у каждой.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "side",
            "in": "query",
            "description": "`borrow` (платит заёмщик: Binance, OKX, Bybit) или `lend` (получает кредитор: Gate); без\nпараметра — обе стороны. Ставка Gate — только кредитора: `side=borrow` строк Gate не даёт.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "ts, venue, side, vip_level, rate_apr (годовая доля десятичной строкой: дневная × 365, часовая × 8760, годовая как есть), src_unit, borrow_limit (строкой или null). У закрытого окна — ETag",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MarginRatesResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "304": {
            "description": "If-None-Match совпал с ETag закрытого окна: тело не изменилось",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута; нет asset; неверное окно; источник отверг параметр или окно длиннее 31 суток (upstream_rejected, param — его имя)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа margin не в тарифе, история глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или маршрутов маржи на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/margin/series": {
      "get": {
        "tags": [
          "margin"
        ],
        "summary": "Ряд одного актива по бакетам шага: цена, займы, возвраты, чистые и накопленные, z и\nизменения, запас, ставка Binance. Источник — oi-funding `/v1/margin/series` со склада.\nЗакрытое окно (кончилось не позже чем за 30 минут до начала текущего часа) источник метит\nслабым `ETag`: `If-None-Match` — `304`; такой ответ шлюз держит в кэше.",
        "operationId": "margin_series",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/margin",
          "description": "Маржинальное кредитование"
        },
        "parameters": [
          {
            "name": "asset",
            "in": "query",
            "description": "Актив как его называет площадка (любое письмо, без запятой, до 64 байт). Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "BTC"
          },
          {
            "name": "step",
            "in": "query",
            "description": "Шаг: `1m`, `5m` (по умолчанию), `1h`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс UTC (вниз к шагу). По умолчанию — 1, 7 или 30 суток до `to` по шагу.\nГлубина тарифа — по нему.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс UTC (вверх к шагу, не позже конца текущей минуты). По умолчанию — сейчас.\nСамое длинное окно — 1 сутки у `1m`, 8 у `5m`, 90 у `1h`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "metrics",
            "in": "query",
            "description": "Метрики через запятую: price, borrow, repay, net, net_cum, borrow_z, repay_z,\nborrow_chg_pct, repay_chg_pct, borrow_chg_z, repay_chg_z, inventory, rate_apr. По\nумолчанию — `price,borrow,repay`.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "price,borrow,repay"
          },
          {
            "name": "units",
            "in": "query",
            "description": "`base` (по умолчанию) или `usdt`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "description": "`margin` (по умолчанию) или `isolated`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "z_window",
            "in": "query",
            "description": "Выборка z: `3d`, `7d` (по умолчанию), `14d`, `30d`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "ts (начало бакета) и колонки метрик по порядку metrics; деньги *_usd_e8 — целым строкой, количества, цены и rate_apr — десятичной строкой, z и проценты — числом; бакет без минуты с данными — null. У закрытого окна — ETag",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MarginSeriesResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "304": {
            "description": "If-None-Match совпал с ETag закрытого окна: тело не изменилось",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута; нет asset; step не из 1m, 5m, 1h; неверное окно; источник отверг параметр или окно длиннее потолка шага (upstream_rejected, param — его имя)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа margin не в тарифе, история глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или маршрутов маржи на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/mark": {
      "get": {
        "tags": [
          "derivatives"
        ],
        "summary": "Mark и index перпа по секундам или минутам. Источник — oi-funding\n`/v1/mark/range/:exchange/:symbol` (время RFC 3339, `from <= ts < to`, от старых к новым,\n`limit` — до 50 000).",
        "description": "Страницы. Окно длиннее `max_window_hours` (у `1s` — часа) режет шлюз, продолжение —\nкурсором. Источник отдаёт первые 10 000 строк окна; упёрлось — курсор продолжает со\nследующего шага после последней строки. Живой край: `to` в будущем режется до сейчас, а край\nпозже `now − 2 мин` курсора не даёт — продолжайте новым запросом с последней строки.",
        "operationId": "mark",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/oi-funding",
          "description": "Открытый интерес и фандинг"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Перп `venue:perp:SYMBOL`. Mark есть у binance, bybit, okx, bitget, gate, hyperliquid,\nmexc, kraken, lighter, aster. Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "tf",
            "in": "query",
            "description": "Шаг: `1s` (секунды, 7 суток, группа тарифа `mark_1s`) или `1m` (минуты, бессрочно,\nгруппа `mark`). По умолчанию `1m`.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1m"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс, по `ts`. По умолчанию — сутки (у `1s` — час) назад от `to`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс, не включительно. По умолчанию — сейчас.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Курсор из `next_cursor`; остальные параметры — те же.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Ряды колонками. tf 1s: ts (начало секунды, мс), mark, index (строкой — десятичная запись биржи), premium (mark / index − 1, число; без index — null). Секунды без строки держат прошлое значение (биржа шлёт только изменения) — протягивайте последнее. tf 1m: ts (начало минуты), mark_open, mark_high, mark_low, mark_close, index_close (строкой), premium (mark_close / index_close − 1), secs (сколько секунд минуты имели значение, 1…60). Идущая минута не отдаётся — рисуйте её по секундам. У Hyperliquid index — оракульная цена (oraclePx)",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SeriesResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры, tf не 1s и не 1m; tf 1s с окном целиком старше 7 суток (param from; частично старше — from подтягивается к краю хранения); не перп или биржа без mark (unsupported_instrument)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа (mark или mark_1s) не в тарифе, история глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или ответил ошибкой",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/mark/latest": {
      "get": {
        "tags": [
          "derivatives"
        ],
        "summary": "Новейшая секунда mark/index за последние 7 суток. Источник — oi-funding\n`/v1/mark/latest/:exchange/:symbol`, мимо кэша шлюза. Строки нет — `404 not_found`. Последние\n~3 секунды источник ещё может не записать; чаще раза в секунду спрашивать незачем.",
        "operationId": "mark_latest",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/oi-funding",
          "description": "Открытый интерес и фандинг"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Перп `venue:perp:SYMBOL`. Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Одна строка, колонки как у /v1/mark?tf=1s: ts, mark, index (строкой), premium; tf 1s, next_cursor — null. Строки нет — 404 not_found",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SeriesResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры; не перп или биржа без mark (unsupported_instrument)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа mark не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или ответил ошибкой",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/oi": {
      "get": {
        "tags": [
          "derivatives"
        ],
        "summary": "Открытый интерес, минутные бары. Источник — oi-funding `/v1/oi/range/:exchange/:symbol`\nс `fmt=col` (oi-api/src/rest.rs:240-272; формат проверен по коду): `ts` в мс, значения\nдесятичными строками, колонки `u*` (USD), `c*` (монеты), `n*` (родная единица).",
        "operationId": "oi",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/oi-funding",
          "description": "Открытый интерес и фандинг"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Только перпы. Обязателен, если нет `instruments`.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "instruments",
            "in": "query",
            "description": "Сумма площадок одной монеты вместо `instrument` (2..12 перпов через запятую): OI на\nодном ts — сумма площадок, площадка без точки входит последним значением не дальше одной\nминуты; `unit=native` у суммы нет. Вес запроса — N.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT,bybit:perp:BTCUSDT"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс. По умолчанию — сутки назад от `to`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс, не включительно.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "description": "Единица: `usd` (по умолчанию), `coins`, `native` (как у биржи: монеты, контракты или USD).",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "usd"
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Минутные бары OI: ts, open, high, low, close",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SeriesResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры; не перп",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области или глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/options/bases": {
      "get": {
        "tags": [
          "options"
        ],
        "summary": "Базы площадок: какие базы есть у площадки и их цепочки с тем, что листингуется сейчас —\n`settle`, валюта цен, версия каталога, число инструментов и экспираций. Источник — oi-funding\n`/v1/options/bases` из каталога в памяти, мимо кэша шлюза.",
        "operationId": "options_bases",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/options",
          "description": "Опционы"
        },
        "parameters": [
          {
            "name": "venue",
            "in": "query",
            "description": "Площадка: `deribit`, `binance`, `bybit`, `okx` — строчными. Без параметра — все четыре.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "deribit"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию) — тело источника как есть, `protobuf` (`lootx.v1.Response`: поля верхнего уровня — мета, вложенное — JSON-текстом). CSV нет: ответ — не таблица. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "venues[{venue, bases[{base, chains[{chain, settle, price_ccy, catalog_ver, instruments, expiries}]}]}]: без venue — все четыре площадки (deribit, binance, bybit, okx), базы и цепочки — по имени; price_ccy — валюта цен bid, ask, mark цепочки (валюта котировки цепочки), null — инструменты цепочки расходятся. ETag — хэш тела, Cache-Control: private, no-cache",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OptionsBasesResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              }
            }
          },
          "304": {
            "description": "If-None-Match совпал с ETag: список не изменился",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута или он повторён; не та форма venue; format=csv или opc1 (не у этого маршрута); источник не знает venue (upstream_rejected, param venue)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа options не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или телом не той формы; маршрутов опционов на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/options/catalog": {
      "get": {
        "tags": [
          "options"
        ],
        "summary": "Каталог: инструменты базы по цепочкам — страйк, экспирация, вид, размер контракта, шаг цены\nи его ступени, наименьшая заявка, валюта расчёта, состояние. Источник — oi-funding\n`/v1/options/catalog` из памяти; метка — по `catalog_ver` цепочек: шлюз держит каталог и\nперепроверяет его у источника каждым запросом.",
        "operationId": "options_catalog",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/options",
          "description": "Опционы"
        },
        "parameters": [
          {
            "name": "base",
            "in": "query",
            "description": "База: 1–16 знаков из A-Z, 0-9 (`BTC`, `ETH`, `SOL`). Обязательна. Список баз — у\nплощадки; базы без опционов источник отвергает (`400`, param base).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "BTC"
          },
          {
            "name": "venue",
            "in": "query",
            "description": "Площадка: `deribit` (по умолчанию), `binance`, `bybit`, `okx` — строчными.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "deribit"
          },
          {
            "name": "chain",
            "in": "query",
            "description": "Одна цепочка базы (`BTC`, `BTC_USDC`; A-Z, 0-9, `_`, до 32). Без параметра — все.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "BTC_USDC"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию) — тело источника как есть, `protobuf` (`lootx.v1.Response`: поля верхнего уровня — мета, вложенное — JSON-текстом). CSV нет: ответ — не таблица. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "venue, base, chains[{chain, catalog_ver, settle, price_ccy, volume_usd_ccy, volume_notional_ccy, instruments}]: settle — linear или inverse; price_ccy — валюта цен bid, ask, mark (валюта котировки цепочки); volume_usd_ccy — валюта премии (Deribit — USD, Binance — USDT), volume_notional_ccy — валюта номинала, только Bybit (USDT; на _USDC — USDC); null — у цепочки не одно значение или площадка не шлёт. Страйк, размер контракта и шаги — десятичной строкой, время — Unix-мс. ETag — по catalog_ver цепочек, Cache-Control: private, no-cache",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OptionsCatalogResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              }
            }
          },
          "304": {
            "description": "If-None-Match совпал с ETag: каталог не изменился",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута или он повторён; нет base или не та форма base, venue, chain; format=csv или opc1 (не у этого маршрута); источник отверг base без опционов, venue или chain не этой базы (upstream_rejected, param — base, venue, chain)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа options не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или телом не той формы; маршрутов опционов на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/options/chain": {
      "get": {
        "tags": [
          "options"
        ],
        "summary": "Цепочка минуты, закрытой в `at` или раньше. Осевшая (через 2 минуты после закрытия) и целая\n(все цепочки базы, у каждой строки имя) минута — `immutable`: шлюз держит её в кэше и сверяет\n`If-None-Match` сам. Неполная — с `missing` и `no-cache`, мимо кэша.",
        "operationId": "options_chain",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/options",
          "description": "Опционы"
        },
        "parameters": [
          {
            "name": "base",
            "in": "query",
            "description": "База, как у catalog. Обязательна.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "BTC"
          },
          {
            "name": "venue",
            "in": "query",
            "description": "Площадка: `deribit` (по умолчанию), `binance`, `bybit`, `okx`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "description": "Одна цепочка базы; без параметра — все.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "at",
            "in": "query",
            "description": "Момент: ответ — минута, закрытая в `at` или раньше. Unix-мс UTC или ISO-8601. Обязателен.\nГлубина тарифа меряется началом этой минуты.",
            "required": true,
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unix-миллисекунды UTC, меньше 10000000000000 (больше — 400: микро- или наносекунды)"
                },
                {
                  "type": "string",
                  "description": "ISO-8601: 2024-01-01 (полночь UTC) или 2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm], без зоны — UTC; «+» зоны в query — %2B; раньше 2286-11-20T17:46:40Z"
                }
              ]
            },
            "example": 1795110000000
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию) — тело источника как есть, `protobuf` (`lootx.v1.Response`: поля верхнего уровня — мета, вложенное — JSON-текстом), `opc1` — кадры OPC1 источника насквозь (`application/octet-stream`, uvarint длина и кадр на цепочку). Предварительный формат: версия кадра (байт 4 после магии `OPC1`) может вырасти без смены версии API; клиент обязан отвергать незнакомую версию. JSON и protobuf — стабильны. Кадры выбираются только параметром `format=opc1`: `Accept` их не выбирает (`Accept: application/octet-stream` без параметра — `406`). CSV нет: ответ — не таблица. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "opc1"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Как у chain/latest, минута — закрытая в at или раньше. Целая осевшая минута — ETag и Cache-Control: private, max-age=31536000, immutable (повтор — из кэша шлюза, X-Cache: HIT); неполная (missing) или свежая — private, no-cache. format=opc1 — кадры источника (application/octet-stream; предварительный формат, как у chain/latest)",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              },
              "x-options-missing": {
                "schema": {
                  "type": "string"
                },
                "description": "Цепочки без минуты: ЦЕПОЧКА:причина через запятую (no_frame, gap)"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OptionsChainResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "OPC1 (format=opc1) — тело источника как есть: на цепочку минуты uvarint длины и ключевой кадр (магия OPC1, DEFLATE внутри); цепочки без минуты — в заголовке x-options-missing. Предварительный формат: версия кадра (байт 4 после магии `OPC1`) может вырасти без смены версии API; клиент обязан отвергать незнакомую версию. JSON и protobuf — стабильны. Кадры выбираются только параметром `format=opc1`: `Accept` их не выбирает (`Accept: application/octet-stream` без параметра — `406`)."
                }
              }
            }
          },
          "304": {
            "description": "If-None-Match совпал с ETag: минута та же",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута или он повторён; нет base или at; не та форма base, venue, chain; at не мс и не ISO-8601, в секундах или микросекундах; format=csv; источник отверг параметр (upstream_rejected, param — его имя)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа options не в тарифе, минута глубже тарифа (history_out_of_plan, param at, earliest_allowed_ms — первый at, который пройдёт)",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или телом не той формы; маршрутов опционов на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/options/chain/latest": {
      "get": {
        "tags": [
          "options"
        ],
        "summary": "Цепочка последней минуты: строки инструментов — котировки, mark, `iv_bp`, OI, объёмы,\nфорвард и индекс. Цепочки без минуты — в `missing` (у OPC1 — в `x-options-missing`). Никогда\nне `immutable`: следующий ответ того же адреса — новая минута; мимо кэша шлюза.",
        "operationId": "options_chain_latest",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/options",
          "description": "Опционы"
        },
        "parameters": [
          {
            "name": "base",
            "in": "query",
            "description": "База: 1–16 знаков из A-Z, 0-9 (`BTC`, `ETH`, `SOL`). Обязательна. Список баз — у\nплощадки; базы без опционов источник отвергает (`400`, param base).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "BTC"
          },
          {
            "name": "venue",
            "in": "query",
            "description": "Площадка: `deribit` (по умолчанию), `binance`, `bybit`, `okx` — строчными.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "deribit"
          },
          {
            "name": "chain",
            "in": "query",
            "description": "Одна цепочка базы (`BTC`, `BTC_USDC`; A-Z, 0-9, `_`, до 32). Без параметра — все.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "BTC_USDC"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию) — тело источника как есть, `protobuf` (`lootx.v1.Response`: поля верхнего уровня — мета, вложенное — JSON-текстом), `opc1` — кадры OPC1 источника насквозь (`application/octet-stream`, uvarint длина и кадр на цепочку). Предварительный формат: версия кадра (байт 4 после магии `OPC1`) может вырасти без смены версии API; клиент обязан отвергать незнакомую версию. JSON и protobuf — стабильны. Кадры выбираются только параметром `format=opc1`: `Accept` их не выбирает (`Accept: application/octet-stream` без параметра — `406`). CSV нет: ответ — не таблица. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "opc1"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "venue, base, chains[{chain, ts_min, snap_ts, oi_asof_ms, catalog_ver, settle, price_ccy, volume_usd_ccy, volume_notional_ccy, rows}], missing (если есть цепочки без минуты); валюта цепочки — из каталога в памяти источника. Деньги *_usd_e8 — целым строкой (× 10⁸) в валюте площадки: volume_usd_e8 — премия за 24 ч (Deribit — USD, Binance — USDT; у Bybit и OKX — null), volume_notional_usd_e8 — номинал за 24 ч, только Bybit (в монете расчёта: USDT; на _USDC — USDC); USDT — не USD. Цены (bid, ask, mark) — за 1 монету базы, десятичной строкой в валюте котировки цепочки (inverse — в монете базы); количества (oi_asof, volume, bid_size, ask_size) — в контрактах, десятичной строкой (× contract_size — монеты базы), iv_bp — целым. format=opc1 — кадры источника (application/octet-stream; предварительный формат: версия кадра — байт 4 после магии OPC1, незнакомую версию клиент отвергает; только параметром, не по Accept). ETag, Cache-Control: private, no-cache",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              },
              "x-options-missing": {
                "schema": {
                  "type": "string"
                },
                "description": "Цепочки без минуты: ЦЕПОЧКА:причина через запятую (no_frame, gap)"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OptionsChainResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "OPC1 (format=opc1) — тело источника как есть: на цепочку минуты uvarint длины и ключевой кадр (магия OPC1, DEFLATE внутри); цепочки без минуты — в заголовке x-options-missing. Предварительный формат: версия кадра (байт 4 после магии `OPC1`) может вырасти без смены версии API; клиент обязан отвергать незнакомую версию. JSON и protobuf — стабильны. Кадры выбираются только параметром `format=opc1`: `Accept` их не выбирает (`Accept: application/octet-stream` без параметра — `406`)."
                }
              }
            }
          },
          "304": {
            "description": "If-None-Match совпал с ETag: минута та же",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута или он повторён; нет base или не та форма base, venue, chain; format=csv; источник отверг параметр (upstream_rejected, param — его имя)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа options не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или телом не той формы; маршрутов опционов на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/options/chain/range": {
      "get": {
        "tags": [
          "options"
        ],
        "summary": "История одной цепочки за `[from, to)` — до 360 минут. `format=opc1` — кадры цепочки по\nминутам: первый ключевой, следующие — как хранит источник (дельта — только к кадру, отданному\nперед ней); JSON и protobuf — ряд одного инструмента (`instrument=`) по минутам. Целый осевший\nдиапазон — `immutable`: шлюз держит его в кэше; диапазон в настоящее или с пропусками — мимо.\nВес запроса — час диапазона ([`range_weight`]).",
        "operationId": "options_chain_range",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/options",
          "description": "Опционы"
        },
        "parameters": [
          {
            "name": "base",
            "in": "query",
            "description": "База, как у catalog. Обязательна.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "BTC"
          },
          {
            "name": "venue",
            "in": "query",
            "description": "Площадка: `deribit` (по умолчанию), `binance`, `bybit`, `okx`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "description": "Цепочка базы (`BTC`, `BTC_USDC`). Обязательна: диапазон — одной цепочки.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "BTC"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало `[from, to)`: Unix-мс UTC или ISO-8601, целая минута. Обязателен. Глубина тарифа —\nпо нему.",
            "required": true,
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unix-миллисекунды UTC, меньше 10000000000000 (больше — 400: микро- или наносекунды)"
                },
                {
                  "type": "string",
                  "description": "ISO-8601: 2024-01-01 (полночь UTC) или 2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm], без зоны — UTC; «+» зоны в query — %2B; раньше 2286-11-20T17:46:40Z"
                }
              ]
            },
            "example": 1795089600000
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец `[from, to)` (не входит), целая минута; `from < to`, не больше 360 минут (6 ч).\nОбязателен. Вес запроса — час диапазона: до 60 минут — 1, 61–120 — 2, … 301–360 — 6.",
            "required": true,
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unix-миллисекунды UTC, меньше 10000000000000 (больше — 400: микро- или наносекунды)"
                },
                {
                  "type": "string",
                  "description": "ISO-8601: 2024-01-01 (полночь UTC) или 2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm], без зоны — UTC; «+» зоны в query — %2B; раньше 2286-11-20T17:46:40Z"
                }
              ]
            },
            "example": 1795093200000
          },
          {
            "name": "instrument",
            "in": "query",
            "description": "Инструмент цепочки (`BTC-20NOV26-95000-C`; A-Z, a-z, 0-9, `-`, `_`, `.` до 64 знаков).\nОбязателен у JSON и protobuf: ответ — ряд этого инструмента по минутам. У `format=opc1`\nего нет — кадры всей цепочки.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "BTC-20NOV26-95000-C"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию) — тело источника как есть, `protobuf` (`lootx.v1.Response`: поля верхнего уровня — мета, вложенное — JSON-текстом), `opc1` — кадры OPC1 источника насквозь (`application/octet-stream`, кадры одной цепочки по минутам, у каждого uvarint длина, первый — ключевой). Предварительный формат: версия кадра (байт 4 после магии `OPC1`) может вырасти без смены версии API; клиент обязан отвергать незнакомую версию. JSON и protobuf — стабильны. Кадры выбираются только параметром `format=opc1`: `Accept` их не выбирает (`Accept: application/octet-stream` без параметра — `406`). CSV нет: ответ — не таблица. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "opc1"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "JSON — venue, base, chain, instrument, from, to, rows[{ts_min, snap_ts, oi_asof_ms, catalog_ver, …поля строки /chain}], missing (если есть минуты без кадра): строка инструмента каждой минуты — строка в строку как у /chain?at= той минуты; до листинга инструмента строк нет. Деньги *_usd_e8 — целым строкой (× 10⁸) в валюте площадки: volume_usd_e8 — премия за 24 ч (Deribit — USD, Binance — USDT; у Bybit и OKX — null), volume_notional_usd_e8 — номинал за 24 ч, только Bybit (в монете расчёта: USDT; на _USDC — USDC); USDT — не USD. Цены (bid, ask, mark) — за 1 монету базы, десятичной строкой в валюте котировки цепочки (inverse — в монете базы; валюта — price_ccy каталога или bases); количества (oi_asof, volume, bid_size, ask_size) — в контрактах, десятичной строкой (× contract_size — монеты базы). format=opc1 — кадры цепочки (application/octet-stream; предварительный формат: версия кадра — байт 4 после магии OPC1, незнакомую версию клиент отвергает; только параметром, не по Accept): у каждого uvarint длина, первый — ключевой, следующие — как хранит источник (версии кадра 1–2, дельта ссылается на кадр перед ней). Целый осевший диапазон (последняя минута осела, пропусков нет) — ETag и Cache-Control: private, max-age=31536000, immutable (повтор — из кэша шлюза, X-Cache: HIT); диапазон в настоящее или с пропусками — private, no-cache",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              },
              "x-options-missing": {
                "schema": {
                  "type": "string"
                },
                "description": "Минуты без кадра — интервалами FROM_MS-TO_MS:причина через запятую (no_frame, gap), до 1 КиБ, остаток — последним +N; полный список — missing в JSON. Не тот синтаксис, что у /chain и /chain/latest (там — ЦЕПОЧКА:причина)"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OptionsRangeResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "OPC1 (format=opc1) — тело источника как есть: кадры одной цепочки по минутам [from, to), у каждого uvarint длина (магия OPC1, DEFLATE внутри); первый — ключевой, следующие — как хранит источник (версии кадра 1–2, дельта ссылается на кадр перед ней). Минуты без кадра — интервалами в заголовке x-options-missing (FROM_MS-TO_MS:причина, а не цепочки, как у /chain). Предварительный формат: версия кадра (байт 4 после магии `OPC1`) может вырасти без смены версии API; клиент обязан отвергать незнакомую версию. JSON и protobuf — стабильны. Кадры выбираются только параметром `format=opc1`: `Accept` их не выбирает (`Accept: application/octet-stream` без параметра — `406`)."
                }
              }
            }
          },
          "304": {
            "description": "If-None-Match совпал с ETag: диапазон тот же",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута или он повторён; нет base, chain, from или to; не та форма base, venue, chain, instrument; from/to не мс и не ISO-8601, не целые минуты, from ≥ to, диапазон больше 360 минут (param to); JSON и protobuf без instrument, opc1 с instrument; format=csv; источник отверг параметр (upstream_rejected, param — его имя: range_too_long — to, bad_instrument — instrument)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа options не в тарифе, from глубже тарифа (history_out_of_plan, param from)",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или телом не той формы; маршрутов опционов на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/options/coverage": {
      "get": {
        "tags": [
          "options"
        ],
        "summary": "Покрытие базы: цепочки (новейшая минута, лаг, несобираемая минута) и дыры сбора окна\n(`chain` — кадры цепочки, `live` — поток площадки, `catalog`, `oi`, `quotes` — опросы; дыра\nнеопознанной единицы — `chain: null` с `source`). Мимо кэша шлюза.",
        "operationId": "options_coverage",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/options",
          "description": "Опционы"
        },
        "parameters": [
          {
            "name": "base",
            "in": "query",
            "description": "База, как у catalog. Обязательна.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "BTC"
          },
          {
            "name": "venue",
            "in": "query",
            "description": "Площадка: `deribit` (по умолчанию), `binance`, `bybit`, `okx`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало окна дыр, Unix-мс UTC или ISO-8601. По умолчанию — сутки до сейчас. Глубина\nтарифа — по нему.",
            "required": false,
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unix-миллисекунды UTC, меньше 10000000000000 (больше — 400: микро- или наносекунды)"
                },
                {
                  "type": "string",
                  "description": "ISO-8601: 2024-01-01 (полночь UTC) или 2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm], без зоны — UTC; «+» зоны в query — %2B; раньше 2286-11-20T17:46:40Z"
                }
              ]
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец окна. По умолчанию — сейчас. Окно — до 31 суток, `from < to`.",
            "required": false,
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unix-миллисекунды UTC, меньше 10000000000000 (больше — 400: микро- или наносекунды)"
                },
                {
                  "type": "string",
                  "description": "ISO-8601: 2024-01-01 (полночь UTC) или 2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm], без зоны — UTC; «+» зоны в query — %2B; раньше 2286-11-20T17:46:40Z"
                }
              ]
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию) — тело источника как есть, `protobuf` (`lootx.v1.Response`: поля верхнего уровня — мета, вложенное — JSON-текстом). CSV нет: ответ — не таблица. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "base, chains[{chain, lag_ms, last_ts_min, unbuilt?}], from, gaps[{chain, from_ms, reason, source?, stream, to_ms}], to, venue — ключи по алфавиту, как у источника. gaps[].chain — книга дыры; null — записанное имя не цепочка и не индекс каталога (единица опроса), оно — в source, и такая дыра — в ответе каждой базы; source есть, когда дыра записана не под своей цепочкой (индекс, базовый актив OKX). stream — chain, live, catalog, oi или quotes. ETag, Cache-Control: private, no-cache",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OptionsCoverageResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              }
            }
          },
          "304": {
            "description": "If-None-Match совпал с ETag: ответ не изменился",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута или он повторён; нет base или не та форма base, venue; from/to не мс и не ISO-8601; format=csv или opc1; источник отверг окно (upstream_rejected, param from: нужно from < to, не больше 31 суток)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа options не в тарифе, from глубже тарифа (history_out_of_plan, param from)",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или телом не той формы; маршрутов опционов на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/options/expiries": {
      "get": {
        "tags": [
          "options"
        ],
        "summary": "Экспирации базы по цепочкам: число call и put и суммы объёма новейшей минуты. Источник —\noi-funding `/v1/options/expiries` из памяти, мимо кэша шлюза.",
        "operationId": "options_expiries",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/options",
          "description": "Опционы"
        },
        "parameters": [
          {
            "name": "base",
            "in": "query",
            "description": "База, как у catalog. Обязательна.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "BTC"
          },
          {
            "name": "venue",
            "in": "query",
            "description": "Площадка: `deribit` (по умолчанию), `binance`, `bybit`, `okx`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию) — тело источника как есть, `protobuf` (`lootx.v1.Response`: поля верхнего уровня — мета, вложенное — JSON-текстом). CSV нет: ответ — не таблица. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "base, expiries[{calls, chain, expiry_ms, oi_asof_ms, oi_calls, oi_coins, oi_puts, oi_rows, price_ccy, puts, settle, settlement_period, volume_notional_ccy, volume_notional_usd_e8, volume_usd_ccy, volume_usd_e8}], venue — ключи по алфавиту, как у источника; деньги *_usd_e8 — целым строкой (× 10⁸, i128) в валюте площадки: volume_usd_e8 — премия за 24 ч (Deribit — USD, Binance — USDT; у Bybit и OKX — null), volume_notional_usd_e8 — номинал за 24 ч, только Bybit (в монете расчёта: USDT; на _USDC — USDC); USDT — не USD; null — поля у площадки нет или кадра ещё нет; валюты — в volume_usd_ccy и volume_notional_ccy. OI новейшей минуты: oi_calls, oi_puts — в контрактах десятичной строкой, oi_coins — монеты базы, oi_asof_ms — момент OI, oi_rows — строк в суммах; без кадра — null. ETag, Cache-Control: private, no-cache",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OptionsExpiriesResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              }
            }
          },
          "304": {
            "description": "If-None-Match совпал с ETag: ответ не изменился",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута или он повторён; нет base или не та форма base, venue; format=csv или opc1; источник отверг base или venue (upstream_rejected, param — его имя)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа options не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или телом не той формы (деньги числом); маршрутов опционов на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/options/exposure/latest": {
      "get": {
        "tags": [
          "options"
        ],
        "summary": "GEX, DEX, VEX и CEX новейшей минуты книги по страйкам группы экспираций, их суммы и профиль\nnet GEX (±15 % от индекса шагом 0,25 %); `venue=all` — сумма книг базы всех площадок в\nдолларах одного индекса с долями площадок у страйка. Источник считает ответ на чтении из\nминуты в памяти; JSON — тело источника как есть, деньги `*_usd_e8` — целым строкой. Живой:\n`no-cache` и `ETag` источника, `If-None-Match` — ему, мимо кэша шлюза. Вес — 1.",
        "operationId": "options_exposure_latest",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/options",
          "description": "Опционы"
        },
        "parameters": [
          {
            "name": "base",
            "in": "query",
            "description": "База, как у catalog. Обязательна.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "BTC"
          },
          {
            "name": "venue",
            "in": "query",
            "description": "Площадка: `deribit` (по умолчанию), `binance`, `bybit`, `okx` или `all` — сумма книг базы\nвсех площадок в долларах одного индекса (с долями площадок у страйка; `chain` с ней — `400`).",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "deribit"
          },
          {
            "name": "chain",
            "in": "query",
            "description": "Книга базы (`BTC`, `BTC_USDC`). Без параметра — книга с именем базы, а если её нет и книга у\nбазы одна — она; иначе и у неизвестной книги — `404`. Книги разных котировок не\nскладываются: сумма книг — только `venue=all`.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "BTC"
          },
          {
            "name": "expiry",
            "in": "query",
            "description": "Группа экспираций от метки снимка: `0dte` — поставка до конца текущих суток UTC (с 08:00\nдо полуночи пусто), `Nd` — не позже снимка + N суток, `all` (по умолчанию).",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Группа экспираций расчёта naive — горизонты от метки снимка (схема параметра; разбирает дверь\n— [`expiry_of`]).",
              "enum": [
                "0dte",
                "1d",
                "7d",
                "31d",
                "91d",
                "all"
              ]
            },
            "example": "all"
          },
          {
            "name": "mode",
            "in": "query",
            "description": "Знак дилера: только `naive` (по умолчанию) — коллы +, путы −.",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Режим знака дилера (схема параметра; разбирает дверь — [`mode_of`]): до ленты сделок — только\n`naive`.",
              "enum": [
                "naive"
              ]
            },
            "example": "naive"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию) — тело источника как есть, `protobuf` (`lootx.v1.Response`: поля верхнего уровня — мета, вложенное — JSON-текстом). CSV нет: ответ — не таблица. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "venue, base, chain (книга ответа; у venue=all — null), expiry, mode (эхо запроса), asof_ms (минута расчёта), coverage{complete, gaps[{from_ms, to_ms, chain, stream, reason}]}, usd_ccy (валюта всех *_usd_e8: котировка книги, у venue=all — опорной книги; USDT — не USD), spot, expiries_ms, totals{gex_usd_e8, dex_usd_e8, vex_usd_e8, cex_usd_e8}, strikes[{strike, gex_call_usd_e8, gex_put_usd_e8, dex_usd_e8, vex_usd_e8, cex_usd_e8, oi_call_coins, oi_put_coins, venue_share?}], profile[{price, gex_usd_e8}]. Деньги — целым строкой (× 10⁸), на 1 % хода, naive (коллы +, путы −); OI — монеты базы десятичной строкой; цены и страйки — в шкале инструмента. Книга без минуты, без расчёта или с переполнением — 200 с totals: null, пустыми strikes и profile и дырой в coverage.gaps (не ноль); книга без индекса (OKX) — spot: null и пустой profile. venue=all: venue_share{deribit, binance, bybit, okx} у страйка, минута суммы — новейшая общая для всех книг; причина дыры книги — с площадкой (no_frame:<площадка>, no_calc:<площадка>, other_minute:<площадка> — книги нет в минуте суммы, no_index:<площадка>), дыры суммы — без неё (no_index, sum_refused, money_overflow). 0dte с 08:00 до полуночи UTC пуста: expiries_ms [], totals — нули. ETag, Cache-Control: private, no-cache (мимо кэша шлюза)",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OptionsExposureLatestResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              }
            }
          },
          "304": {
            "description": "If-None-Match совпал с ETag: минута та же",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута или он повторён; нет base или не та форма base, venue, chain; chain при venue=all (param chain); expiry не 0dte, 1d, 7d, 31d, 91d, all; mode не naive; format=csv или opc1; источник отверг параметр (upstream_rejected, код источника — в конце текста)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа options не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или телом не той формы (деньги числом); маршрутов опционов на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/options/levels/range": {
      "get": {
        "tags": [
          "options"
        ],
        "summary": "История уровней одной книги (источник истории `OPTLVL`): точка — минута ровно на границе шага\n(`1m` — до 7 суток, `5m` — до 30, `1h` — до 90), строка минутного расчёта naive: индекс,\nфорвард, zero gamma, стены, abs gamma, net GEX, max pain и ожидаемый ход ближайшей поставки\nгруппы. JSON — тело источника как есть. Целый ряд с осевшей последней границей источник зовёт\n`immutable` — шлюз держит его в кэше (ключ — все параметры после разбора); хвост и ряд с\nдырами — мимо кэша. Вес — точки ряда на 1440 ([`levels_range_weight`]).",
        "operationId": "options_levels_range",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/options",
          "description": "Опционы"
        },
        "parameters": [
          {
            "name": "base",
            "in": "query",
            "description": "База, как у catalog. Обязательна.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "BTC"
          },
          {
            "name": "venue",
            "in": "query",
            "description": "Площадка: `deribit` (по умолчанию), `binance`, `bybit`, `okx`. `all` — `400`: уровни —\nодной книги.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "deribit"
          },
          {
            "name": "chain",
            "in": "query",
            "description": "Книга базы, как у `vol/book-range`. Присылайте явно: без неё ряд зависит от набора книг.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "BTC"
          },
          {
            "name": "expiry",
            "in": "query",
            "description": "Группа экспираций, как у `exposure/latest`; по умолчанию `all`.",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Группа экспираций расчёта naive — горизонты от метки снимка (схема параметра; разбирает дверь\n— [`expiry_of`]).",
              "enum": [
                "0dte",
                "1d",
                "7d",
                "31d",
                "91d",
                "all"
              ]
            },
            "example": "all"
          },
          {
            "name": "mode",
            "in": "query",
            "description": "Знак дилера: только `naive` (по умолчанию).",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Режим знака дилера (схема параметра; разбирает дверь — [`mode_of`]): до ленты сделок — только\n`naive`.",
              "enum": [
                "naive"
              ]
            },
            "example": "naive"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало `[from, to)`: Unix-мс UTC или ISO-8601. Обязателен. Первая точка — первая граница\nшага не раньше него. Глубина тарифа — по нему.",
            "required": true,
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unix-миллисекунды UTC, меньше 10000000000000 (больше — 400: микро- или наносекунды)"
                },
                {
                  "type": "string",
                  "description": "ISO-8601: 2024-01-01 (полночь UTC) или 2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm], без зоны — UTC; «+» зоны в query — %2B; раньше 2286-11-20T17:46:40Z"
                }
              ]
            },
            "example": 1795089600000
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец `[from, to)` (не входит); `from < to`, при `step=1m` — не больше 7 суток, `5m` — 30,\n`1h` — 90. Обязателен.",
            "required": true,
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unix-миллисекунды UTC, меньше 10000000000000 (больше — 400: микро- или наносекунды)"
                },
                {
                  "type": "string",
                  "description": "ISO-8601: 2024-01-01 (полночь UTC) или 2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm], без зоны — UTC; «+» зоны в query — %2B; раньше 2286-11-20T17:46:40Z"
                }
              ]
            },
            "example": 1795176000000
          },
          {
            "name": "step",
            "in": "query",
            "description": "Шаг ряда: `1m`, `5m`, `1h` — границы, кратные шагу от 1970. Обязателен. Вес запроса — точек\nряда на 1440 (сутки минутами), вверх: сутки минутами — 1, 7 суток минутами — 7, 30 суток\nпо 5 минут — 6, 90 суток часами — 2.",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Шаг истории `/v1/options/levels/range` (схема параметра; разбирает дверь — [`levels_ask`]).",
              "enum": [
                "1m",
                "5m",
                "1h"
              ]
            },
            "example": "1h"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию) — тело источника как есть, `protobuf` (`lootx.v1.Response`: поля верхнего уровня — мета, вложенное — JSON-текстом). CSV нет: ответ — не таблица. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "venue, base, chain, expiry, mode, step, from, to (эхо запроса), asof_ms (ts_ms последней строки; строк нет — null), coverage{complete, gaps[{from_ms, to_ms, chain, stream: calc, reason}]}, usd_ccy (валюта net_gex_usd_e8 — котировка книги), rows[{ts_ms, spot, fwd, zero_gamma, zero_gamma_sticky_delta, unstable, call_walls, put_walls, abs_gamma, net_gex_usd_e8, max_pain, max_pain_expiry_ms, move_straddle_bp, move_sigma_bp}]. Точка — минута с началом ровно на границе шага (кратные шага от 1970). Цены и страйки — точной десятичной строкой в шкале инструмента; net_gex_usd_e8 — целым строкой (× 10⁸); null — нет данных, не ноль: у книги без индекса (OKX) spot, zero_gamma и стены — null, нет смены знака профиля — zero_gamma: null, нет экспирации в группе — max_pain: null и net_gex_usd_e8 \"0\". Ход — ближайшей поставки группы с ATM IV, б. п. от форварда, по сырому сроку до поставки. Дыра — нет строки и запись в coverage.gaps (reason: no_calc — граница не позже новейшей минуты книги без строки расчёта, no_frame — у книги нет минуты); границы после новейшей минуты книги — открытый хвост, не дыра. Целый ряд с осевшей последней границей — ETag и Cache-Control: private, max-age=31536000, immutable (повтор — из кэша шлюза, X-Cache: HIT); хвост или ряд с дырами — private, no-cache",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OptionsLevelsRangeResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              }
            }
          },
          "304": {
            "description": "If-None-Match совпал с ETag: ряд тот же",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута или он повторён; нет base, from, to или step; не та форма base, venue, chain; venue=all (уровни — одной книги, param venue); expiry не 0dte, 1d, 7d, 31d, 91d, all; mode не naive; step не 1m, 5m, 1h; from/to не мс и не ISO-8601, в секундах или микросекундах; from ≥ to; диапазон больше 7 суток при step=1m, 30 — при 5m, 90 — при 1h (param to); format=csv или opc1; источник отверг параметр (upstream_rejected, код источника — в конце текста: range_too_long — param to)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа options не в тарифе, from глубже тарифа (history_out_of_plan, param from)",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или телом не той формы (деньги числом); маршрутов опционов на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/options/stream": {
      "get": {
        "tags": [
          "options"
        ],
        "summary": "WebSocket: живой поток цепочек базы (oi-funding `/v1/options/stream`, договор —\ndocs/OPC1.md «Поток»). Первое сообщение — текст JSON `hello` (`epoch` процесса источника,\nплощадка, база, цепочки с `seq` и `live`), дальше бинарные сообщения — по одному кадру OPC1\nна сообщение, байт в байт как у источника. Кадры клиента не нужны. Закрытия источника —\nклиенту кодом и причиной; обрыв источника — 1013. Мост — [`super::ws::options_stream`].",
        "operationId": "options_stream",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/websocket",
          "description": "Потоки WebSocket"
        },
        "parameters": [
          {
            "name": "base",
            "in": "query",
            "description": "База: 1–16 знаков из A-Z, 0-9 (`BTC`, `ETH`). Обязательна.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "BTC"
          },
          {
            "name": "venue",
            "in": "query",
            "description": "Площадка: `deribit` (по умолчанию), `binance`, `bybit`, `okx` — строчными.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "deribit"
          },
          {
            "name": "chain",
            "in": "query",
            "description": "Цепочки базы через запятую (до 64; каждая — A-Z, 0-9, `_`, до 32). Без параметра — все\nцепочки базы на момент соединения: набор держится всё соединение.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "BTC,BTC_USDC"
          },
          {
            "name": "resume",
            "in": "query",
            "description": "Продолжение после обрыва: `<epoch>:<цепочка>:<seq>` через запятую, по одному на цепочку\n— `epoch` из `hello`, `seq` — заголовка последнего принятого кадра цепочки. Тот же\nпроцесс источника и `seq` ещё в его кольце — ровно пропущенные кадры, иначе — ключевой.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "3f9c0a1b2c3d4e5f:BTC:41,3f9c0a1b2c3d4e5f:BTC_USDC:7"
          }
        ],
        "responses": {
          "101": {
            "description": "Соединение установлено. Первое сообщение — текст JSON {\"type\":\"hello\",\"epoch\":\"<16 hex>\",\"venue\":\"deribit\",\"base\":\"BTC\",\"chains\":[{\"chain\":\"BTC\",\"seq\":41,\"live\":true}]}: epoch — процесс источника, seq — кадр, на котором цепочка стоит (0 — кадров ещё нет), live — у цепочки есть живой канал площадки. Дальше бинарные сообщения — по одному кадру OPC1 на сообщение, без uvarint длины (бит 0 флагов — DEFLATE внутри; предварительный формат: версия кадра — байт 4 после магии OPC1, клиент обязан отвергать незнакомую версию): по каждой цепочке сначала ключевой кадр на hello.seq (с resume — пропущенные кадры), затем каждый новый — минута или живой кадр (mark и iv_bp, не чаще раза в секунду на цепочку). seq заголовка кадра — потока (u32 на цепочку, +1 на кадр), дельта ссылается на кадр перед ней: дыра в seq — переподключиться с resume. Пинг источника — раз в 20 с. Закрытия: 4008 slow consumer — клиент не успевал читать (очередь 64 кадра или отправка дольше 5 с), переподключиться с resume; 1011 hello — источник не собрал hello; 1001 — источник останавливается; 1013 upstream_unavailable — источник оборвал соединение; 1008 — ключ отозван, группа закрыта, суточный объём исчерпан (daily_quota_exceeded). Байты всех сообщений — в суточный объём аккаунта и группы options; соединение — один запрос",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "description": "Параметра нет у потока или он повторён; format или table; нет base или не та форма base, venue, chain (больше 64 цепочек), resume; источник отверг параметр (upstream_rejected, param — его имя: bad_resume — resume, bad_chain — chain)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа options не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен или ответил ошибкой; маршрута потока на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил на рукопожатие вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/options/vol/book-range": {
      "get": {
        "tags": [
          "options"
        ],
        "summary": "Ряд волатильности одной книги: точка — минута ровно на границе шага (`1h` — до 90 суток,\n`1d` — до 365), в ней ATM IV постоянного срока 7, 30 и 90 суток, крылья 25Δ 30 суток, RR и BF,\nиндекс. Денег в ответе нет; JSON — тело источника как есть. Целый ряд, у которого последняя\nграница осела, источник зовёт `immutable` — шлюз держит его в кэше (ключ — все параметры\nпосле разбора); хвост с неосевшей границей и ряд с дырами — мимо кэша. Вес запроса — границы\nшага на 64 ([`vol_book_range_weight`]).",
        "operationId": "options_vol_book_range",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/options",
          "description": "Опционы"
        },
        "parameters": [
          {
            "name": "base",
            "in": "query",
            "description": "База, как у catalog. Обязательна.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "BTC"
          },
          {
            "name": "venue",
            "in": "query",
            "description": "Площадка: `deribit` (по умолчанию), `binance`, `bybit`, `okx`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "description": "Книга базы (`BTC`, `BTC_USDC`). Без параметра — книга с именем базы (`BTC`, а не\n`BTC_USDC`), а если её нет и книга у базы одна — она (`SOL` → `SOL_USDC`); иначе и у\nнеизвестной книги — `404`. Присылайте явно: без неё ряд зависит от набора книг площадки.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "BTC"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало `[from, to)`: Unix-мс UTC или ISO-8601. Обязателен. Первая точка — первая граница\nшага не раньше него. Глубина тарифа — по нему.",
            "required": true,
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unix-миллисекунды UTC, меньше 10000000000000 (больше — 400: микро- или наносекунды)"
                },
                {
                  "type": "string",
                  "description": "ISO-8601: 2024-01-01 (полночь UTC) или 2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm], без зоны — UTC; «+» зоны в query — %2B; раньше 2286-11-20T17:46:40Z"
                }
              ]
            },
            "example": 1795089600000
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец `[from, to)` (не входит); `from < to`, при `step=1h` — не больше 90 суток, при\n`step=1d` — не больше 365. Обязателен.",
            "required": true,
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unix-миллисекунды UTC, меньше 10000000000000 (больше — 400: микро- или наносекунды)"
                },
                {
                  "type": "string",
                  "description": "ISO-8601: 2024-01-01 (полночь UTC) или 2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm], без зоны — UTC; «+» зоны в query — %2B; раньше 2286-11-20T17:46:40Z"
                }
              ]
            },
            "example": 1795176000000
          },
          {
            "name": "step",
            "in": "query",
            "description": "Шаг ряда: `1h` — границы часов, `1d` — полночь UTC. Обязателен. Вес запроса — границ шага\nв диапазоне на 64, вверх: сутки часами — 1, 90 суток часами — 34, год сутками — 6.",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Шаг ряда `/v1/options/vol/book-range` (схема параметра; разбирает дверь — [`vol_ask`]).",
              "enum": [
                "1h",
                "1d"
              ]
            },
            "example": "1h"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию) — тело источника как есть, `protobuf` (`lootx.v1.Response`: поля верхнего уровня — мета, вложенное — JSON-текстом). CSV нет: ответ — не таблица. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "venue, base, chain, step, from, to (эхо запроса), asof_ms (ts_ms последней строки; строк нет — null), coverage{complete, gaps[{from_ms, to_ms, chain, stream, reason}]}, rows[{ts_ms, index, atm_iv_bp{d7, d30, d90}, put25_iv_bp_30d, call25_iv_bp_30d, rr25_bp_30d, bf25_bp_30d}]. Точка — минута с началом ровно на границе шага (границы — кратные шага от 1970, сутки — UTC); IV — целым, 0,01 пункта волатильности (1 % = 100), mark площадки; ATM постоянного срока — интерполяция полной дисперсии, срока нет в цепочке — null, не экстраполяция; дельта крыльев — Black-76 по форварду; RR = колл − пут, BF = (колл + пут) / 2 − ATM. Любое число строки может быть null; дыра — нет строки и запись в coverage.gaps (reason: no_frame, gap, replay_limit), границы после последней минуты книги ещё не настали — не дыра. Целый ряд с осевшей последней границей — ETag и Cache-Control: private, max-age=31536000, immutable (повтор — из кэша шлюза, X-Cache: HIT); хвост с неосевшей границей или ряд с дырами — private, no-cache",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OptionsVolBookRangeResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              }
            }
          },
          "304": {
            "description": "If-None-Match совпал с ETag: ряд тот же",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута или он повторён; нет base, from, to или step; не та форма base, venue, chain; step не 1h и не 1d; from/to не мс и не ISO-8601, в секундах или микросекундах; from ≥ to; диапазон больше 90 суток при step=1h или 365 суток при step=1d (param to); format=csv или opc1; источник отверг параметр (upstream_rejected, param — его имя: range_too_long — to)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области derivatives, группа options не в тарифе, from глубже тарифа (history_out_of_plan, param from)",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или телом не той формы; маршрутов опционов на узле нет",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/screener": {
      "get": {
        "tags": [
          "market"
        ],
        "summary": "Скринер: метрики по множеству инструментов. Источник — screener `/v1/snapshot`\n(screener-frontend/src/rest_handler.rs:25-58; формат проверен по коду): массив кадров\n`{\"k\":{\"e\",\"m\",\"s\"},\"t\":мс,...}`, null-поля опущены.",
        "operationId": "screener",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/screener",
          "description": "Скринер"
        },
        "parameters": [
          {
            "name": "venue",
            "in": "query",
            "description": "Биржи через запятую, как `venues` рыночной подписки `screener` (Upbit нет), регистр не\nважен. Неизвестная биржа — 400 `bad_request` с `param: venue`. По умолчанию — все.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance,bybit"
          },
          {
            "name": "market",
            "in": "query",
            "description": "Рынки через запятую: spot, perp.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "instruments",
            "in": "query",
            "description": "Точный набор инструментов через запятую; перекрывает venue/market.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT,hyperliquid:perp:BTC"
          },
          {
            "name": "top_n",
            "in": "query",
            "description": "Первые N по суточному объёму, 1..2000, по умолчанию 100.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "names",
            "in": "query",
            "description": "Имена колонок: `long` (по умолчанию: `volume_24h_usd`, `oi_change_usd_5m`, ...) или\n`short` (ключи кадра скринера: `v24`, `odu5`, ...). Справочник обоих —\n`GET /v1/screener/metrics`.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "long"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Метрики колонками: instrument, ts, затем метрики (last_price, change_24h_pct, volume_24h_usd, funding_rate, ...)",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SnapshotResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/screener/metrics": {
      "get": {
        "tags": [
          "market"
        ],
        "summary": "Справочник метрик скринера: какие колонки бывают у `/v1/screener`, в каких единицах и\nза какое окно. Статичен — источник не зовётся.",
        "operationId": "screener_metrics",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/screener",
          "description": "Скринер"
        },
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Метрики колонками: key (ключ кадра, names=short), name (колонка /v1/screener, names=long), unit, window, group, description",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MetricsResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области или группа не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/series": {
      "get": {
        "tags": [
          "market"
        ],
        "summary": "Ряд метрики потока сделок. Источник — data `/v2/series` (data-api/src/v2.rs:197; формат\nпроверен по коду и живому ответу E2, tests/fixtures/real/data_series_*.json):\n`{\"m\",\"unit\",\"n\",\"d\":[{\"t\":сек,\"v\":число}],\"cov\":{\"oldest\",\"newest\"}}`; `v` — без шкалы.",
        "description": "data режет `limit` со СВЕЖЕЙ стороны и считает CVD от начала своего окна — поэтому\nстраница, как у свечей, — первые `limit` шагов окна, а CVD шлюз копит сам из `delta` и\nпереносит сумму курсором: CVD второй страницы продолжает первую.\n\nЛевее `deep_until` data (глубокий ярус, свечи `ohlc_*`) дельта приходит нулём, CVD стоит, объём\nв монетах — ноль: шлюз отдаёт такие точки `null` ([`deep_point_unknown`]), CVD копится со шва,\nшов — в `deep_until` ответа, мс. data отдаёт шов у любого символа со строками `ohlc_*` при\nлюбом окне — и в живом, целиком правее шва.\n\nПустое окно — первый целый бакет не раньше `to` — тот же вызов data, как у свечей: `/v2` на\n`from >= to` отдаёт не отказ, а пустой ряд с `cov` (и швом, как у любого окна) — нарочно для\nшлюза и навсегда; по `cov` дверь опечатки отличает неизвестный символ от пустого окна.\n\nКорзины размера (`delta_size`, `cvd_size`) — тот же `/v2/series?m=delta_size&by=…`\n(v2.rs `size_series`): `{\"bins\",\"bins_ver\",\"by\",\"unit\":\"base\",\"d\":[{\"t\",\"v\":[10],\"partial\"}],\n\"cov\"?, \"delta_size_enabled\"?}`, проверено по коду и живому ответу E2\n(tests/fixtures/real/data_series_delta_size.json). `cvd_size` шлюз копит сам по каждой\nкорзине из `delta_size` — по той же причине, что `cvd`, — и переносит 10 сумм курсором `c5`.\n`cov` у корзин — границы таблиц корзин, а не баров: дверь «такого инструмента нет» их не\nчитает (символ с историей баров, но без корзин, получил бы ложный 400) — пустой 200.",
        "operationId": "series",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/order-flow",
          "description": "Поток ордеров"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Обязателен, если нет `instruments`.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "instruments",
            "in": "query",
            "description": "Сумма площадок одной монеты вместо `instrument`: 2..12 инструментов через запятую. Точка —\nсумма площадок на ts, `cvd` — нарастающая сумма суммарной дельты; в конце строки —\n`venues_present` и `venues_mask`. Вес запроса — N. У `delta_size` и `cvd_size` суммы нет —\n400 (`param=instruments`); один инструмент в `instruments=` — как `instrument=`.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT,bybit:perp:BTCUSDT"
          },
          {
            "name": "metric",
            "in": "query",
            "description": "Метрика: `cvd` (накопленная дельта от начала окна `from`), `delta` (покупки − продажи\nагрессором за шаг), `volume`, `trades_n` (число сделок), `delta_size` (дельта по 10\nкорзинам размера сделки, $0–1k … $5M+, в монетах), `cvd_size` (её накопленная сумма от\n`from`, по корзине).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "cvd"
          },
          {
            "name": "unit",
            "in": "query",
            "description": "Единица объёма: `quote` (по умолчанию — в валюте котировки, у USDT-пар ≈ $) или `base`\n(монеты). У `trades_n` единицы нет — параметр не передавайте. `delta_size` и `cvd_size` —\nтолько `base` (по умолчанию), `quote` — 400.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "by",
            "in": "query",
            "description": "Только у `delta_size` и `cvd_size`: раскладка по корзинам — `hit` (по умолчанию: удар\nтейкера, отпечатки одной миллисекунды и стороны склеены, корзина — по их сумме в $) или\n`print` (каждый отпечаток биржи отдельно). У прочих метрик — 400.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "tf",
            "in": "query",
            "description": "Шаг: `1s`, `1m`, `5m`, `1h`, `1d` или число с суффиксом s/m/h/d, до суток. Шаг меньше\nминуты требует секундной истории в тарифе. По умолчанию `1m`.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1m"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, включительно: Unix-мс UTC или ISO-8601 — `2024-01-01` (полночь UTC),\n`2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm]` (без зоны — UTC; `+` зоны в query — `%2B`). По\nумолчанию `to - limit * tf`. Число — меньше `10000000000000` (13 знаков; больше — 400:\nмикро- или наносекунды), дата — раньше 2286-11-20T17:46:40Z.",
            "required": false,
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unix-миллисекунды UTC, меньше 10000000000000 (больше — 400: микро- или наносекунды)"
                },
                {
                  "type": "string",
                  "description": "ISO-8601: 2024-01-01 (полночь UTC) или 2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm], без зоны — UTC; «+» зоны в query — %2B; раньше 2286-11-20T17:46:40Z"
                }
              ]
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, не включительно: Unix-мс UTC или ISO-8601, как у `from`, с тем же потолком. По\nумолчанию — сейчас.",
            "required": false,
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unix-миллисекунды UTC, меньше 10000000000000 (больше — 400: микро- или наносекунды)"
                },
                {
                  "type": "string",
                  "description": "ISO-8601: 2024-01-01 (полночь UTC) или 2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm], без зоны — UTC; «+» зоны в query — %2B; раньше 2286-11-20T17:46:40Z"
                }
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Точек на страницу, 1..10000, по умолчанию 1000.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Курсор из `next_cursor`; у `cvd` и `cvd_size` он несёт накопленное значение — следующая\nстраница продолжает сумму. Курсор `cvd` и `cvd_size` привязан к `instrument`, `unit`,\n`by` и `tf`: с другими — 400 `bad_cursor`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Ряд колонками: t, value; у delta_size/cvd_size — t, b0_1k, b1k_10k, b10k_25k, b25k_50k, b50k_100k, b100k_250k, b250k_500k, b500k_1m, b1m_5m, b5m_plus (монеты на корзину размера сделки в $), partial (бакет у источника неполон). `deep_until` — шов глубокого яруса (свечи бирж с листинга): приходит у любого символа со свечами склада, и в живом окне; null — только у точек левее него: value null у delta и cvd (cvd копится со шва), у volume в unit=base и у trades_n, равного нулю",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MetricSeriesResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры; неизвестный инструмент (unsupported_instrument)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области, группа не в тарифе, история глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/status": {
      "get": {
        "tags": [
          "reference"
        ],
        "operationId": "status",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/getting-started",
          "description": "Начало работы"
        },
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Здоровье источников данных",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StatusResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/tape/events": {
      "get": {
        "tags": [
          "market"
        ],
        "summary": "События ленты одного инструмента.",
        "description": "Удары, серии и уровни, пересекающие `[from, to)` (не шире 31 суток), по `first_ms`,\nколонками. Деньги — e8 USD строкой, тело источника — как есть. Потерянное событие (закрытие не\nдошло) — `state = open`, `end = lost`. Закрытое и осевшее окно источник зовёт `immutable` —\nшлюз держит его в кэше; открытые и потерянные события — мимо кэша. Вес — сутки окна, вверх\n(1–31).",
        "operationId": "tape_events",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/trades",
          "description": "Сделки"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало окна: Unix-мс или ISO-8601. Отдаются события, пересекающие `[from, to)`; окно — не\nшире 31 суток (длинный период — несколькими запросами).",
            "required": true,
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unix-миллисекунды UTC, меньше 10000000000000 (больше — 400: микро- или наносекунды)"
                },
                {
                  "type": "string",
                  "description": "ISO-8601: 2024-01-01 (полночь UTC) или 2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm], без зоны — UTC; «+» зоны в query — %2B; раньше 2286-11-20T17:46:40Z"
                }
              ]
            },
            "example": 1791331200000
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец окна (не входит): Unix-мс или ISO-8601; `from < to`.",
            "required": true,
            "schema": {
              "oneOf": [
                {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unix-миллисекунды UTC, меньше 10000000000000 (больше — 400: микро- или наносекунды)"
                },
                {
                  "type": "string",
                  "description": "ISO-8601: 2024-01-01 (полночь UTC) или 2024-01-01T12:30[:SS[.mmm]][Z|±hh:mm], без зоны — UTC; «+» зоны в query — %2B; раньше 2286-11-20T17:46:40Z"
                }
              ]
            },
            "example": 1791334800000
          },
          {
            "name": "kind",
            "in": "query",
            "description": "Виды через запятую: `hit` (удар), `run` (серия), `level` (уровень), каждый не больше\nраза. Без параметра — все.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "hit,run"
          },
          {
            "name": "side",
            "in": "query",
            "description": "Сторона агрессора (у уровня — преобладающая). Без параметра — обе.",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Сторона агрессора события (схема параметра; разбирает дверь — [`events_ask`]).",
              "enum": [
                "buy",
                "sell"
              ]
            },
            "example": "buy"
          },
          {
            "name": "state",
            "in": "query",
            "description": "`open` — идущие (потерянные не входят), `closed` — законченные: закрытые и потерянные\n(`end = lost`), `all`; умолчание источника — `all`.",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Состояние события: открыто, закрыто или все.",
              "enum": [
                "open",
                "closed",
                "all"
              ]
            },
            "example": "closed"
          },
          {
            "name": "min_score",
            "in": "query",
            "description": "Нижний порог силы `score`, 0–1000.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "maximum": 1000,
              "minimum": 0
            },
            "example": 990
          },
          {
            "name": "min_usd",
            "in": "query",
            "description": "Нижний порог денег события в долларах: десятичная запись (`100000`, `0.164`), до 10 цифр\nцелой части и до 8 после точки, без знака и экспоненты; у уровня — обе стороны, у прочих —\nсторона агрессора. Уходит источнику как прислана, тот переводит её в e8 точно.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "100000"
          },
          {
            "name": "source",
            "in": "query",
            "description": "Проход: `live`, `archive` или `all`; у события из обоих источник отдаёт живое.",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Проход, которым найдено событие: живой, дозалив из архива или оба.",
              "enum": [
                "live",
                "archive",
                "all"
              ]
            },
            "example": "all"
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Сколько событий, от 1; больше 50 000 — 50 000 (скаляр `limit` ответа — действующий),\nумолчание источника — 5 000. Найдено больше — `truncated`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1
            },
            "example": 5000
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию) — тело источника как есть, `protobuf` (`lootx.v1.Response`: поля верхнего уровня — мета, вложенное — JSON-текстом). CSV нет: ответ — не таблица. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "События колонками длины n, по first_ms, затем id (схема TapeEventsResponse): id строкой; kind, side, state, end (lost — потеряно при state = open; null — у удара всегда, у серии и уровня — пока open); цены и количества целыми в шкале строки; деньги — e8 USD точным целым строкой; ход и сила; связи и адрес — строкой или null; скаляры exchange, market_type, symbol (имена источника), n, units_revision, det_rev, limit (действующий), truncated, asof_ms (null — знака склада нет). n = 0 — тоже 200. ETag источника \"t<версия>-<строк>-o<открытых>\" (If-None-Match — 304; потеря события меняет суффикс); все события закрыты и не потеряны, у уровней есть итог и окно осело — Cache-Control: immutable (повтор — из кэша шлюза, X-Cache: HIT), иначе no-store",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TapeEventsResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              }
            }
          },
          "304": {
            "description": "If-None-Match совпал с ETag: события те же",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута или он повторён; нет instrument, from или to; два и больше инструментов (суммы событий нет); from/to не мс и не ISO-8601; from ≥ to; окно шире 31 суток (вес не списан сверх 1); kind не из hit, run, level или повторён; side, state, source не из словаря; min_score больше 1000; limit = 0 (больше 50 000 — не отказ, а 50 000); min_usd не десятичная запись до 10 цифр целой части и 8 после точки; format=csv; источник отверг запрос (upstream_rejected)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области clusters, группа trades не в тарифе или from глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или телом не той формы; у узла нет таблицы событий ленты (миграция 025)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/tape/profile": {
      "get": {
        "tags": [
          "market"
        ],
        "summary": "Профиль ленты: последний снимок метрики символа.",
        "description": "Квантили `p50`, `p90`, `p99`, `p99_5` и число замеров — то, по чему событиям дана сила\n`score`; для легенды «типичный удар — столько, этот — выше p99». Значения — в одном из\n`values_e8` (деньги, e8 USD строкой), `values_bp`, `values_ms` по `unit`. Тело источника — как\nесть, мимо кэша шлюза (`no-store`, без метки).",
        "operationId": "tape_profile",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/trades",
          "description": "Сделки"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "metric",
            "in": "query",
            "description": "Метрика профиля: `hit_usd`, `run_usd`, `level_usd` (деньги удара, серии, уровня, e8 USD),\n`run_move_bp` (ход серии, б. п.), `hit_gap_ms`, `trade_gap_ms` (промежутки между ударами и\nсделками, мс). Форма — 1–32 знака из a-z, 0-9, `_`; незнакомую отвергает источник.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "hit_usd"
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию) — тело источника как есть, `protobuf` (`lootx.v1.Response`: поля верхнего уровня — мета, вложенное — JSON-текстом). CSV нет: ответ — не таблица. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Квантили метрики по последнему снимку (схема TapeProfileResponse): exchange, market_type, symbol, metric, unit (usd_e8 | bp | ms), units_revision, samples, ts_ms, quantiles (p50, p90, p99, p99_5) и ровно одно из values_e8 (e8 USD строкой), values_bp (б. п.), values_ms (мс) по unit. Снимка нет — тоже 200: samples = 0, ts_ms = null, значения null. Cache-Control: no-store, ETag нет",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TapeProfileResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              }
            }
          },
          "400": {
            "description": "Параметра нет у маршрута или он повторён; нет instrument или metric; два и больше инструментов; metric не 1–32 знака из a-z, 0-9, _; format=csv; источник отверг запрос (upstream_rejected)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области clusters или группа trades не в тарифе",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен, ответил ошибкой или телом не той формы (не объект; значения не ровно в одном values_* по unit или не по одному на квантиль; деньги values_e8 числом); у узла нет таблицы профилей ленты (миграция 026)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          },
          "504": {
            "description": "Источник не ответил вовремя",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/trades": {
      "get": {
        "tags": [
          "market"
        ],
        "summary": "Ленты сделок от порога. Источник — clusters `/v1/trades/range?format=json`\n(trade_history.rs:311; формат проверен по коду и живому ответу,\ntests/fixtures/real/clusters_trades*.json): колонки; цена и количество целыми в\n`price_scale`/`qty_scale`, `quote_qty` — в фиксированной денежной шкале 1e-4 $.",
        "description": "Продолжение у источника — `next_from_ms` = время ПОСЛЕДНЕЙ отданной сделки: сделки этой\nмиллисекунды пришли бы второй раз. Шлюз отрезает их со страницы и продолжает с этой\nмиллисекунды — без повторов. Если вся страница — одна миллисекунда, продолжение со\nследующей (иначе листание встало бы на месте).",
        "operationId": "trades",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/trades",
          "description": "Сделки"
        },
        "parameters": [
          {
            "name": "instrument",
            "in": "query",
            "description": "Обязателен.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "binance:perp:BTCUSDT"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Начало, Unix-мс, включительно. По умолчанию — час назад от `to`.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Конец, Unix-мс, не включительно.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Сделок на страницу, 1..50000, по умолчанию 10000.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "min_usd",
            "in": "query",
            "description": "Порог сделки в $ (цена × количество), включительно: `min_usd=5000` — только от $5000.",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "source",
            "in": "query",
            "description": "Слой хранения: `auto` (по умолчанию: свежие дни — горячий, старше — архив), `hot`\n(все сделки от порога записи символа, последние дни), `archive` (только от $5000,\nбессрочно).",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Сделки колонками: t, price, qty (монеты), quote_qty ($), side (buy — агрессор покупал, sell — продавал), aggregated, fills, trade_id, seq. НЕ все сделки: только от порога хранения (см. source_min_usd)",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TradesResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "description": "Неверные параметры",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "bad_request",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                    "expected": "целое число",
                    "message": "параметр limit: invalid digit found in string",
                    "param": "limit",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Нет области, группа не в тарифе, глубже тарифа",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "502": {
            "description": "Источник недоступен",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/usage": {
      "get": {
        "tags": [
          "reference"
        ],
        "description": "Тариф ключа и живое состояние лимитов: окна аккаунта (минута — ведро с пополнением, час, сутки, байты суток) и групп маршрутов с собственным лимитом, отказы по лимиту за сутки и последний из них. Сам запрос списывается из общих окон аккаунта, как любой другой: минута, час и сутки — до ответа (показанное состояние его уже учитывает), байты суток — по отданному телу после ответа; в окна групп маршрутов он не идёт. Счётчики лимитов недоступны — `503 usage_unavailable` с `Retry-After`, а не пустые окна.",
        "operationId": "usage",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/limits",
          "description": "Лимиты и заголовки"
        },
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Тариф и состояние лимитов",
            "headers": {
              "Link": {
                "schema": {
                  "type": "string"
                },
                "description": "Следующая страница (RFC 8288), если она есть: `<https://market-api.lootx.trade/v1/…&cursor=…>; rel=\"next\"`; курсор — и в `X-Next-Cursor`"
              },
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-Cache": {
                "schema": {
                  "type": "string"
                },
                "description": "`HIT` | `MISS` у кэшируемых ответов (закрытые диапазоны истории)"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UsageResponse"
                }
              },
              "application/x-protobuf": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "description": "lootx.v1.Response — тот же ответ по колонкам; схема — GET /v1/proto"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "description": "CSV по RFC 4180: заголовок — колонки; курсор — в заголовке X-Next-Cursor"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/ws": {
      "get": {
        "tags": [
          "streams"
        ],
        "description": "Единый протокол потоков (https://docs.lootx.trade/ru/market-api/websocket). Команды: `{\"op\":\"subscribe\",\"id\":1,\"channel\":\"densities\",\"instruments\":[\"binance:perp:BTCUSDT\"]}`, `unsubscribe`, `ping`. Весь рынок с фильтрами (densities, screener): `{\"op\":\"subscribe\",\"id\":2,\"channel\":\"densities\",\"scope\":\"market\",\"params\":{\"venues\":[\"binance\"],\"markets\":[\"perp\"],\"min_usd\":250000}}` — одна на канал в соединении, повтор заменяет; потолок аккаунта `ws_market_subs` (`market_subs_limit`), шлюза — `channel_unavailable`. Кадры: `subscribed`, `snapshot`, `update`, `removed`, `status`, `error`, `pong` — JSON, имена `venue:market:SYMBOL`, время Unix-мс; у рыночной подписки — `scope: market` и `items`. Байты кадров входят в суточный объём аккаунта вместе с REST: кончился — `error` `daily_quota_exceeded` и закрытие 1008. Каналы: densities, screener, trades, oi, candles (liquidations — `channel_unavailable`: к единому протоколу лента ещё не подключена; живые ликвидации — отдельный поток `/v1/liquidations/stream`).",
        "operationId": "unified",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/websocket",
          "description": "Потоки WebSocket"
        },
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "description": "Формат ответа: `json` (по умолчанию), `protobuf` (`lootx.v1.Response`, схема — `GET /v1/proto`), `csv` (одна таблица). Главнее заголовка `Accept`. Ошибки — всегда JSON.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "protobuf",
                "csv"
              ]
            }
          },
          {
            "name": "table",
            "in": "query",
            "description": "Только для `format=csv`, если таблиц в ответе несколько (`/v1/footprint`, `/v1/hyperliquid/footprint`: `levels`, `windows`; сумма `/v1/heatmap`: без `table` — ячейки, `presence` — маска и курс по кадрам).",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "101": {
            "description": "Соединение установлено",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Группа ws закрыта тарифом",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    },
    "/v1/ws/{stream}": {
      "get": {
        "tags": [
          "streams"
        ],
        "operationId": "stream",
        "externalDocs": {
          "url": "https://docs.lootx.trade/ru/market-api/websocket",
          "description": "Потоки WebSocket"
        },
        "parameters": [
          {
            "name": "stream",
            "in": "path",
            "description": "densities или screener",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "101": {
            "description": "Соединение установлено; кадры — в протоколе источника (сырой бета-режим; новый код — /v1/ws)",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Группа ws или группа источника (densities, screener) закрыта тарифом",
            "headers": {
              "RateLimit": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
              },
              "RateLimit-Policy": {
                "schema": {
                  "type": "string"
                },
                "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer"
                },
                "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer"
                },
                "description": "Остаток самого тесного окна"
              },
              "X-RateLimit-Reset": {
                "schema": {
                  "type": "integer"
                },
                "description": "Сброс самого тесного окна, Unix-секунды"
              },
              "X-RateLimit-Scope": {
                "schema": {
                  "type": "string"
                },
                "description": "Чьё окно: `account` или `route:<группа>`"
              },
              "X-RateLimit-Window": {
                "schema": {
                  "type": "string"
                },
                "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
              },
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                },
                "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                },
                "example": {
                  "error": {
                    "code": "route_not_in_plan",
                    "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                    "message": "группа heatmap не входит в тариф basic",
                    "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                    "scope": "route:heatmap"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "x_api_key": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "BandsResponse": {
        "type": "object",
        "required": [
          "instrument",
          "tf",
          "columns",
          "rows",
          "bands_bp",
          "units_revision",
          "source"
        ],
        "properties": {
          "asof_ms": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "До какого момента склад источника полон; окна до него не изменятся."
          },
          "bands_bp": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            },
            "description": "Границы полос, б.п. от mid, по порядку колонок: без `bands` — 7, у `bands=deep` — 11\n(`[10, 25, 50, 100, 200, 300, 500, 800, 1000, 1500, 10000]`, `10000` — вся сторона).",
            "example": [
              10,
              25,
              50,
              100,
              200,
              500,
              1000
            ]
          },
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "ts (начало окна, мс), sample_ms (момент среза, который представляет окно), best_bid,\nbest_ask (цены среза), mid (цена), `bid_bp{10…1000}_e8` и `ask_bp{10…1000}_e8` —\nнарастающие полосы в e8 USD строкой (`bp10` — ±0,1 % от mid, `bp1000` — ±10 %),\nreach_bid_bp, reach_ask_bp (самая широкая полоса, все цены которой книга знала),\ncomplete_bid, complete_ask (сколько первых полос полны: полоса k полная ⇔ k < complete),\nclosed (окно закрыто и больше не изменится). У `bands=deep` — 32 колонки: полосы\n`bid_bp{10,25,50,100,200,300,500,800,1000,1500,10000}_e8` и те же `ask_…` (`bp10000` — вся\nсторона), e8 строкой или `null` — «неизвестно» (строки до миграции 021), а не 0;\n`complete_*` — до 11, номер полосы — по `bands_bp`.",
            "example": [
              "ts",
              "sample_ms",
              "best_bid",
              "best_ask",
              "mid",
              "bid_bp10_e8",
              "bid_bp25_e8",
              "bid_bp50_e8",
              "bid_bp100_e8",
              "bid_bp200_e8",
              "bid_bp500_e8",
              "bid_bp1000_e8",
              "ask_bp10_e8",
              "ask_bp25_e8",
              "ask_bp50_e8",
              "ask_bp100_e8",
              "ask_bp200_e8",
              "ask_bp500_e8",
              "ask_bp1000_e8",
              "reach_bid_bp",
              "reach_ask_bp",
              "complete_bid",
              "complete_ask",
              "closed"
            ]
          },
          "instrument": {
            "type": "string",
            "example": "binance:perp:BTCUSDT"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Всегда `null`: окно больше потолка — 413, а не страницы."
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            },
            "description": "Строки; окно без среза — строки нет (дыра, не нули).",
            "example": [
              [
                1791331200000,
                1791331259900,
                62000.5,
                62000.6,
                62000.55,
                "51234500000000",
                "98765400000000",
                "150000000000000",
                "310000000000000",
                "640000000000000",
                "1500000000000000",
                "2900000000000000",
                "48765400000000",
                "91234500000000",
                "140000000000000",
                "300000000000000",
                "620000000000000",
                "1450000000000000",
                "2800000000000000",
                1000,
                1000,
                7,
                7,
                true
              ]
            ]
          },
          "source": {
            "type": "string",
            "description": "Таблица источника: `book_bands_1s` (секунды) или `book_bands_1m` (минуты).",
            "example": "book_bands_1m"
          },
          "tf": {
            "type": "string",
            "example": "1m"
          },
          "units_revision": {
            "type": "integer",
            "format": "int32",
            "description": "Ревизия единиц источника (сейчас 1: e8 USD).",
            "example": 1,
            "minimum": 0
          }
        }
      },
      "Coverage": {
        "type": "object",
        "properties": {
          "newest": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Самая поздняя, мс."
          },
          "oldest": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Самая ранняя свеча, которая есть в хранилище, мс."
          }
        }
      },
      "DeltaResponse": {
        "type": "object",
        "required": [
          "instrument",
          "tf",
          "columns",
          "rows"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "t",
              "buy",
              "sell",
              "delta",
              "delta_min",
              "delta_max",
              "trades",
              "buy_quote",
              "sell_quote",
              "delta_quote",
              "delta_quote_min",
              "delta_quote_max",
              "close",
              "closed"
            ]
          },
          "instrument": {
            "type": "string"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            }
          },
          "tf": {
            "type": "string"
          }
        }
      },
      "Error": {
        "$ref": "#/components/schemas/ErrorBody"
      },
      "ErrorBody": {
        "type": "object",
        "description": "Тело ошибки — для OpenAPI и для тех, кто разбирает ответ.",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/components/schemas/ErrorDetail"
          }
        },
        "example": {
          "error": {
            "code": "rate_limited",
            "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#rate_limited",
            "limit": 600,
            "message": "лимит 600 запросов в минуту исчерпан",
            "remaining": 0,
            "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
            "reset_at_ms": 1762257612000,
            "retry_after": 1,
            "scope": "account",
            "window": "minute"
          }
        }
      },
      "ErrorDetail": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ErrorExtra"
          },
          {
            "type": "object",
            "required": [
              "code",
              "message",
              "request_id",
              "docs_url"
            ],
            "properties": {
              "code": {
                "type": "string",
                "description": "Машинный код, snake_case, стабильный. Список — в описании API и в `enum` здесь.",
                "enum": [
                  "bad_request",
                  "bad_instrument",
                  "unsupported_instrument",
                  "bad_cursor",
                  "bad_format",
                  "key_in_query",
                  "missing_key",
                  "invalid_key",
                  "invalid_token",
                  "token_expired",
                  "revoked_key",
                  "plan_inactive",
                  "insufficient_scope",
                  "history_out_of_plan",
                  "route_not_in_plan",
                  "invalid_secret",
                  "forbidden",
                  "not_found",
                  "not_available",
                  "method_not_allowed",
                  "not_acceptable",
                  "request_timeout",
                  "payload_too_large",
                  "too_large",
                  "rate_limited",
                  "hourly_limit",
                  "daily_limit",
                  "daily_quota_exceeded",
                  "ws_limit",
                  "upstream_rejected",
                  "upstream_error",
                  "upstream_unavailable",
                  "upstream_timeout",
                  "upstream_busy",
                  "upstream_not_configured",
                  "auth_unavailable",
                  "usage_unavailable",
                  "unavailable",
                  "internal",
                  "bad_params",
                  "market_subs_limit",
                  "unknown_channel",
                  "channel_unavailable",
                  "too_many_instruments",
                  "too_many_subscriptions",
                  "slow_consumer"
                ],
                "example": "rate_limited"
              },
              "docs_url": {
                "type": "string",
                "description": "Страница кода ошибки: что значит и что делать.",
                "example": "https://docs.lootx.trade/ru/market-api/error-codes#rate_limited"
              },
              "message": {
                "type": "string",
                "description": "Человекочитаемое объяснение. Может меняться — не разбирайте его.",
                "example": "лимит 600 запросов в минуту исчерпан"
              },
              "request_id": {
                "type": "string",
                "description": "Тот же идентификатор, что в заголовке `X-Request-Id`. Пришлите его в поддержку.",
                "example": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
              }
            }
          }
        ]
      },
      "ErrorExtra": {
        "type": "object",
        "description": "Детали ошибки. Поле есть, только когда оно к месту: валидация — `param`/`expected`; лимит\n(429 и лимитные 403) — `limit`/`remaining`/`window`/`scope`/`retry_after`/`reset_at_ms`;\nглубина истории — `history_days`/`earliest_allowed_ms`; 405 — `allow`.",
        "properties": {
          "allow": {
            "type": [
              "string",
              "null"
            ],
            "description": "Разрешённые методы — у `method_not_allowed`, как заголовок `Allow`."
          },
          "earliest_allowed_ms": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Самый ранний разрешённый `from` (Unix-мс UTC)."
          },
          "expected": {
            "type": [
              "string",
              "null"
            ],
            "description": "Что ожидалось в этом параметре.",
            "example": "целое: Unix-миллисекунды UTC"
          },
          "history_days": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Глубина истории тарифа (с учётом группы), суток.",
            "minimum": 0
          },
          "limit": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Потолок окна, упёршегося в лимит (для `bytes_day` — байты).",
            "minimum": 0
          },
          "param": {
            "type": [
              "string",
              "null"
            ],
            "description": "Какой параметр запроса не так (`from`, `instrument`, `format`, …).",
            "example": "from"
          },
          "remaining": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "minimum": 0
          },
          "reset_at_ms": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Когда окно сбросится (Unix-мс UTC)."
          },
          "retry_after": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Через сколько секунд повторить — то же, что заголовок `Retry-After`.",
            "minimum": 0
          },
          "scope": {
            "type": [
              "string",
              "null"
            ],
            "description": "`account` | `route:<группа>`; у потоков ещё `connection`; `ip` — предохранитель nginx\nпо адресу клиента до проверки ключа (`429 rate_limited`, `window: second`).",
            "example": "account"
          },
          "window": {
            "type": [
              "string",
              "null"
            ],
            "description": "`minute` | `hour` | `day` | `bytes_day`; у потоков ещё `second` (команды) и\n`concurrent` (соединения); у предохранителя nginx по адресу (`scope: ip`) — `second`.",
            "example": "minute"
          }
        }
      },
      "EventsResponse": {
        "type": "object",
        "required": [
          "instrument",
          "columns",
          "rows"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "t",
              "rate",
              "mark_price"
            ]
          },
          "instrument": {
            "type": "string"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            }
          }
        }
      },
      "FootprintResponse": {
        "type": "object",
        "required": [
          "instrument",
          "tf",
          "levels",
          "windows"
        ],
        "properties": {
          "fx": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/SumFx"
            },
            "description": "Только у суммы: слагаемые с котировкой не USDT — их цены переведены в USDT по курсу окна."
          },
          "fx_source": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Только у суммы: рынки курса по порядку (`COINBASE:spot:USDTUSD`, запас\n`KRAKEN:spot:USDTUSD`; USDC — `BINANCE:spot:USDCUSDT`)."
          },
          "instrument": {
            "type": "string",
            "description": "Инструмент; у суммы — набор через запятую в порядке бит `venues_mask`."
          },
          "instruments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Только у суммы площадок (`instruments=`): набор по порядку бит `venues_mask`."
          },
          "instruments_present": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Только у суммы: площадки, которые есть хоть в одном окне страницы."
          },
          "levels": {
            "$ref": "#/components/schemas/Rows",
            "description": "Уровни цены по окнам: ts (начало окна), price, bid_qty, ask_qty, trades, trades_buy,\ntrades_sell. У суммы — общая сетка в USDT: `price` — нижняя граница корзины шага\n`price_step`. `trades_buy` / `trades_sell` — сколько из `trades` сделок купил / продал\nагрессор (стороны `bid_qty` / `ask_qty`); `null` у обеих — разбивки нет (история до\nзаписи сторон, окно 5m…1d с такой минутой, у суммы — слагаемое без разбивки), а не «ни\nодной покупки». Известна — `trades_buy + trades_sell == trades`. Колонки — в конце строки:\nпервые пять на прежних местах."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "price_anchor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Только у суммы: чья цена в open/high/low/close окна (первый инструмент запроса), в USDT."
          },
          "price_step": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "description": "Только у суммы: шаг общей сетки цены, в единицах цены."
          },
          "tf": {
            "type": "string"
          },
          "windows": {
            "$ref": "#/components/schemas/Rows",
            "description": "Окна: ts, open, high, low, close, closed (окно закрыто и больше не изменится). У суммы\nещё `complete` (все площадки есть), `venues_present`, `venues_mask` (бит i —\n`instruments[i]` есть в окне; нет — «нет данных», а не ноль) и курс по колонке\n`fx:<инструмент>` на слагаемое из `fx` (null — курса нет, слагаемого в окне нет)."
          }
        }
      },
      "HeatmapResponse": {
        "type": "object",
        "required": [
          "instrument",
          "from",
          "to",
          "time_step_ms",
          "price_step",
          "agg",
          "frames",
          "columns",
          "rows"
        ],
        "properties": {
          "agg": {
            "type": "string",
            "description": "`avg` или `max`."
          },
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "t",
              "side",
              "price",
              "qty"
            ]
          },
          "frames": {
            "type": "integer",
            "format": "int32",
            "description": "Колонок времени (кадров) в ответе.",
            "minimum": 0
          },
          "from": {
            "type": "integer",
            "format": "int64",
            "description": "Начало первой колонки, мс (окно выравнивается наружу по шагу)."
          },
          "fx": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/SumFx"
            },
            "description": "Только у суммы: слагаемые с котировкой не USDT — их цены переведены в USDT по курсу."
          },
          "fx_source": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Только у суммы: рынки курса по порядку (`COINBASE:spot:USDTUSD`, запас\n`KRAKEN:spot:USDTUSD`; USDC — `BINANCE:spot:USDCUSDT`)."
          },
          "instrument": {
            "type": "string",
            "description": "Инструмент; у суммы — набор через запятую в порядке бит `venues_mask`."
          },
          "instruments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Только у суммы площадок (`instruments=`): набор по порядку бит `venues_mask`."
          },
          "instruments_present": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Только у суммы: площадки, которые есть хоть в одном кадре."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Источник упёрся в потолок тела и обрезал ответ справа — продолжение отсюда."
          },
          "presence": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/Rows",
                "description": "Только у суммы: присутствие и курс по кадрам — строка на кадр: `t`, `venues_present`,\n`venues_mask` (бит i — у `instruments[i]` есть снимок в колонке; нет — «нет данных», а не\nноль), затем по колонке `fx:<инструмент>` на слагаемое из `fx` — курс кадра (null — курса\nнет, слагаемого в кадре нет)."
              }
            ]
          },
          "price_anchor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Только у суммы: чьи лучшие цены у кадра (первый инструмент запроса)."
          },
          "price_from": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "description": "Ценовое окно из запроса; null — ±20 % от середины книги."
          },
          "price_step": {
            "type": "number",
            "format": "double",
            "description": "Высота ячейки в единицах цены: ячейка `price` — это `[price, price + price_step)`."
          },
          "price_to": {
            "type": [
              "number",
              "null"
            ],
            "format": "double"
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            },
            "description": "Только ненулевые ячейки: t (начало колонки, мс), side (`bid`/`ask`), price (нижняя\nграница ячейки), qty (объём в монетах — средний или максимальный за колонку).",
            "example": [
              [
                1791331200000,
                "bid",
                77414.4,
                58.863
              ]
            ]
          },
          "time_step_ms": {
            "type": "integer",
            "format": "int32",
            "description": "Шаг колонки, мс.",
            "minimum": 0
          },
          "to": {
            "type": "integer",
            "format": "int64",
            "description": "Конец последней колонки, мс, не включительно."
          }
        }
      },
      "HlCoverageResponse": {
        "type": "object",
        "description": "Покрытие книги позиций по монете.",
        "required": [
          "instrument",
          "ts",
          "fresh",
          "source",
          "coverage"
        ],
        "properties": {
          "coverage": {
            "type": "object"
          },
          "fresh": {
            "type": "boolean"
          },
          "instrument": {
            "type": "string",
            "example": "hyperliquid:perp:BTC"
          },
          "source": {},
          "ts": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "HlFootprintResponse": {
        "type": "object",
        "required": [
          "instrument",
          "tf",
          "levels",
          "windows"
        ],
        "properties": {
          "asof_ms": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "До какого момента таблица источника записана полными минутами."
          },
          "instrument": {
            "type": "string",
            "description": "Каноническое имя по монете источника, а не написание запроса: `aapl.xyz` →\n`hyperliquid:perp:AAPLUSDC.XYZ`, `BTCUSDC` → `hyperliquid:perp:BTC`.",
            "example": "hyperliquid:perp:BTC"
          },
          "levels": {
            "$ref": "#/components/schemas/Rows",
            "description": "Уровни цены по окнам: ts (начало окна), price, dl_taker, ds_taker, dl_maker, ds_maker\n(изменение лонгов и шортов в монетах: + открыли, − закрыли), n_fills (заливок — половин\nматча — на уровне)."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "tf": {
            "type": "string",
            "example": "1m"
          },
          "windows": {
            "$ref": "#/components/schemas/Rows",
            "description": "Окна: ts, closed (окно закрыто и больше не изменится)."
          }
        }
      },
      "HlJournalResponse": {
        "type": "object",
        "description": "Журнал китов: открытия, наращивания, сокращения и закрытия крупных позиций.",
        "required": [
          "ts",
          "source",
          "threshold_usd",
          "threshold_usd_e8",
          "min_fill_usd",
          "min_fill_usd_e8",
          "columns",
          "rows"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "ts",
              "instrument",
              "user",
              "action",
              "size_before",
              "size_after",
              "px",
              "notional_e8",
              "fee_e8",
              "fee_token",
              "closed_pnl_e8",
              "tid",
              "block"
            ]
          },
          "instrument": {
            "type": [
              "string",
              "null"
            ],
            "description": "Инструмент запроса; `null` — весь рынок."
          },
          "min_fill_usd": {
            "type": "number",
            "format": "double",
            "description": "`increased` и `reduced` — только от этой суммы сделки, USD (число из `min_fill_usd_e8`);\nпрочие действия — всегда."
          },
          "min_fill_usd_e8": {
            "type": "string",
            "description": "Порог сделки журнала точно: USD × 10⁸ строкой.",
            "example": "10000000000000"
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            }
          },
          "source": {},
          "threshold_usd": {
            "type": "number",
            "format": "double",
            "description": "Порог кита, USD (число из `threshold_usd_e8`)."
          },
          "threshold_usd_e8": {
            "type": "string",
            "description": "Порог кита точно: USD × 10⁸ строкой.",
            "example": "100000000000000"
          },
          "ts": {
            "type": "integer",
            "format": "int64",
            "description": "Время ответа, Unix-мс (журнал живой, не по минутам)."
          }
        }
      },
      "HlLongShortResponse": {
        "type": "object",
        "description": "Long/short по монетам за последнюю минуту книги.",
        "required": [
          "ts",
          "fresh",
          "source",
          "columns",
          "rows"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "instrument",
              "long_accounts",
              "short_accounts",
              "long_e8",
              "short_e8",
              "collateral",
              "long_usd_e8",
              "short_usd_e8"
            ]
          },
          "fresh": {
            "type": "boolean",
            "description": "По свидетелю — покрытию монеты запроса (всего рынка — BTC)."
          },
          "instrument": {
            "type": [
              "string",
              "null"
            ],
            "description": "Инструмент запроса; `null` — все монеты."
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            }
          },
          "source": {},
          "ts": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "HlMapResponse": {
        "type": "object",
        "description": "Карта ликвидаций по цене за последнюю минуту книги.",
        "required": [
          "instrument",
          "ts",
          "fresh",
          "source",
          "mark",
          "price_step",
          "range_pct",
          "coverage",
          "columns",
          "rows"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "price",
              "long_usd",
              "short_usd",
              "long_count",
              "short_count",
              "long_isolated_usd",
              "short_isolated_usd",
              "long_usd_e8",
              "short_usd_e8",
              "long_isolated_usd_e8",
              "short_isolated_usd_e8"
            ]
          },
          "coverage": {
            "type": "object",
            "description": "Покрытие книги: доли, счётчики, суммы `*_usd_e8` и прежние `*_e8` (строкой, USD × 10⁸ —\nодно число) и `*_usd` (число из того же целого)."
          },
          "fresh": {
            "type": "boolean",
            "description": "`false` — источник считает минуту несвежей (`coverage.fresh`) или ей больше 3 минут."
          },
          "instrument": {
            "type": "string",
            "example": "hyperliquid:perp:BTC"
          },
          "mark": {
            "type": "number",
            "format": "double",
            "description": "Цена mark минуты."
          },
          "price_step": {
            "type": "number",
            "format": "double",
            "description": "Высота уровня цены."
          },
          "range_pct": {
            "type": "number",
            "format": "double",
            "description": "Окно цены от mark, %."
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            }
          },
          "source": {
            "description": "`node_snapshot` — книга из снимка узла Hyperliquid и сделок после него."
          },
          "ts": {
            "type": "integer",
            "format": "int64",
            "description": "Минута книги, Unix-мс."
          }
        }
      },
      "HlTopResponse": {
        "type": "object",
        "description": "Крупнейшие позиции монеты за последнюю минуту книги.",
        "required": [
          "instrument",
          "ts",
          "fresh",
          "source",
          "mark",
          "coverage",
          "columns",
          "rows"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "user",
              "side",
              "size",
              "notional_usd",
              "entry_px",
              "liquidation_px",
              "distance_pct",
              "leverage",
              "margin",
              "polled_ms",
              "notional_usd_e8"
            ]
          },
          "coverage": {
            "type": "object"
          },
          "fresh": {
            "type": "boolean"
          },
          "instrument": {
            "type": "string",
            "example": "hyperliquid:perp:BTC"
          },
          "mark": {
            "type": "number",
            "format": "double"
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            }
          },
          "source": {},
          "ts": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "HlTriggersResponse": {
        "type": "object",
        "description": "Книга TP/SL монеты сейчас: по ячейкам сетки цены — размер, сумма и число ордеров по видам.",
        "required": [
          "instrument",
          "ts",
          "fresh",
          "source",
          "mark",
          "price_step",
          "range_pct",
          "coverage",
          "columns",
          "rows"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "price",
              "tp_long_size",
              "tp_short_size",
              "sl_long_size",
              "sl_short_size",
              "tp_long_usd",
              "tp_short_usd",
              "sl_long_usd",
              "sl_short_usd",
              "tp_long_count",
              "tp_short_count",
              "sl_long_count",
              "sl_short_count",
              "tp_long_usd_e8",
              "tp_short_usd_e8",
              "sl_long_usd_e8",
              "sl_short_usd_e8"
            ]
          },
          "coverage": {
            "type": "object",
            "description": "Покрытие книги: свежесть (`fresh`, `positions_fresh`, `base_age_ms`, `statuses_lag_ms`,\n`gap_until`), счётчики (`orders` = `mapped` + `out_of_range` + `unknown_size`; `entries`,\n`entries_as_close`, `unclassified`, `waiting`, `stale`), по видам — `count`,\n`notional_usd_e8` и прежнее `notional_e8` (строкой, USD × 10⁸ — одно число), `notional_usd`\n(число из него же)."
          },
          "fresh": {
            "type": "boolean",
            "description": "`false` — книга несвежая у источника (`fresh` или `coverage.fresh`) или ответу больше 3\nминут. Несвежую книгу источник шлёт без строк («неизвестно», а не «ордеров нет»); книге\nстарше 3 минут шлюз ставит `false`, а строки отдаёт как есть. Свежая книга без строк —\nTP/SL у монеты нет."
          },
          "instrument": {
            "type": "string",
            "example": "hyperliquid:perp:BTC"
          },
          "mark": {
            "type": "number",
            "format": "double",
            "description": "Цена mark."
          },
          "price_step": {
            "type": "number",
            "format": "double",
            "description": "Высота ячейки цены (сетка карты ликвидаций)."
          },
          "range_pct": {
            "type": "number",
            "format": "double",
            "description": "Окно цены от mark, %: ордера дальше — в `coverage.out_of_range`."
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            }
          },
          "source": {
            "description": "`node_snapshot` — книга из снимка узла Hyperliquid и статусов ордеров после него."
          },
          "ts": {
            "type": "integer",
            "format": "int64",
            "description": "Момент подсчёта книги, Unix-мс: книга живая, источник считает её на каждый запрос."
          }
        }
      },
      "HlWhalesResponse": {
        "type": "object",
        "description": "Киты монеты: позиции от `threshold_usd`.",
        "required": [
          "instrument",
          "ts",
          "fresh",
          "source",
          "mark",
          "threshold_usd",
          "threshold_usd_e8",
          "collateral",
          "columns",
          "rows"
        ],
        "properties": {
          "collateral": {
            "type": "string",
            "description": "Залог дека монеты (`USDC`, у некоторых деков HIP-3 — свой)."
          },
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "fresh": {
            "type": "boolean",
            "description": "По свидетелю — покрытию той же монеты."
          },
          "instrument": {
            "type": "string",
            "example": "hyperliquid:perp:AAPLUSDC.XYZ"
          },
          "mark": {
            "type": "number",
            "format": "double"
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            }
          },
          "source": {},
          "threshold_usd": {
            "type": "number",
            "format": "double",
            "description": "Порог кита, USD (число из `threshold_usd_e8`)."
          },
          "threshold_usd_e8": {
            "type": "string",
            "description": "Порог кита точно: USD × 10⁸ строкой.",
            "example": "100000000000000"
          },
          "ts": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "InstrumentsResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Rows",
            "description": "Колонки: instrument, venue, market, symbol, sources (массив маршрутов)."
          },
          {
            "type": "object",
            "required": [
              "updated_at"
            ],
            "properties": {
              "updated_at": {
                "type": "integer",
                "format": "int64",
                "description": "Последняя успешная загрузка списка хоть из одного источника, Unix-мс; 0 — ни одной."
              }
            }
          }
        ]
      },
      "KeyLimits": {
        "type": "object",
        "description": "Лимиты ключа, как их отдаёт облако. Все — на АККАУНТ (все ключи человека вместе);\n0 — без ограничения. `rph`/`rpd` появились в договоре «API-тарифы» (docs/CONTRACTS.md) и\nнеобязательны: старое облако их не шлёт, и шлюз ведёт себя как раньше.",
        "properties": {
          "burst": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "daily_bytes": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "datasets": {
            "type": "boolean"
          },
          "history_days": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "rpd": {
            "type": "integer",
            "format": "int64",
            "description": "Запросов в сутки UTC (фиксированное окно).",
            "minimum": 0
          },
          "rph": {
            "type": "integer",
            "format": "int64",
            "description": "Запросов в час UTC (фиксированное окно).",
            "minimum": 0
          },
          "rpm": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "ws_conns": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "ws_market_subs": {
            "type": "integer",
            "format": "int32",
            "description": "Рыночных подписок `/v1/ws` (`scope: market`, канал целиком с фильтрами) на аккаунт\nодновременно. 0 (или поля нет — старое облако) — значение шлюза\n`streams.market_subs_per_account`. На проводе — только когда задан: форма лимитов\nбез него остаётся той же (фикстура договора с облаком).",
            "minimum": 0
          }
        }
      },
      "LastLimited": {
        "type": "object",
        "description": "Последний отказ по лимиту за сутки UTC.",
        "required": [
          "at_ms",
          "code"
        ],
        "properties": {
          "at_ms": {
            "type": "integer",
            "format": "int64"
          },
          "code": {
            "type": "string",
            "example": "rate_limited"
          },
          "scope": {
            "type": [
              "string",
              "null"
            ]
          },
          "window": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "LiqBarsResponse": {
        "type": "object",
        "required": [
          "instrument",
          "tf",
          "from",
          "to",
          "columns",
          "rows",
          "gaps"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "t (начало бара, мс), long_qty, short_qty (монеты), long_notional_e8, short_notional_e8\n(USD × 10⁸ строкой — точная сумма), count_long, count_short, unknown_count,\nunknown_notional_e8 (события без стороны — Lighter), completeness_min (худшая полнота\nсобытий бара). Бары — только там, где были события: бара нет и дыры нет — ноль.",
            "example": [
              "t",
              "long_qty",
              "short_qty",
              "long_notional_e8",
              "short_notional_e8",
              "count_long",
              "count_short",
              "unknown_count",
              "unknown_notional_e8",
              "completeness_min"
            ]
          },
          "completeness": {
            "type": [
              "string",
              "null"
            ],
            "description": "Полнота ленты площадки: `full`, `sampled`, `none`."
          },
          "from": {
            "type": "integer",
            "format": "int64",
            "description": "Окно страницы, Unix-мс: `[from, to)`, `from` — по сетке бара."
          },
          "gaps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LiqGap"
            },
            "description": "Дыры ленты в окне: бар под дырой — «не знаем», рисовать пропуском, а не нулём."
          },
          "instrument": {
            "type": "string",
            "description": "Каноническое имя: у Hyperliquid — по монете, как в кадре `/v1/liquidations/stream`\n(`hyperliquid:perp:amzn.xyz` → `hyperliquid:perp:AMZNUSDC.XYZ`, `BTCUSDC` → `BTC`); у\nпрочих площадок — как в запросе.",
            "example": "binance:perp:BTCUSDT"
          },
          "instruments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Только у суммы площадок (`instruments=`): набор по порядку бит `venues_mask`."
          },
          "instruments_present": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Только у суммы: площадки, чья лента слушала хоть один бар страницы."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            }
          },
          "tf": {
            "type": "string",
            "example": "5m"
          },
          "to": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "LiqCoverageResponse": {
        "type": "object",
        "required": [
          "feed_stale_ms",
          "columns",
          "rows"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "venue, market (`perp`), supported (есть ли у площадки лента в data вообще), feed (лента\nработает: писатель отметился недавно), connected (все сокеты ленты подключены на момент\nотметки), feed_seen_ms (последняя отметка, мс, или null), completeness (`full` /\n`sampled`; `none` — ленты сейчас нет), last_event_ms (время биржи последнего события),\nlast_gap (последняя дыра `{from_ms, to_ms, reason}` или null).",
            "example": [
              "venue",
              "market",
              "supported",
              "feed",
              "connected",
              "feed_seen_ms",
              "completeness",
              "last_event_ms",
              "last_gap"
            ]
          },
          "feed_stale_ms": {
            "description": "Отметка ленты старше этого — ленты нет (`feed: false`), мс."
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            },
            "example": [
              [
                "bybit",
                "perp",
                true,
                true,
                true,
                1794500411137,
                "full",
                1794500458713,
                null
              ],
              [
                "hyperliquid",
                "perp",
                true,
                true,
                true,
                1794500411900,
                "full",
                1794500457020,
                null
              ],
              [
                "mexc",
                "perp",
                false,
                false,
                false,
                null,
                "none",
                null,
                null
              ]
            ]
          }
        }
      },
      "LiqEventsResponse": {
        "type": "object",
        "required": [
          "instrument",
          "from",
          "to",
          "columns",
          "rows",
          "gaps"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "t (время биржи, мс), t_recv (время приёма, мс), side (`long`/`short`/`unknown` —\nсторона ликвидированной позиции), price (строкой, как у биржи), price_kind\n(`execution`/`bankruptcy`/`order`/`unknown`), qty (монеты), qty_native (строкой, в\nединицах биржи), notional_e8 (USD × 10⁸ строкой — точное целое), completeness, flags\n(биты: 1 — множитель контракта неизвестен, денег нет; 2 — деньги приближённые; 4 — нет\nвремени биржи; 8 — количество из quote; 16 — деньги не влезли в Int64; 32 — архивная\nстрока без множителя), source (`live`/`r2`), source_id (строкой, u64 — ключ события).",
            "example": [
              "t",
              "t_recv",
              "side",
              "price",
              "price_kind",
              "qty",
              "qty_native",
              "notional_e8",
              "completeness",
              "flags",
              "source",
              "source_id"
            ]
          },
          "completeness": {
            "type": [
              "string",
              "null"
            ],
            "description": "Полнота ленты площадки: `full` (все ликвидации), `sampled` (биржа отдаёт выборку; у\nBinance/Aster — не больше одной на символ в секунду), `none` (ленты нет: пусто — значит\n«не собираем», а не «ноль»).",
            "example": "sampled"
          },
          "from": {
            "type": "integer",
            "format": "int64",
            "description": "Окно страницы, Unix-мс: `[from, to)`."
          },
          "gaps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LiqGap"
            },
            "description": "Дыры ленты в окне: пустые `rows` при пустых `gaps` — ликвидаций не было, под дырой —\n«не знаем»."
          },
          "instrument": {
            "type": "string",
            "description": "Каноническое имя: у Hyperliquid — по монете, как в кадре `/v1/liquidations/stream`\n(`hyperliquid:perp:amzn.xyz` → `hyperliquid:perp:AMZNUSDC.XYZ`, `BTCUSDC` → `BTC`); у\nпрочих площадок — как в запросе.",
            "example": "binance:perp:BTCUSDT"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Курсор следующей страницы; `null` — событий в окне больше нет."
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            },
            "example": [
              [
                1794500458713,
                1794500458790,
                "long",
                "0.1",
                "bankruptcy",
                1.64,
                "1.64",
                "16400000",
                "full",
                0,
                "live",
                "9007199254740993"
              ]
            ]
          },
          "to": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "LiqGap": {
        "type": "object",
        "description": "Интервал, когда лента НЕ слушала: окно (бар) под ним — «не знаем», а не ноль.",
        "required": [
          "from_ms",
          "to_ms",
          "reason"
        ],
        "properties": {
          "from_ms": {
            "type": "integer",
            "format": "int64",
            "description": "Начало, Unix-мс."
          },
          "instrument": {
            "type": [
              "string",
              "null"
            ],
            "description": "Только у суммы площадок (`instruments=`): чья это дыра.",
            "example": "binance:perp:BTCUSDT"
          },
          "reason": {
            "type": "string",
            "description": "`start` (простой до запуска ленты), `disconnect` (обрыв сокета или тишина),\n`buffer_overflow` (хранилище недоступно, события вытеснены), `sink_overflow` (каскад\nпереполнил очередь записи), `not_collected` (до первого запуска ленты площадки или ленты\nнет вовсе).",
            "example": "disconnect"
          },
          "to_ms": {
            "type": "integer",
            "format": "int64",
            "description": "Конец, Unix-мс."
          }
        }
      },
      "MarginAssetsResponse": {
        "type": "object",
        "description": "`/v1/margin/assets`: строка на актив пула (по имени), одни единицы на ответ.",
        "required": [
          "as_of",
          "columns",
          "rows"
        ],
        "properties": {
          "as_of": {
            "type": "integer",
            "format": "int64",
            "description": "Новейшая минута кэша источника, Unix-мс UTC: к ней относятся суммы и запас."
          },
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "`units=base`: asset, borrow, repay, volume, net, borrow_z, repay_z, borrow_chg_pct,\nrepay_chg_pct, borrow_chg_z, repay_chg_z, inventory, inventory_ts, price_usdt,\nrate_apr_binance, rate_apr_okx, rate_apr_bybit, lend_apr_gate. `units=usdt`: вместо сумм —\nborrow_usd_e8, repay_usd_e8, volume_usd_e8, net_usd_e8, вместо inventory — inventory_usd_e8."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Всегда `null`: страниц нет."
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            },
            "description": "Строки в порядке `columns`. Количества, цены и ставки — точной десятичной строкой,\n`*_usd_e8` — целым строкой (USDT × 10⁸), z и проценты — числом; нет данных — `null`."
          }
        }
      },
      "MarginCompareResponse": {
        "type": "object",
        "description": "`/v1/margin/compare`: чистые займы нескольких активов по бакетам.",
        "required": [
          "as_of",
          "columns",
          "rows"
        ],
        "properties": {
          "as_of": {
            "type": "integer",
            "format": "int64",
            "description": "Новейшая минута кэша источника, Unix-мс UTC."
          },
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "`ts, btc_price_usdt, net_usd_e8:<АКТИВ>…` — по колонке на актив запроса."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Всегда `null`: страниц нет."
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            },
            "description": "Строки в порядке `columns`; `net_usd_e8:*` — целым строкой (USDT × 10⁸) или `null`."
          }
        }
      },
      "MarginCoverageResponse": {
        "type": "object",
        "description": "`/v1/margin/coverage`: что источник собирает и насколько свежо. Не таблица.",
        "required": [
          "events_truncated",
          "sources"
        ],
        "properties": {
          "as_of": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Новейшая минута кэша источника, Unix-мс UTC; `null` — кэш ещё не прогрет."
          },
          "events_truncated": {
            "type": "boolean",
            "description": "`true` — эпизодов «пул пуст» за 90 суток больше 5 000: в кэше источника (и в\n`/v1/margin/events`) — новейшие 5 000 по началу, старшие опущены."
          },
          "sources": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MarginCoverageSource"
            }
          }
        }
      },
      "MarginCoverageSource": {
        "type": "object",
        "description": "Источник в покрытии маржи.",
        "required": [
          "source",
          "state",
          "gaps_24h",
          "gap_minutes_24h"
        ],
        "properties": {
          "gap_minutes_24h": {
            "type": "integer",
            "format": "int64",
            "description": "Минут дыр за последние сутки."
          },
          "gaps_24h": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            },
            "description": "Дыры за последние сутки: `[from, to | null, reason]`."
          },
          "last_minute": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Новейшая минута источника в кэше, Unix-мс UTC."
          },
          "reason": {
            "type": [
              "string",
              "null"
            ],
            "description": "У `error`: `stale`, `store`, `warming`; иначе `null`."
          },
          "source": {
            "type": "string",
            "description": "По порядку: inventory, inventory_margin, inventory_isolated, prices, rates_binance,\nrates_okx, rates_bybit, rates_gate."
          },
          "state": {
            "type": "string",
            "description": "`enabled`, `disabled`, `no_key` (ключа нет — запас не опрашивается, остальное отвечает),\n`error`."
          },
          "used_weight_ip_1m": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Вес запросов IP у Binance на новейшем ответе запаса (только `inventory`)."
          }
        }
      },
      "MarginEventsResponse": {
        "type": "object",
        "description": "`/v1/margin/events`: эпизоды «пул пуст», новые сначала.",
        "required": [
          "as_of",
          "columns",
          "rows"
        ],
        "properties": {
          "as_of": {
            "type": "integer",
            "format": "int64",
            "description": "Новейшая минута кэша источника, Unix-мс UTC."
          },
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "asset, kind, start, end (`null` — пул ещё пуст), end_reason (`refilled`, `delisted`,\n`null`), borrow_24h (в единицах актива, строкой), borrow24h_usd_e8 (строкой), growth_pct,\nempty_for_s."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Всегда `null`: страниц нет."
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            },
            "description": "Строки в порядке `columns`; эпизодов нет — пустой массив."
          }
        }
      },
      "MarginRatesResponse": {
        "type": "object",
        "description": "`/v1/margin/rates`: ставки площадок по времени, старые сначала.",
        "required": [
          "columns",
          "rows"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "ts, venue, side (`borrow` — платит заёмщик, `lend` — получает кредитор), vip_level,\nrate_apr (годовая доля десятичной строкой), src_unit (`day`, `hour`, `year`),\nborrow_limit (в единицах актива строкой или `null`)."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Всегда `null`: страниц нет."
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            },
            "description": "Строки в порядке `columns`."
          }
        }
      },
      "MarginSeriesResponse": {
        "type": "object",
        "description": "`/v1/margin/series`: ряд одного актива по бакетам шага.",
        "required": [
          "columns",
          "rows"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "`ts` (начало бакета, Unix-мс UTC), затем по колонке на метрику в порядке `metrics`; в\n`units=usdt` borrow, repay, net, net_cum, inventory — borrow_usd_e8, repay_usd_e8,\nnet_usd_e8, net_cum_usd_e8, inventory_usd_e8."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Всегда `null`: страниц нет."
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            },
            "description": "Строки в порядке `columns`; бакет без единой минуты с данными — `null`, а не ноль."
          }
        }
      },
      "MetricSeriesResponse": {
        "type": "object",
        "required": [
          "instrument",
          "tf",
          "metric",
          "columns",
          "rows"
        ],
        "properties": {
          "bins": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            },
            "description": "Только у `delta_size`/`cvd_size`: нижние границы 10 корзин в $ (notional сделки) по\nпорядку колонок `b0_1k … b5m_plus`; верхняя — следующая граница, у последней — нет.",
            "example": [
              0,
              1000,
              10000,
              25000,
              50000,
              100000,
              250000,
              500000,
              1000000,
              5000000
            ]
          },
          "by": {
            "type": [
              "string",
              "null"
            ],
            "description": "Только у `delta_size`/`cvd_size`: раскладка корзин, `hit` или `print`.",
            "example": "hit"
          },
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "t",
              "value"
            ]
          },
          "deep_until": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Только у `cvd`, `delta`, `volume`, `trades_n`: шов глубокого яруса (свечи бирж с\nлистинга), Unix-мс, правый край исключён. Приходит у любого символа, у которого есть свечи\nсклада, и в живом окне, целиком правее шва: поле не значит, что на странице есть `null`.\n`null` — только у точек левее шва: дельта там неизвестна — у `delta` и `cvd` `value` —\n`null` (не ноль), и `cvd` копится только со шва (при `from` левее шва — не от `from`); у\n`volume` в `unit=base` — `null`, в `quote` — число свечи; у `trades_n` ноль — `null` (биржи\nбез счётчика сделок в свечах). `4294967295000` — весь ряд из свечей склада. У суммы\nплощадок — самый поздний шов набора. Нет поля — у символа нет глубокого яруса.",
            "example": 1705449600000
          },
          "delta_size_enabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Только у `delta_size`/`cvd_size` и только `false`: источник сказал, что запись корзин у\nнего выключена — пустой ряд значит это, а не «сделок не было»."
          },
          "instrument": {
            "type": "string",
            "example": "binance:perp:BTCUSDT"
          },
          "instruments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Только у суммы площадок (`instruments=`): набор по порядку бит `venues_mask`."
          },
          "instruments_present": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Только у суммы: площадки, которые есть хоть в одной точке страницы."
          },
          "metric": {
            "type": "string",
            "example": "cvd"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            },
            "example": [
              [
                1791331200000,
                -18339185.03
              ]
            ]
          },
          "tf": {
            "type": "string",
            "example": "1m"
          },
          "unit": {
            "type": [
              "string",
              "null"
            ],
            "description": "`quote`, `base`; у `trades_n` — null; у `delta_size`/`cvd_size` — всегда `base`."
          }
        }
      },
      "MetricsResponse": {
        "type": "object",
        "description": "Справочник колонками. Без метки времени: он статичен, один на все запросы.",
        "required": [
          "columns",
          "rows"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "key",
              "name",
              "unit",
              "window",
              "group",
              "description"
            ]
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            },
            "example": [
              [
                "odu5",
                "oi_change_usd_5m",
                "usd",
                "5m",
                "oi",
                "Изменение OI за 5 минут, $"
              ]
            ]
          }
        }
      },
      "NowBlock": {
        "type": "object",
        "description": "Блок `now` (договор §8).",
        "required": [
          "at_ms",
          "windows",
          "throttled_today"
        ],
        "properties": {
          "at_ms": {
            "type": "integer",
            "format": "int64"
          },
          "last_limited": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/LastLimited"
              }
            ]
          },
          "throttled_today": {
            "type": "integer",
            "format": "int64",
            "description": "Отказов 429 и лимитных 403 за сутки UTC.",
            "minimum": 0
          },
          "windows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WindowNow"
            },
            "description": "Общие окна — всегда; окна групп — только у групп с собственным лимитом."
          }
        }
      },
      "OptionsBase": {
        "type": "object",
        "description": "База площадки.",
        "required": [
          "base",
          "chains"
        ],
        "properties": {
          "base": {
            "type": "string",
            "description": "`BTC`, `ETH`, `SOL`, …"
          },
          "chains": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsBaseChain"
            },
            "description": "Цепочки базы по имени; только те, где что-то листингуется."
          }
        }
      },
      "OptionsBaseChain": {
        "type": "object",
        "description": "Цепочка базы в списке баз: то, что в ней листингуется сейчас.",
        "required": [
          "chain",
          "catalog_ver",
          "instruments",
          "expiries"
        ],
        "properties": {
          "catalog_ver": {
            "type": "integer",
            "format": "int32",
            "description": "Версия каталога цепочки — та же, что у `/v1/options/catalog`.",
            "minimum": 0
          },
          "chain": {
            "type": "string",
            "description": "`BTC`, `BTC_USDC`, `BTC_UM`, …"
          },
          "expiries": {
            "type": "integer",
            "format": "int32",
            "description": "Разных экспираций у листингованных инструментов.",
            "minimum": 0
          },
          "instruments": {
            "type": "integer",
            "format": "int32",
            "description": "Листингованных инструментов.",
            "minimum": 0
          },
          "price_ccy": {
            "type": [
              "string",
              "null"
            ],
            "description": "Валюта цен `bid`, `ask`, `mark` — валюта котировки цепочки, как у каталога; `null` —\nинструменты расходятся."
          },
          "settle": {
            "type": [
              "string",
              "null"
            ],
            "description": "`linear` или `inverse`; `null` — инструменты цепочки расходятся."
          }
        }
      },
      "OptionsBasesResponse": {
        "type": "object",
        "description": "`/v1/options/bases`: базы и их цепочки по площадкам — из каталога в памяти источника.",
        "required": [
          "venues"
        ],
        "properties": {
          "venues": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsBasesVenue"
            },
            "description": "Площадки: присланная `venue` или все четыре — `deribit`, `binance`, `bybit`, `okx`."
          }
        }
      },
      "OptionsBasesVenue": {
        "type": "object",
        "description": "Базы одной площадки.",
        "required": [
          "venue",
          "bases"
        ],
        "properties": {
          "bases": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsBase"
            },
            "description": "Базы по имени; базы без листинга нет в списке."
          },
          "venue": {
            "type": "string"
          }
        }
      },
      "OptionsCalcCoverage": {
        "type": "object",
        "description": "Полнота ответа расчёта: `complete` — ни одной дыры.",
        "required": [
          "complete",
          "gaps"
        ],
        "properties": {
          "complete": {
            "type": "boolean"
          },
          "gaps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsCalcGap"
            }
          }
        }
      },
      "OptionsCalcGap": {
        "type": "object",
        "description": "Дыра расчёта naive (`exposure/latest`, `levels/range`): что не посчитано — не ноль.",
        "required": [
          "from_ms",
          "to_ms",
          "chain",
          "stream",
          "reason"
        ],
        "properties": {
          "chain": {
            "type": "string",
            "description": "Книга дыры (у суммы площадок — и база)."
          },
          "from_ms": {
            "type": "integer",
            "format": "int64",
            "description": "Начало, Unix-мс UTC (у `exposure/latest` — минута книги или «сейчас»)."
          },
          "reason": {
            "type": "string",
            "description": "`exposure/latest`: `no_frame`, причина сборки минуты, `no_calc` (валюта книги неизвестна),\n`money_overflow`; у `venue=all` причина книги — с площадкой (`no_frame:<площадка>`,\n`no_calc:<площадка>`, `other_minute:<площадка>` — книги нет в минуте суммы, новейшей общей,\n`no_index:<площадка>`), причина суммы — без неё (`no_index`, `sum_refused: …`,\n`money_overflow`). `levels/range`: `no_calc` (граница не позже новейшей минуты книги без\nстроки расчёта), `no_frame` (у книги нет ни одной минуты в памяти)."
          },
          "stream": {
            "type": "string",
            "description": "`chain` — минута книги в памяти (`exposure/latest`), `calc` — строки минутного расчёта\n(`levels/range`)."
          },
          "to_ms": {
            "type": "integer",
            "format": "int64",
            "description": "Конец (не входит), Unix-мс UTC."
          }
        }
      },
      "OptionsCatalogChain": {
        "type": "object",
        "description": "Цепочка каталога.",
        "required": [
          "chain",
          "catalog_ver",
          "instruments"
        ],
        "properties": {
          "catalog_ver": {
            "type": "integer",
            "format": "int32",
            "description": "Версия каталога цепочки: растёт при листинге и делистинге; метка ответа — по ней.",
            "minimum": 0
          },
          "chain": {
            "type": "string",
            "description": "`BTC`, `BTC_USDC`, …"
          },
          "instruments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsInstrument"
            }
          },
          "price_ccy": {
            "type": [
              "string",
              "null"
            ],
            "description": "Валюта цен `bid`, `ask`, `mark` — валюта котировки цепочки, она же валюта расчёта\nкаталога: Deribit `BTC` — BTC, `BTC_USDC` — USDC; Binance — USDT; Bybit — монета расчёта\n(USDT); OKX `BTC` — BTC, `BTC_UM` — USD. `null` — инструменты расходятся или площадка не\nшлёт."
          },
          "settle": {
            "type": [
              "string",
              "null"
            ],
            "description": "`linear` или `inverse` — у всех инструментов цепочки; `null` — инструменты расходятся."
          },
          "volume_notional_ccy": {
            "type": [
              "string",
              "null"
            ],
            "description": "Валюта номинала `volume_notional_usd_e8`: только Bybit — как `price_ccy` (USDT; на\n`_USDC` — USDC); у Deribit, Binance и OKX номинала нет — `null`."
          },
          "volume_usd_ccy": {
            "type": [
              "string",
              "null"
            ],
            "description": "Валюта премии `volume_usd_e8`: Deribit — USD на всех цепочках, Binance — как `price_ccy`\n(USDT); у Bybit и OKX премии нет — `null`."
          }
        }
      },
      "OptionsCatalogResponse": {
        "type": "object",
        "description": "`/v1/options/catalog`: инструменты по цепочкам базы.",
        "required": [
          "venue",
          "base",
          "chains"
        ],
        "properties": {
          "base": {
            "type": "string"
          },
          "chains": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsCatalogChain"
            }
          },
          "venue": {
            "type": "string"
          }
        }
      },
      "OptionsChainMinute": {
        "type": "object",
        "description": "Цепочка одной минуты.",
        "required": [
          "chain",
          "ts_min",
          "snap_ts",
          "oi_asof_ms",
          "catalog_ver",
          "rows"
        ],
        "properties": {
          "catalog_ver": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "chain": {
            "type": "string"
          },
          "oi_asof_ms": {
            "type": "integer",
            "format": "int64",
            "description": "К какому моменту относится OI (Deribit — на 8 ч раньше снимка)."
          },
          "price_ccy": {
            "type": [
              "string",
              "null"
            ],
            "description": "Валюта цен `bid`, `ask`, `mark` строк — валюта котировки цепочки, как у каталога."
          },
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsRow"
            }
          },
          "settle": {
            "type": [
              "string",
              "null"
            ],
            "description": "`linear` или `inverse` — из каталога в памяти источника (а не каталога той минуты)."
          },
          "snap_ts": {
            "type": "integer",
            "format": "int64",
            "description": "Снимок площадки сразу после закрытия минуты, Unix-мс UTC."
          },
          "ts_min": {
            "type": "integer",
            "format": "int64",
            "description": "Начало минуты, Unix-мс UTC."
          },
          "volume_notional_ccy": {
            "type": [
              "string",
              "null"
            ],
            "description": "Валюта номинала `volume_notional_usd_e8` строк: только Bybit (USDT; на `_USDC` — USDC), у\nпрочих — `null`."
          },
          "volume_usd_ccy": {
            "type": [
              "string",
              "null"
            ],
            "description": "Валюта премии `volume_usd_e8` строк: Deribit — USD, Binance — USDT; у Bybit и OKX — `null`."
          }
        }
      },
      "OptionsChainResponse": {
        "type": "object",
        "description": "`/v1/options/chain` и `/v1/options/chain/latest`: минута цепочек базы.",
        "required": [
          "venue",
          "base",
          "chains"
        ],
        "properties": {
          "base": {
            "type": "string"
          },
          "chains": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsChainMinute"
            }
          },
          "missing": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/OptionsMissing"
            },
            "description": "Цепочки без минуты; поля нет — все на месте. Такой ответ никогда не `immutable`."
          },
          "venue": {
            "type": "string"
          }
        }
      },
      "OptionsCoverageChain": {
        "type": "object",
        "description": "Цепочка в покрытии.",
        "required": [
          "chain"
        ],
        "properties": {
          "chain": {
            "type": "string"
          },
          "lag_ms": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Отставание новейшей минуты от сейчас, мс; `null` — минуты ещё нет."
          },
          "last_ts_min": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Новейшая минута в памяти источника, Unix-мс UTC."
          },
          "unbuilt": {
            "description": "Новее хранится минута, которую не собрать: `{detail, reason, ts_min}`; поля нет — нет."
          }
        }
      },
      "OptionsCoverageResponse": {
        "type": "object",
        "description": "`/v1/options/coverage`: цепочки базы и дыры окна. Ключи — по алфавиту.",
        "required": [
          "base",
          "chains",
          "from",
          "gaps",
          "to",
          "venue"
        ],
        "properties": {
          "base": {
            "type": "string"
          },
          "chains": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsCoverageChain"
            }
          },
          "from": {
            "type": "integer",
            "format": "int64",
            "description": "Начало окна, Unix-мс UTC."
          },
          "gaps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsGap"
            }
          },
          "to": {
            "type": "integer",
            "format": "int64"
          },
          "venue": {
            "type": "string"
          }
        }
      },
      "OptionsExpiriesResponse": {
        "type": "object",
        "description": "`/v1/options/expiries`: экспирации по цепочкам. Ключи — по алфавиту (так пишет источник).",
        "required": [
          "base",
          "expiries",
          "venue"
        ],
        "properties": {
          "base": {
            "type": "string"
          },
          "expiries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsExpiry"
            }
          },
          "venue": {
            "type": "string"
          }
        }
      },
      "OptionsExpiry": {
        "type": "object",
        "description": "Экспирация цепочки. OI (`oi_*`) — новейшей минуты цепочки; без кадра все пять — `null`.",
        "required": [
          "calls",
          "chain",
          "expiry_ms",
          "puts",
          "settlement_period"
        ],
        "properties": {
          "calls": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "chain": {
            "type": "string"
          },
          "expiry_ms": {
            "type": "integer",
            "format": "int64",
            "description": "Unix-мс UTC."
          },
          "oi_asof_ms": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "К какому моменту относится OI экспирации: `snap_ts − oi_lag_ms` кадра (Deribit — на 8 ч\nраньше снимка, прочие — снимок), Unix-мс UTC."
          },
          "oi_calls": {
            "type": [
              "string",
              "null"
            ],
            "description": "Σ `oi_asof` call экспирации в контрактах, точной десятичной строкой (× `contract_size` —\nмонеты базы); `null` — OI нет ни у одного call (не «0»)."
          },
          "oi_coins": {
            "type": [
              "string",
              "null"
            ],
            "description": "(Σ call + Σ put) × `contract_size` кадра — монеты базы, десятичной строкой; `null` — OI нет\nни у одной стороны."
          },
          "oi_puts": {
            "type": [
              "string",
              "null"
            ],
            "description": "Σ `oi_asof` put экспирации в контрактах, точной десятичной строкой (× `contract_size` —\nмонеты базы); `null` — OI нет ни у одного put."
          },
          "oi_rows": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Строк кадра в суммах OI: меньше `calls + puts` — у части экспирации OI нет, суммы — по\nостальным.",
            "minimum": 0
          },
          "price_ccy": {
            "type": [
              "string",
              "null"
            ],
            "description": "Валюта цен цепочки — как у каталога (`OptionsCatalogChain.price_ccy`)."
          },
          "puts": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "settle": {
            "type": [
              "string",
              "null"
            ],
            "description": "`linear` или `inverse`; `null` — инструменты цепочки расходятся."
          },
          "settlement_period": {
            "type": "string"
          },
          "volume_notional_ccy": {
            "type": [
              "string",
              "null"
            ],
            "description": "Валюта номинала `volume_notional_usd_e8`: только Bybit (USDT; на `_USDC` — USDC), у\nпрочих — `null`."
          },
          "volume_notional_usd_e8": {
            "type": [
              "string",
              "null"
            ],
            "description": "Номинал за 24 ч — сумма по инструментам экспирации на новейшей минуте, × 10⁸ целым\nстрокой (i128); только Bybit, в монете расчёта (`turnover24h`: USDT; на `_USDC` — USDC).\nУ Deribit, Binance и OKX — `null`, как и пока кадра нет. С премией несравним."
          },
          "volume_usd_ccy": {
            "type": [
              "string",
              "null"
            ],
            "description": "Валюта премии `volume_usd_e8`: Deribit — USD, Binance — USDT; у Bybit и OKX — `null`."
          },
          "volume_usd_e8": {
            "type": [
              "string",
              "null"
            ],
            "description": "Премия за 24 ч — сумма по инструментам экспирации на новейшей минуте, × 10⁸ целым строкой\n(i128) в валюте площадки: Deribit — USD (обе цепочки, и `BTC_USDC`), Binance — USDT (USDT —\nне USD). У Bybit и OKX — `null`, как и пока кадра нет."
          }
        }
      },
      "OptionsExposureLatestResponse": {
        "type": "object",
        "description": "`/v1/options/exposure/latest`: GEX, DEX, VEX и CEX новейшей минуты книги (или суммы площадок)\nпо страйкам, их суммы и профиль net GEX.",
        "required": [
          "venue",
          "base",
          "expiry",
          "mode",
          "coverage",
          "expiries_ms",
          "strikes",
          "profile"
        ],
        "properties": {
          "asof_ms": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Минута расчёта, Unix-мс UTC; нет минуты — `null`."
          },
          "base": {
            "type": "string"
          },
          "chain": {
            "type": [
              "string",
              "null"
            ],
            "description": "Книга ответа (присланная или по правилу `vol/book-range`); у `venue=all` — `null`."
          },
          "coverage": {
            "$ref": "#/components/schemas/OptionsCalcCoverage"
          },
          "expiries_ms": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Экспирации группы, Unix-мс UTC."
          },
          "expiry": {
            "type": "string",
            "description": "Группа экспираций: `0dte`, `1d`, `7d`, `31d`, `91d`, `all`."
          },
          "mode": {
            "type": "string",
            "description": "`naive`."
          },
          "profile": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsExposurePoint"
            },
            "description": "121 точка: ±15 % от индекса шагом 0,25 %."
          },
          "spot": {
            "type": [
              "string",
              "null"
            ],
            "description": "Индекс точной десятичной строкой; книга без индекса (OKX) — `null` и пустой профиль."
          },
          "strikes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsExposureStrike"
            }
          },
          "totals": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/OptionsExposureTotals",
                "description": "Суммы; книга без минуты, без расчёта или с переполнением — `null` (дыра в `coverage`)."
              }
            ]
          },
          "usd_ccy": {
            "type": [
              "string",
              "null"
            ],
            "description": "Валюта всех `*_usd_e8`: котировка книги, у `venue=all` — опорной книги."
          },
          "venue": {
            "type": "string",
            "description": "Площадка запроса или `all`."
          }
        },
        "example": {
          "asof_ms": 1795169940000,
          "base": "BTC",
          "chain": "BTC",
          "coverage": {
            "complete": true,
            "gaps": []
          },
          "expiries_ms": [
            1795161600000
          ],
          "expiry": "all",
          "mode": "naive",
          "profile": [
            {
              "gex_usd_e8": "-16400000",
              "price": "82450.1"
            }
          ],
          "spot": "97000.12",
          "strikes": [
            {
              "cex_usd_e8": "0",
              "dex_usd_e8": "0",
              "gex_call_usd_e8": "120000000000",
              "gex_put_usd_e8": "-16400000",
              "oi_call_coins": "120.5",
              "oi_put_coins": "10",
              "strike": "95000",
              "vex_usd_e8": "0"
            }
          ],
          "totals": {
            "cex_usd_e8": "0",
            "dex_usd_e8": "-16400000",
            "gex_usd_e8": "-350800000000000",
            "vex_usd_e8": "9007199254740993"
          },
          "usd_ccy": "USD",
          "venue": "deribit"
        }
      },
      "OptionsExposurePoint": {
        "type": "object",
        "description": "Точка профиля net GEX: цена `spot·(1 + x)` в шкале цены инструмента.",
        "required": [
          "price",
          "gex_usd_e8"
        ],
        "properties": {
          "gex_usd_e8": {
            "type": "string"
          },
          "price": {
            "type": "string"
          }
        }
      },
      "OptionsExposureStrike": {
        "type": "object",
        "description": "Страйк группы: деньги — целым строкой (× 10⁸) в валюте `usd_ccy`, OI — монеты базы точной\nдесятичной строкой.",
        "required": [
          "strike",
          "gex_call_usd_e8",
          "gex_put_usd_e8",
          "dex_usd_e8",
          "vex_usd_e8",
          "cex_usd_e8",
          "oi_call_coins",
          "oi_put_coins"
        ],
        "properties": {
          "cex_usd_e8": {
            "type": "string"
          },
          "dex_usd_e8": {
            "type": "string"
          },
          "gex_call_usd_e8": {
            "type": "string"
          },
          "gex_put_usd_e8": {
            "type": "string"
          },
          "oi_call_coins": {
            "type": "string"
          },
          "oi_put_coins": {
            "type": "string"
          },
          "strike": {
            "type": "string",
            "description": "Страйк точной десятичной строкой в шкале страйка."
          },
          "venue_share": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/OptionsVenueShare",
                "description": "Только у `venue=all`."
              }
            ]
          },
          "vex_usd_e8": {
            "type": "string"
          }
        }
      },
      "OptionsExposureTotals": {
        "type": "object",
        "description": "Суммы группы экспираций: деньги — целым строкой (× 10⁸) в валюте `usd_ccy`, на 1 % хода.",
        "required": [
          "gex_usd_e8",
          "dex_usd_e8",
          "vex_usd_e8",
          "cex_usd_e8"
        ],
        "properties": {
          "cex_usd_e8": {
            "type": "string"
          },
          "dex_usd_e8": {
            "type": "string"
          },
          "gex_usd_e8": {
            "type": "string",
            "description": "Net GEX naive (коллы +, путы −)."
          },
          "vex_usd_e8": {
            "type": "string"
          }
        }
      },
      "OptionsGap": {
        "type": "object",
        "description": "Дыра сбора. Ключи — по алфавиту.",
        "required": [
          "from_ms",
          "reason",
          "stream",
          "to_ms"
        ],
        "properties": {
          "chain": {
            "type": [
              "string",
              "null"
            ],
            "description": "Цепочка (книга) дыры; `null` — записанное имя не цепочка и не индекс каталога площадки\n(единица опроса `*`, `ALL`, `USDC` или индекс, которого нет в каталоге): имя — в `source`,\nтакая дыра — в ответе каждой базы."
          },
          "from_ms": {
            "type": "integer",
            "format": "int64"
          },
          "reason": {
            "type": "string"
          },
          "source": {
            "type": [
              "string",
              "null"
            ],
            "description": "Записанное имя, когда это не сама цепочка: индекс (`btc_usd`), базовый актив OKX\n(`BTC-USD`), единица опроса. Поля нет — дыра записана под своей цепочкой."
          },
          "stream": {
            "type": "string",
            "description": "`chain` (кадры цепочки), `live` (поток площадки), `catalog`, `oi` или `quotes` (опросы)."
          },
          "to_ms": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "OptionsInstrument": {
        "type": "object",
        "description": "Инструмент каталога.",
        "required": [
          "instrument",
          "expiry_ms",
          "strike",
          "type",
          "settle",
          "contract_size",
          "tick_size",
          "tick_steps",
          "min_trade",
          "settlement_period",
          "settlement_currency",
          "price_index",
          "state"
        ],
        "properties": {
          "contract_size": {
            "type": "string",
            "description": "Размер контракта в монетах базы, десятичной строкой."
          },
          "expiry_ms": {
            "type": "integer",
            "format": "int64",
            "description": "Экспирация, Unix-мс UTC."
          },
          "instrument": {
            "type": "string",
            "description": "Имя площадки (`BTC-20NOV26-95000-C`)."
          },
          "min_trade": {
            "type": "string",
            "description": "Наименьшая заявка в контрактах, десятичной строкой; × `contract_size` — монеты базы."
          },
          "price_index": {
            "type": "string"
          },
          "settle": {
            "type": "string",
            "description": "`linear` или `inverse`."
          },
          "settlement_currency": {
            "type": "string"
          },
          "settlement_period": {
            "type": "string",
            "description": "`day`, `week`, `month`, `quarter`."
          },
          "state": {
            "type": "string",
            "description": "Состояние на площадке (`open`)."
          },
          "strike": {
            "type": "string",
            "description": "Страйк десятичной строкой."
          },
          "tick_size": {
            "type": "string",
            "description": "Шаг цены десятичной строкой."
          },
          "tick_steps": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Ступени шага: `[цена от, шаг]` десятичными строками; пусто — шаг один."
          },
          "type": {
            "type": "string",
            "description": "`call` или `put`."
          }
        }
      },
      "OptionsLevelsRangeResponse": {
        "type": "object",
        "description": "`/v1/options/levels/range`: история уровней одной книги по границам шага в `[from, to)`.",
        "required": [
          "venue",
          "base",
          "chain",
          "expiry",
          "mode",
          "step",
          "from",
          "to",
          "coverage",
          "rows"
        ],
        "properties": {
          "asof_ms": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "`ts_ms` последней строки; строк нет — `null`."
          },
          "base": {
            "type": "string"
          },
          "chain": {
            "type": "string",
            "description": "Книга ряда: присланная или по правилу `vol/book-range`."
          },
          "coverage": {
            "$ref": "#/components/schemas/OptionsCalcCoverage"
          },
          "expiry": {
            "type": "string"
          },
          "from": {
            "type": "integer",
            "format": "int64",
            "description": "Начало диапазона, Unix-мс UTC."
          },
          "mode": {
            "type": "string"
          },
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsLevelsRow"
            },
            "description": "Точки по порядку границ; границы без строки — в `coverage.gaps`."
          },
          "step": {
            "type": "string",
            "description": "`1m`, `5m` или `1h`, как в запросе."
          },
          "to": {
            "type": "integer",
            "format": "int64",
            "description": "Конец диапазона (не входит), Unix-мс UTC."
          },
          "usd_ccy": {
            "type": [
              "string",
              "null"
            ],
            "description": "Валюта `net_gex_usd_e8` (котировка книги); строк нет — `null`."
          },
          "venue": {
            "type": "string"
          }
        },
        "example": {
          "asof_ms": 1795089600000,
          "base": "BTC",
          "chain": "BTC",
          "coverage": {
            "complete": false,
            "gaps": [
              {
                "chain": "BTC",
                "from_ms": 1795093200000,
                "reason": "no_calc",
                "stream": "calc",
                "to_ms": 1795093260000
              }
            ]
          },
          "expiry": "all",
          "from": 1795089600000,
          "mode": "naive",
          "rows": [
            {
              "abs_gamma": "1200000.5",
              "call_walls": [
                "100000",
                "105000"
              ],
              "fwd": "97012.5",
              "max_pain": "96000",
              "max_pain_expiry_ms": 1795161600000,
              "move_sigma_bp": 334,
              "move_straddle_bp": 266,
              "net_gex_usd_e8": "-16400000",
              "put_walls": [
                "95000",
                null
              ],
              "spot": "97000.12",
              "ts_ms": 1795089600000,
              "unstable": false,
              "zero_gamma": "96500",
              "zero_gamma_sticky_delta": null
            }
          ],
          "step": "1h",
          "to": 1795096800000,
          "usd_ccy": "USD",
          "venue": "deribit"
        }
      },
      "OptionsLevelsRow": {
        "type": "object",
        "description": "Точка истории уровней: минута ровно на границе шага (строка минутного расчёта naive). Цены и\nстрайки — точной десятичной строкой в шкале инструмента; `null` — нет данных, не ноль.",
        "required": [
          "ts_ms",
          "unstable",
          "net_gex_usd_e8"
        ],
        "properties": {
          "abs_gamma": {
            "type": [
              "string",
              "null"
            ]
          },
          "call_walls": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "string",
                "null"
              ]
            },
            "description": "Две стены коллов (страйки), `null` — нет."
          },
          "fwd": {
            "type": [
              "string",
              "null"
            ],
            "description": "Форвард ближайшей поставки группы."
          },
          "max_pain": {
            "type": [
              "string",
              "null"
            ],
            "description": "Max pain ближайшей поставки группы (страйк); нет экспирации — `null`."
          },
          "max_pain_expiry_ms": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          },
          "move_sigma_bp": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Ожидаемый ход σ√T, б. п. от форварда."
          },
          "move_straddle_bp": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Ожидаемый ход по модельному ATMF-страддлу, б. п. от форварда."
          },
          "net_gex_usd_e8": {
            "type": "string",
            "description": "Net GEX группы целым строкой (× 10⁸) в валюте `usd_ccy`; нет экспирации — `\"0\"`."
          },
          "put_walls": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "string",
                "null"
              ]
            },
            "description": "Две стены путов (страйки), `null` — нет."
          },
          "spot": {
            "type": [
              "string",
              "null"
            ],
            "description": "Индекс; книга без индекса (OKX) — `null`."
          },
          "ts_ms": {
            "type": "integer",
            "format": "int64",
            "description": "Граница шага — начало минуты точки, Unix-мс UTC."
          },
          "unstable": {
            "type": "boolean",
            "description": "Волна В5; до неё `false`."
          },
          "zero_gamma": {
            "type": [
              "string",
              "null"
            ],
            "description": "Цена смены знака профиля net GEX; смены нет — `null`."
          },
          "zero_gamma_sticky_delta": {
            "type": [
              "string",
              "null"
            ],
            "description": "Волна В5; до неё `null`."
          }
        }
      },
      "OptionsMissing": {
        "type": "object",
        "description": "Цепочка базы без минуты.",
        "required": [
          "chain",
          "reason",
          "detail"
        ],
        "properties": {
          "chain": {
            "type": "string"
          },
          "detail": {
            "type": "string"
          },
          "reason": {
            "type": "string",
            "description": "`no_frame` (дыра — см. coverage) или `gap` (минута не восстанавливается)."
          }
        }
      },
      "OptionsRangeMissing": {
        "type": "object",
        "description": "Минуты диапазона, которых нет: `[from_ms, to_ms)`, соседние минуты одной причины — одним\nинтервалом.",
        "required": [
          "from_ms",
          "to_ms",
          "reason"
        ],
        "properties": {
          "from_ms": {
            "type": "integer",
            "format": "int64",
            "description": "Начало интервала, Unix-мс UTC."
          },
          "reason": {
            "type": "string",
            "description": "`no_frame` (минута осела, кадра нет) или `gap` (кадр не связывается с отданным перед ним)."
          },
          "to_ms": {
            "type": "integer",
            "format": "int64",
            "description": "Конец интервала (не входит), Unix-мс UTC."
          }
        }
      },
      "OptionsRangeResponse": {
        "type": "object",
        "description": "`/v1/options/chain/range` в JSON: ряд одного инструмента цепочки по минутам `[from, to)`.",
        "required": [
          "venue",
          "base",
          "chain",
          "instrument",
          "from",
          "to",
          "rows"
        ],
        "properties": {
          "base": {
            "type": "string"
          },
          "chain": {
            "type": "string"
          },
          "from": {
            "type": "integer",
            "format": "int64",
            "description": "Начало диапазона, Unix-мс UTC."
          },
          "instrument": {
            "type": "string",
            "description": "Инструмент ряда."
          },
          "missing": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/OptionsRangeMissing"
            },
            "description": "Минуты, которых нет (любого инструмента цепочки); поля нет — все на месте. Такой ответ\nникогда не `immutable`. Открытый хвост диапазона в настоящем — не пропуск."
          },
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsRangeRow"
            },
            "description": "Минуты, где инструмент есть, по порядку; до листинга строк нет — это не пропуск."
          },
          "to": {
            "type": "integer",
            "format": "int64",
            "description": "Конец диапазона (не входит), Unix-мс UTC."
          },
          "venue": {
            "type": "string"
          }
        }
      },
      "OptionsRangeRow": {
        "allOf": [
          {
            "$ref": "#/components/schemas/OptionsRow"
          },
          {
            "type": "object",
            "required": [
              "ts_min",
              "snap_ts",
              "oi_asof_ms",
              "catalog_ver"
            ],
            "properties": {
              "catalog_ver": {
                "type": "integer",
                "format": "int32",
                "minimum": 0
              },
              "oi_asof_ms": {
                "type": "integer",
                "format": "int64",
                "description": "К какому моменту относится OI строки (Deribit — на 8 ч раньше снимка)."
              },
              "snap_ts": {
                "type": "integer",
                "format": "int64",
                "description": "Снимок площадки сразу после закрытия минуты, Unix-мс UTC."
              },
              "ts_min": {
                "type": "integer",
                "format": "int64",
                "description": "Начало минуты, Unix-мс UTC."
              }
            }
          }
        ],
        "description": "Минута ряда инструмента: шапка минуты `/chain` и строка инструмента той минуты — строка в\nстроку, как у `/chain?at=` (деньги `*_usd_e8` — e8 строкой, количества — в контрактах)."
      },
      "OptionsRow": {
        "type": "object",
        "description": "Строка цепочки: инструмент минуты.",
        "required": [
          "expiry_ms",
          "strike",
          "type"
        ],
        "properties": {
          "ask": {
            "type": [
              "string",
              "null"
            ],
            "description": "Лучшая продажа за 1 монету базы, десятичной строкой в валюте котировки цепочки (inverse —\nв монете базы); `null` — нет."
          },
          "ask_size": {
            "type": [
              "string",
              "null"
            ],
            "description": "Объём лучшей продажи в контрактах, десятичной строкой (× `contract_size` — монеты базы);\n`null` — площадка не шлёт."
          },
          "bid": {
            "type": [
              "string",
              "null"
            ],
            "description": "Лучшая покупка за 1 монету базы, десятичной строкой в валюте котировки цепочки (inverse —\nв монете базы); `null` — нет."
          },
          "bid_size": {
            "type": [
              "string",
              "null"
            ],
            "description": "Объём лучшей покупки в контрактах, десятичной строкой (× `contract_size` — монеты базы);\n`null` — площадка не шлёт."
          },
          "expiry_ms": {
            "type": "integer",
            "format": "int64"
          },
          "forward": {
            "type": [
              "string",
              "null"
            ],
            "description": "Форвард и индекс — десятичной строкой; `null` — площадка не шлёт."
          },
          "index": {
            "type": [
              "string",
              "null"
            ]
          },
          "instrument": {
            "type": [
              "string",
              "null"
            ],
            "description": "Имя площадки; `null` — имени в каталоге нет."
          },
          "iv_bp": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Подразумеваемая волатильность, 0,01 пункта (48,72 % → 4872)."
          },
          "mark": {
            "type": [
              "string",
              "null"
            ],
            "description": "Mark площадки за 1 монету базы, десятичной строкой в валюте котировки цепочки (inverse — в\nмонете базы); `null` — нет."
          },
          "oi_asof": {
            "type": [
              "string",
              "null"
            ],
            "description": "OI на момент `oi_asof_ms` цепочки в контрактах, десятичной строкой; × `contract_size` —\nмонеты базы."
          },
          "strike": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "description": "`call` или `put`."
          },
          "volume": {
            "type": [
              "string",
              "null"
            ],
            "description": "Объём за 24 ч в контрактах, десятичной строкой; × `contract_size` — монеты базы."
          },
          "volume_notional_usd_e8": {
            "type": [
              "string",
              "null"
            ],
            "description": "Номинал за 24 ч, × 10⁸ целым строкой (i128); только Bybit, в монете расчёта\n(`turnover24h`: USDT; на `_USDC` — USDC). У Deribit, Binance и OKX — `null`. С премией\nнесравним."
          },
          "volume_usd_e8": {
            "type": [
              "string",
              "null"
            ],
            "description": "Премия за 24 ч, × 10⁸ целым строкой (i128) в валюте площадки: Deribit — USD (обе цепочки,\nи `BTC_USDC`), Binance — USDT (USDT — не USD). У Bybit и OKX — `null`."
          }
        }
      },
      "OptionsVenueShare": {
        "type": "object",
        "description": "Доля площадки в сумме модулей net GEX страйка (`venue=all`; сумма 1, четыре знака; без вклада\n— 0; у страйка с нулевым GEX все — `null`).",
        "properties": {
          "binance": {
            "type": [
              "number",
              "null"
            ],
            "format": "double"
          },
          "bybit": {
            "type": [
              "number",
              "null"
            ],
            "format": "double"
          },
          "deribit": {
            "type": [
              "number",
              "null"
            ],
            "format": "double"
          },
          "okx": {
            "type": [
              "number",
              "null"
            ],
            "format": "double"
          }
        }
      },
      "OptionsVolBookRangeResponse": {
        "type": "object",
        "description": "`/v1/options/vol/book-range`: ряд волатильности одной книги по границам шага в `[from, to)`.",
        "required": [
          "venue",
          "base",
          "chain",
          "step",
          "from",
          "to",
          "coverage",
          "rows"
        ],
        "properties": {
          "asof_ms": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "`ts_ms` последней строки; строк нет — `null` (ответ всё равно `200`)."
          },
          "base": {
            "type": "string"
          },
          "chain": {
            "type": "string",
            "description": "Книга ряда: присланная `chain` или книга с именем базы (`BTC`, а не `BTC_USDC`)."
          },
          "coverage": {
            "$ref": "#/components/schemas/OptionsVolCoverage"
          },
          "from": {
            "type": "integer",
            "format": "int64",
            "description": "Начало диапазона, Unix-мс UTC."
          },
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsVolRow"
            },
            "description": "Точки по порядку границ; границы без строки — в `coverage.gaps`."
          },
          "step": {
            "type": "string",
            "description": "`1h` или `1d`, как в запросе."
          },
          "to": {
            "type": "integer",
            "format": "int64",
            "description": "Конец диапазона (не входит), Unix-мс UTC."
          },
          "venue": {
            "type": "string"
          }
        },
        "example": {
          "asof_ms": 1795096800000,
          "base": "BTC",
          "chain": "BTC",
          "coverage": {
            "complete": false,
            "gaps": [
              {
                "chain": "BTC",
                "from_ms": 1795093200000,
                "reason": "no_frame",
                "stream": "chain",
                "to_ms": 1795093260000
              }
            ]
          },
          "from": 1795089600000,
          "rows": [
            {
              "atm_iv_bp": {
                "d30": 5120,
                "d7": 4810,
                "d90": null
              },
              "bf25_bp_30d": 65,
              "call25_iv_bp_30d": 4980,
              "index": "97000.12",
              "put25_iv_bp_30d": 5390,
              "rr25_bp_30d": -410,
              "ts_ms": 1795089600000
            },
            {
              "atm_iv_bp": {
                "d30": 5105,
                "d7": null,
                "d90": null
              },
              "bf25_bp_30d": null,
              "call25_iv_bp_30d": null,
              "index": null,
              "put25_iv_bp_30d": null,
              "rr25_bp_30d": null,
              "ts_ms": 1795096800000
            }
          ],
          "step": "1h",
          "to": 1795100400000,
          "venue": "deribit"
        }
      },
      "OptionsVolCoverage": {
        "type": "object",
        "description": "Полнота ряда: `complete` — ни одной дыры. Границы после последней минуты книги ещё не\nнастали — это не дыра.",
        "required": [
          "complete",
          "gaps"
        ],
        "properties": {
          "complete": {
            "type": "boolean"
          },
          "gaps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionsVolGap"
            }
          }
        }
      },
      "OptionsVolGap": {
        "type": "object",
        "description": "Дыра ряда: серия закрытых границ подряд без строки — `[первая, последняя + 1 мин)`.",
        "required": [
          "from_ms",
          "to_ms",
          "chain",
          "stream",
          "reason"
        ],
        "properties": {
          "chain": {
            "type": "string",
            "description": "Книга дыры."
          },
          "from_ms": {
            "type": "integer",
            "format": "int64",
            "description": "Первая граница без строки, Unix-мс UTC."
          },
          "reason": {
            "type": "string",
            "description": "`no_frame` (граница осела, кадра нет; и до первой минуты книги в складе), `gap` (кадр не\nразбирается или дельта не восстанавливается) или `replay_limit` (в одной сборке не больше\n6 границ-дельт — остальные со следующим запросом)."
          },
          "stream": {
            "type": "string",
            "description": "`chain` — кадры цепочки."
          },
          "to_ms": {
            "type": "integer",
            "format": "int64",
            "description": "Последняя граница без строки + 1 минута (не входит), Unix-мс UTC."
          }
        }
      },
      "OptionsVolRow": {
        "type": "object",
        "description": "Точка ряда: минута, начало которой ровно на границе шага (ключевой кадр часа у источника).\nIV — mark площадки, дельта крыльев — Black-76 по форварду и mark IV. `null` у числа — расчёт\nэтой минуты его не дал; точки без строки нет — это дыра в `coverage.gaps`.",
        "required": [
          "ts_ms",
          "atm_iv_bp"
        ],
        "properties": {
          "atm_iv_bp": {
            "$ref": "#/components/schemas/OptionsVolTenors",
            "description": "ATM IV постоянного срока 7, 30 и 90 суток."
          },
          "bf25_bp_30d": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Butterfly 25Δ 30 суток: (колл + пут) / 2 − ATM 30 суток."
          },
          "call25_iv_bp_30d": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "IV колла 25Δ, срок 30 суток."
          },
          "index": {
            "type": [
              "string",
              "null"
            ],
            "description": "Индекс базы кадра точной десятичной строкой (первой строки кадра, где он есть); `null` —\nплощадка индекс не шлёт (OKX)."
          },
          "put25_iv_bp_30d": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "IV пута 25Δ, срок 30 суток, целым (0,01 пункта волатильности)."
          },
          "rr25_bp_30d": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Risk reversal 25Δ 30 суток: колл − пут."
          },
          "ts_ms": {
            "type": "integer",
            "format": "int64",
            "description": "Граница шага — начало минуты точки, Unix-мс UTC."
          }
        }
      },
      "OptionsVolTenors": {
        "type": "object",
        "description": "IV постоянного срока 7, 30 и 90 суток — целым, 0,01 пункта волатильности (1 % = 100):\nинтерполяция полной дисперсии σ²·t между экспирациями вокруг срока. `null` — срока нет в\nцепочке (нет экспирации дальше или ближе него), а не экстраполяция.",
        "properties": {
          "d30": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          },
          "d7": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          },
          "d90": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          }
        }
      },
      "PlanRef": {
        "type": "object",
        "description": "Тариф, к которому привязан ключ (`plan` ответа verify) — для журнала и кабинета.",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          }
        }
      },
      "Rows": {
        "type": "object",
        "description": "Ряды колонками (CONTRACTS §2).",
        "required": [
          "columns",
          "rows"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Имена колонок по порядку."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Курсор следующей страницы; `null` — страниц больше нет. Передайте как `cursor=`."
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            },
            "description": "Строки; значения в порядке `columns`. Время — Unix-мс UTC."
          }
        }
      },
      "SeriesResponse": {
        "type": "object",
        "required": [
          "instrument",
          "tf",
          "columns",
          "rows"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "ts",
              "open",
              "high",
              "low",
              "close",
              "volume"
            ]
          },
          "coverage": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/Coverage",
                "description": "Только у свечей: что вообще есть в хранилище."
              }
            ]
          },
          "deep_until": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Только у свечей: шов глубокого яруса (свечи бирж с листинга), Unix-мс, правый край\nисключён. Приходит у любого символа, у которого есть свечи склада, и в живом окне, целиком\nправее шва: поле не значит, что на странице есть `null`. `null` — только у строк с\n`ts < deep_until`: базового объёма и стороны там нет — `volume`, `buy_volume`,\n`buy_quote_volume`, `buy_trades` — `null` (не ноль), `trades` — `null`, если биржа не даёт\nчисло сделок (`0` при обороте: OKX, Bybit); `quote_volume` и OHLC — числа.\n`4294967295000` — весь ряд из свечей склада. У суммы площадок — самый поздний шов набора.\nНет поля — у символа нет глубокого яруса.",
            "example": 1705449600000
          },
          "instrument": {
            "type": "string",
            "example": "binance:perp:BTCUSDT"
          },
          "instruments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Только у суммы площадок (`instruments=`): набор по порядку бит `venues_mask`."
          },
          "instruments_present": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Только у суммы: площадки, которые есть хоть в одной точке страницы."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "price_anchor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Только у свечей суммы: чья цена в open/high/low/close (первый инструмент запроса)."
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            },
            "example": [
              [
                1791331200000,
                62000.5,
                62010.0,
                61990.0,
                62005.1,
                12.5
              ]
            ]
          },
          "tf": {
            "type": "string",
            "example": "1m"
          }
        }
      },
      "SnapshotResponse": {
        "type": "object",
        "required": [
          "ts",
          "columns",
          "rows"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            }
          },
          "ts": {
            "type": "integer",
            "format": "int64",
            "description": "Момент снимка, Unix-мс."
          }
        }
      },
      "StatusResponse": {
        "type": "object",
        "required": [
          "ok",
          "ts",
          "upstreams"
        ],
        "properties": {
          "ok": {
            "type": "boolean",
            "description": "Все обязательные источники (`required: true`) отвечают."
          },
          "ts": {
            "type": "integer",
            "format": "int64",
            "description": "Когда проверялось, Unix-мс."
          },
          "upstreams": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UpstreamHealth"
            }
          }
        }
      },
      "SumFx": {
        "type": "object",
        "description": "Слагаемое суммы по цене с котировкой не USDT: clusters перевёл его цены в USDT по курсу окна\n(футпринт) или минуты колонки (heatmap).",
        "required": [
          "instrument",
          "quote",
          "invert",
          "column"
        ],
        "properties": {
          "column": {
            "type": "string",
            "description": "Колонка курса в строках окон (футпринт) и кадров (heatmap); значение null — курса нет,\nслагаемого в окне нет (бит маски 0), а не курс 1.",
            "example": "fx:coinbase:spot:BTC-USD"
          },
          "instrument": {
            "type": "string",
            "description": "Слагаемое — элемент `instruments`.",
            "example": "coinbase:spot:BTC-USD"
          },
          "invert": {
            "type": "boolean",
            "description": "`true` — цена в USDT = цена / курс (курс — USDT в долларах), `false` — цена × курс (курс —\nUSDC в USDT)."
          },
          "quote": {
            "type": "string",
            "description": "Котировка слагаемого: `USD` или `USDC`.",
            "example": "USD"
          }
        }
      },
      "TapeEventsResponse": {
        "type": "object",
        "description": "`/v1/tape/events`: события колонками, у каждой колонки `n` значений, по `first_ms`, затем `id`.",
        "required": [
          "exchange",
          "market_type",
          "symbol",
          "n",
          "units_revision",
          "det_rev",
          "limit",
          "truncated",
          "id",
          "kind",
          "side",
          "state",
          "end",
          "price_first",
          "price_last",
          "price_lo",
          "price_hi",
          "price_scale",
          "qty_scale",
          "first_ms",
          "last_ms",
          "dur_ms",
          "hits",
          "trades",
          "levels",
          "qty_side",
          "qty_counter",
          "usd_side_e8",
          "usd_counter_e8",
          "usd_max_hit_e8",
          "move_ticks",
          "move_bp",
          "speed_bp_s",
          "impact_bp_per_musd",
          "score",
          "run_id",
          "link_ice_id",
          "actor",
          "quality",
          "source"
        ],
        "properties": {
          "actor": {
            "type": "array",
            "items": {
              "type": [
                "string",
                "null"
              ]
            },
            "description": "Адрес тейкера Hyperliquid; `null` — нет (у прочих площадок всегда).",
            "example": [
              null
            ]
          },
          "asof_ms": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Знак склада источника (Unix-мс): до него события записаны; от него считается потеря\n(`end = lost`). `null` — знака ещё нет, и потерь тогда нет.",
            "example": 1791334785000
          },
          "det_rev": {
            "type": "integer",
            "format": "int32",
            "description": "Версия правил поисковика: наибольшая у событий ответа, у пустого — текущая.",
            "example": 1,
            "minimum": 0
          },
          "dur_ms": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Длительность, мс.",
            "example": [
              2150
            ]
          },
          "end": {
            "type": "array",
            "items": {
              "type": [
                "string",
                "null"
              ]
            },
            "description": "Чем кончилось: `gap`, `reversal`, `counter`, `max_dur`, `absorbed`, `reset`, у уровня —\nитог `held` или `broke`; `lost` — событие потеряно (`state = open`, закрытие должно было\nприйти давно). `null` — причины нет: у удара (`hit`) всегда, у серии и уровня — пока\n`state = open`.",
            "example": [
              "gap"
            ]
          },
          "exchange": {
            "type": "string",
            "description": "Площадка источника — родное имя clusters (`BINANCEF` у перпа Binance), а не `instrument`.",
            "example": "BINANCEF"
          },
          "first_ms": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Первая печать, Unix-мс часов биржи.",
            "example": [
              1791331201250
            ]
          },
          "hits": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            },
            "description": "Ударов в событии.",
            "example": [
              7
            ]
          },
          "id": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Ключ события (UInt64) строкой: стабилен у события, по нему открытое событие сменяется\nсвоим обновлением.",
            "example": [
              "18446744073709551615"
            ]
          },
          "impact_bp_per_musd": {
            "type": "array",
            "items": {
              "type": [
                "number",
                "null"
              ],
              "format": "double"
            },
            "description": "Сдвиг цены на миллион долларов, б. п.; `null` — не считается (денег меньше 1 000 $).",
            "example": [
              0.62
            ]
          },
          "kind": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "`hit`, `run` или `level`.",
            "example": [
              "run"
            ]
          },
          "last_ms": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Последняя печать.",
            "example": [
              1791331203400
            ]
          },
          "levels": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            },
            "description": "Уровней цены, которые прошло событие.",
            "example": [
              12
            ]
          },
          "limit": {
            "type": "integer",
            "format": "int32",
            "description": "Действующий потолок событий: присланный `limit`, урезанный до 50 000, или умолчание\nисточника (5 000).",
            "example": 5000,
            "minimum": 0
          },
          "link_ice_id": {
            "type": "array",
            "items": {
              "type": [
                "string",
                "null"
              ]
            },
            "description": "Эпизод айсберга у той же цены и стороны (строкой); `null` — нет.",
            "example": [
              null
            ]
          },
          "market_type": {
            "type": "string",
            "description": "Вид рынка источника (`perp`, `spot`).",
            "example": "perp"
          },
          "move_bp": {
            "type": "array",
            "items": {
              "type": "number",
              "format": "double"
            },
            "description": "Ход цены, б. п., число с 2 знаками.",
            "example": [
              1.85
            ]
          },
          "move_ticks": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Ход цены в шагах цены, со знаком стороны.",
            "example": [
              115
            ]
          },
          "n": {
            "type": "integer",
            "format": "int64",
            "description": "Событий в ответе — длина каждой колонки; `0` — честный пустой ответ.",
            "example": 1,
            "minimum": 0
          },
          "price_first": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Цена первой печати, целым в шкале цены строки.",
            "example": [
              620005
            ]
          },
          "price_hi": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Верх цены события.",
            "example": [
              620130
            ]
          },
          "price_last": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Цена последней печати.",
            "example": [
              620120
            ]
          },
          "price_lo": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Низ цены события.",
            "example": [
              620005
            ]
          },
          "price_scale": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            },
            "description": "Шкала цены строки: цена = целое / 10^шкала.",
            "example": [
              1
            ]
          },
          "qty_counter": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Количество встречной стороны.",
            "example": [
              3100
            ]
          },
          "qty_scale": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            },
            "description": "Шкала количества строки.",
            "example": [
              3
            ]
          },
          "qty_side": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "description": "Количество стороны агрессора, целым в шкале количества строки.",
            "example": [
              48250
            ]
          },
          "quality": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            },
            "description": "Биты честности: 1 сделки потеряны, 2 нет id сделки, 4 склейка по цене, 8 нет времени\nбиржи, 16 профиль холодный, 32 ликвидация, 64 часы биржи сдвинуты.",
            "example": [
              0
            ]
          },
          "run_id": {
            "type": "array",
            "items": {
              "type": [
                "string",
                "null"
              ]
            },
            "description": "Серия, которую закрыл уровень (строкой); `null` — нет.",
            "example": [
              null
            ]
          },
          "score": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            },
            "description": "Сила события, 0–1000: перцентиль метрики в профиле символа × 1000; у серии — меньший из\nперцентилей денег и хода. `0` — профиль холодный.",
            "example": [
              995
            ]
          },
          "side": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "`buy` или `sell` — сторона агрессора; у уровня — преобладающая.",
            "example": [
              "buy"
            ]
          },
          "source": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "`live` — живой проход, `archive` — дозалив из архива.",
            "example": [
              "live"
            ]
          },
          "speed_bp_s": {
            "type": "array",
            "items": {
              "type": [
                "number",
                "null"
              ],
              "format": "double"
            },
            "description": "Скорость хода, б. п./с; `null` — не считается.",
            "example": [
              0.86
            ]
          },
          "state": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "`open` или `closed`. Потерянное событие (закрытие не дошло) — `open` с `end = lost`:\nстрока источника не переписывается. Кончилось ли событие, говорит `state`, а не `end`.",
            "example": [
              "closed"
            ]
          },
          "symbol": {
            "type": "string",
            "description": "Символ источника (`BTCUSDT`; Hyperliquid — `BTCUSDC`).",
            "example": "BTCUSDT"
          },
          "trades": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            },
            "description": "Сделок в событии.",
            "example": [
              212
            ]
          },
          "truncated": {
            "type": "boolean",
            "description": "Найдено больше `limit`: отданы первые по `first_ms` — дочитывайте следующим запросом с\n`from` от последнего `first_ms`, отбросив уже полученные `id`."
          },
          "units_revision": {
            "type": "integer",
            "format": "int32",
            "description": "Ревизия единиц источника (сейчас 1: деньги — e8 USD строкой, цены и количества — целые в\nшкалах строки, ход — б. п. числом).",
            "example": 1,
            "minimum": 0
          },
          "usd_counter_e8": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Деньги встречной стороны, e8 USD строкой.",
            "example": [
              "19221550000000"
            ]
          },
          "usd_max_hit_e8": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Деньги крупнейшего удара события, e8 USD строкой.",
            "example": [
              "74400600000000"
            ]
          },
          "usd_side_e8": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Деньги стороны агрессора, e8 USD точным целым строкой (может быть больше 2⁵³).",
            "example": [
              "299158412500000"
            ]
          }
        }
      },
      "TapeProfileResponse": {
        "type": "object",
        "description": "`/v1/tape/profile`: квантили метрики символа по последнему снимку профиля. Значения — ровно в\nодном из `values_e8`, `values_bp`, `values_ms` (по `unit`), по порядку `quantiles`.",
        "required": [
          "exchange",
          "market_type",
          "symbol",
          "metric",
          "unit",
          "units_revision",
          "samples",
          "quantiles"
        ],
        "properties": {
          "exchange": {
            "type": "string",
            "description": "Площадка источника — родное имя clusters (`BINANCEF`)."
          },
          "market_type": {
            "type": "string",
            "description": "Вид рынка источника."
          },
          "metric": {
            "type": "string",
            "description": "Метрика запроса: `hit_usd`, `run_usd`, `level_usd`, `run_move_bp`, `hit_gap_ms`,\n`trade_gap_ms`.",
            "example": "hit_usd"
          },
          "quantiles": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Имена квантилей по порядку значений: `p50`, `p90`, `p99`, `p99_5`.",
            "example": [
              "p50",
              "p90",
              "p99",
              "p99_5"
            ]
          },
          "samples": {
            "type": "integer",
            "format": "int64",
            "description": "Замеров в снимке (после распада пополам за сутки); `0` — снимка нет.",
            "example": 48210,
            "minimum": 0
          },
          "symbol": {
            "type": "string",
            "description": "Символ источника."
          },
          "ts_ms": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Часы биржи снимка, Unix-мс (снимок почасовой); `null` — снимка нет.",
            "example": 1791334800000
          },
          "unit": {
            "$ref": "#/components/schemas/TapeUnit"
          },
          "units_revision": {
            "type": "integer",
            "format": "int32",
            "description": "Ревизия единиц источника (сейчас 1).",
            "example": 1,
            "minimum": 0
          },
          "values_bp": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "number",
                "null"
              ],
              "format": "double"
            },
            "description": "У `unit = bp`: б. п. числом с двумя знаками; `null` — замеров нет.",
            "example": [
              2.5,
              9.75,
              31.25,
              42.0
            ]
          },
          "values_e8": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "string",
                "null"
              ]
            },
            "description": "У `unit = usd_e8`: нижние границы корзин квантилей, e8 USD точным целым строкой; `null` —\nзамеров нет.",
            "example": [
              "1856203364",
              "26777611724",
              "362038671012",
              "430537357846"
            ]
          },
          "values_ms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "integer",
                "null"
              ],
              "format": "int64",
              "minimum": 0
            },
            "description": "У `unit = ms`: мс целым; `null` — замеров нет.",
            "example": [
              120,
              1500,
              14000,
              22000
            ]
          }
        },
        "example": {
          "exchange": "BINANCEF",
          "market_type": "perp",
          "metric": "hit_usd",
          "quantiles": [
            "p50",
            "p90",
            "p99",
            "p99_5"
          ],
          "samples": 48210,
          "symbol": "BTCUSDT",
          "ts_ms": 1791334800000,
          "unit": "usd_e8",
          "units_revision": 1,
          "values_e8": [
            "1856203364",
            "26777611724",
            "362038671012",
            "430537357846"
          ]
        }
      },
      "TapeUnit": {
        "type": "string",
        "description": "Единица значений профиля — в каком из `values_*` они лежат: `usd_e8` — деньги (`hit_usd`,\n`run_usd`, `level_usd`), `values_e8`, e8 USD строкой; `bp` — ход (`run_move_bp`), `values_bp`,\nб. п. числом с двумя знаками; `ms` — промежутки (`hit_gap_ms`, `trade_gap_ms`), `values_ms`,\nмс целым.",
        "enum": [
          "usd_e8",
          "bp",
          "ms"
        ]
      },
      "TradesResponse": {
        "type": "object",
        "required": [
          "instrument",
          "source_min_usd",
          "columns",
          "rows"
        ],
        "properties": {
          "columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "t",
              "price",
              "qty",
              "quote_qty",
              "side",
              "aggregated",
              "fills",
              "trade_id",
              "seq"
            ]
          },
          "instrument": {
            "type": "string"
          },
          "min_usd": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "description": "Порог из запроса, $; null — не задан."
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {}
            }
          },
          "source": {
            "type": [
              "string",
              "null"
            ],
            "description": "Из какого слоя ответ: `hot` или `archive`.",
            "example": "hot"
          },
          "source_min_usd": {
            "description": "Порог слоя в $: сделки мельче в этом слое НЕ хранятся (архив — 5000; у горячего 0 —\nно и там записаны только сделки от порога символа, $200–$5000 по обороту)."
          }
        }
      },
      "UpstreamHealth": {
        "type": "object",
        "required": [
          "name",
          "ok",
          "required",
          "latency_ms"
        ],
        "properties": {
          "http_status": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Код ответа на проверку здоровья; `null` — ответа не было.",
            "minimum": 0
          },
          "latency_ms": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "name": {
            "type": "string",
            "example": "data"
          },
          "ok": {
            "type": "boolean"
          },
          "required": {
            "type": "boolean",
            "description": "Входит ли источник в общий `ok`: `false` — необязательный (позиции Hyperliquid\n`hl_positions`: его проверка гаснет и на несвежей минуте книги), его `ok: false` — только\nо его маршрутах."
          }
        }
      },
      "UsageResponse": {
        "type": "object",
        "description": "`GET /v1/usage` — тариф и живое состояние лимитов по своему ключу.",
        "required": [
          "tier",
          "limits",
          "routes",
          "today",
          "now"
        ],
        "properties": {
          "limits": {
            "$ref": "#/components/schemas/KeyLimits",
            "description": "Общие лимиты аккаунта: 0 — без ограничения."
          },
          "now": {
            "$ref": "#/components/schemas/NowBlock"
          },
          "plan": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/PlanRef",
                "description": "Тариф ключа; `null` — вход по JWT или старое облако без `plan`."
              }
            ]
          },
          "routes": {
            "type": "object",
            "description": "Лимиты групп маршрутов из тарифа — как их применяет шлюз.",
            "additionalProperties": {
              "$ref": "#/components/schemas/UsageRouteLimits"
            },
            "propertyNames": {
              "type": "string"
            }
          },
          "tier": {
            "type": "string",
            "example": "pro"
          },
          "today": {
            "$ref": "#/components/schemas/UsageToday"
          }
        }
      },
      "UsageRouteLimits": {
        "type": "object",
        "description": "Лимиты группы маршрутов, как их применяет шлюз. `enabled` — открыта ли группа на деле (у\nтарифа нет флага — открыта); лимит `null` — «как в общем», 0 — без ограничения в группе.\nЗапись, которую шлюз не разобрал, показывается так, как он её держит: `enabled: false`, все\nлимиты `null` — запросы группы получают `403 route_not_in_plan`. Без записи клиент читал бы\nгруппу открытой по общим лимитам.",
        "required": [
          "enabled"
        ],
        "properties": {
          "daily_bytes": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "minimum": 0
          },
          "enabled": {
            "type": "boolean"
          },
          "history_days": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0
          },
          "rpd": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "minimum": 0
          },
          "rph": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "minimum": 0
          },
          "rpm": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0
          }
        }
      },
      "UsageToday": {
        "type": "object",
        "description": "Расход за сутки UTC — те же счётчики, по которым шлюз отказывает.",
        "required": [
          "day",
          "requests",
          "bytes"
        ],
        "properties": {
          "bytes": {
            "type": "integer",
            "format": "int64",
            "description": "Отданных байт (до сжатия).",
            "minimum": 0
          },
          "day": {
            "type": "string",
            "example": "2026-11-04"
          },
          "requests": {
            "type": "integer",
            "format": "int64",
            "description": "Запросов, засчитанных в окна (отказы 429/403 тарифа не входят).",
            "minimum": 0
          }
        }
      },
      "WindowNow": {
        "type": "object",
        "description": "Окно лимита сейчас. `limit: null` и `remaining: null` — без ограничения (0 в тарифе).",
        "required": [
          "scope",
          "window",
          "used",
          "reset_at_ms"
        ],
        "properties": {
          "burst": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Только у `minute`: ёмкость ведра (сколько можно подряд). `used = burst − remaining`.",
            "minimum": 0
          },
          "limit": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Потолок: запросов в минуту (у `minute` — установившаяся скорость), в час, в сутки;\nу `bytes_day` — байт в сутки.",
            "minimum": 0
          },
          "remaining": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "У `minute` — целые жетоны сейчас, с пополнением.",
            "minimum": 0
          },
          "reset_at_ms": {
            "type": "integer",
            "format": "int64",
            "description": "Когда окно сбросится (`minute` — когда ведро снова полное), Unix-мс UTC."
          },
          "scope": {
            "type": "string",
            "description": "`account` | `route:<группа>`.",
            "example": "account"
          },
          "used": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "window": {
            "type": "string",
            "description": "`minute` | `hour` | `day` | `bytes_day`.",
            "example": "minute"
          }
        }
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Неверный запрос: параметр не разобрался (`param`, `expected`), неизвестный формат. Коды — https://docs.lootx.trade/ru/market-api/error-codes",
        "headers": {
          "X-Request-Id": {
            "schema": {
              "type": "string"
            },
            "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorBody"
            },
            "example": {
              "error": {
                "code": "bad_request",
                "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#bad_request",
                "expected": "целое число",
                "message": "параметр limit: invalid digit found in string",
                "param": "limit",
                "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
              }
            }
          }
        }
      },
      "Forbidden": {
        "description": "Ключ отозван, тариф не активен, нет области, группа не в тарифе, история глубже тарифа (`history_days`, `earliest_allowed_ms`)",
        "headers": {
          "RateLimit": {
            "schema": {
              "type": "string"
            },
            "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
          },
          "RateLimit-Policy": {
            "schema": {
              "type": "string"
            },
            "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
          },
          "X-RateLimit-Limit": {
            "schema": {
              "type": "integer"
            },
            "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
          },
          "X-RateLimit-Remaining": {
            "schema": {
              "type": "integer"
            },
            "description": "Остаток самого тесного окна"
          },
          "X-RateLimit-Reset": {
            "schema": {
              "type": "integer"
            },
            "description": "Сброс самого тесного окна, Unix-секунды"
          },
          "X-RateLimit-Scope": {
            "schema": {
              "type": "string"
            },
            "description": "Чьё окно: `account` или `route:<группа>`"
          },
          "X-RateLimit-Window": {
            "schema": {
              "type": "string"
            },
            "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
          },
          "X-Request-Id": {
            "schema": {
              "type": "string"
            },
            "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorBody"
            },
            "example": {
              "error": {
                "code": "route_not_in_plan",
                "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#route_not_in_plan",
                "message": "группа heatmap не входит в тариф basic",
                "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                "scope": "route:heatmap"
              }
            }
          }
        }
      },
      "NotFound": {
        "description": "Нет такого маршрута",
        "headers": {
          "X-Request-Id": {
            "schema": {
              "type": "string"
            },
            "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorBody"
            },
            "example": {
              "error": {
                "code": "not_found",
                "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#not_found",
                "message": "нет такого маршрута; список — /v1/openapi.json",
                "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
              }
            }
          }
        }
      },
      "TooManyRequests": {
        "description": "Лимит: `rate_limited` (минута; `scope: ip`, `window: second` — предохранитель nginx по адресу до проверки ключа), `hourly_limit`, `daily_limit`, `daily_quota_exceeded` (байты); повтор — через `Retry-After`. Окна и заголовки — https://docs.lootx.trade/ru/market-api/limits#zagolovki",
        "headers": {
          "RateLimit": {
            "schema": {
              "type": "string"
            },
            "description": "IETF: остаток и секунд до сброса по окнам, например `\"minute\";r=412;t=12, \"day\";r=45000;t=3600`"
          },
          "RateLimit-Policy": {
            "schema": {
              "type": "string"
            },
            "description": "IETF draft-ietf-httpapi-ratelimit-headers: все окна тарифа запроса, например `\"minute\";q=600;w=60, \"day\";q=50000;w=86400, \"bytes_day\";q=10737418240;w=86400;qu=\"content-bytes\"`"
          },
          "Retry-After": {
            "schema": {
              "type": "integer"
            },
            "description": "Через сколько секунд повторить"
          },
          "X-RateLimit-Limit": {
            "schema": {
              "type": "integer"
            },
            "description": "Потолок самого тесного окна (запросов; у минуты — в минуту)"
          },
          "X-RateLimit-Remaining": {
            "schema": {
              "type": "integer"
            },
            "description": "Остаток самого тесного окна"
          },
          "X-RateLimit-Reset": {
            "schema": {
              "type": "integer"
            },
            "description": "Сброс самого тесного окна, Unix-секунды"
          },
          "X-RateLimit-Scope": {
            "schema": {
              "type": "string"
            },
            "description": "Чьё окно: `account` или `route:<группа>`"
          },
          "X-RateLimit-Window": {
            "schema": {
              "type": "string"
            },
            "description": "Окно: `minute` | `hour` | `day` | `bytes_day`"
          },
          "X-Request-Id": {
            "schema": {
              "type": "string"
            },
            "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorBody"
            },
            "example": {
              "error": {
                "code": "rate_limited",
                "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#rate_limited",
                "limit": 600,
                "message": "лимит 600 запросов в минуту исчерпан",
                "remaining": 0,
                "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                "reset_at_ms": 1762257612000,
                "retry_after": 1,
                "scope": "account",
                "window": "minute"
              }
            }
          }
        }
      },
      "Unauthorized": {
        "description": "Нет ключа или ключ неизвестен; заголовок `WWW-Authenticate: Bearer realm=\"lootx\"`",
        "headers": {
          "WWW-Authenticate": {
            "schema": {
              "type": "string"
            },
            "description": "`Bearer realm=\"lootx\"`; с негодным ключом — ещё `error=\"invalid_token\"`"
          },
          "X-Request-Id": {
            "schema": {
              "type": "string"
            },
            "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorBody"
            },
            "example": {
              "error": {
                "code": "missing_key",
                "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#missing_key",
                "message": "нужен ключ: заголовок Authorization: Bearer <ключ> или X-API-Key",
                "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718"
              }
            }
          }
        }
      },
      "Unavailable": {
        "description": "Временно недоступно (очередь к источнику, проверка ключа, счётчики лимитов — `usage_unavailable`); повтор — через `Retry-After`. Коды — https://docs.lootx.trade/ru/market-api/error-codes",
        "headers": {
          "Retry-After": {
            "schema": {
              "type": "integer"
            },
            "description": "Через сколько секунд повторить"
          },
          "X-Request-Id": {
            "schema": {
              "type": "string"
            },
            "description": "Идентификатор запроса (свой, если клиент прислал годный, иначе шлюза) — тот же, что `request_id` в теле ошибки"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorBody"
            },
            "example": {
              "error": {
                "code": "upstream_busy",
                "docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#upstream_busy",
                "message": "очередь к источнику полна — повторите позже",
                "request_id": "9f2c4a1be07d4e55a1c3b2d4e5f60718",
                "retry_after": 2
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "bearer": {
        "type": "http",
        "scheme": "bearer",
        "description": "Ключ API: `Authorization: Bearer lx_live_...`"
      },
      "x_api_key": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  },
  "tags": [
    {
      "name": "reference",
      "description": "Справочники и состояние",
      "externalDocs": {
        "url": "https://docs.lootx.trade/ru/market-api/instruments",
        "description": "Инструменты"
      }
    },
    {
      "name": "market",
      "description": "Рыночные данные. Полосы книги (`/v1/book/bands`): сколько долларов стоит в стакане в пределах ±0,1 … ±10 % от mid по окнам (`bands=deep` — ещё ±3, ±8, ±15 % и вся сторона, `null` — «неизвестно») — e8 USD строкой, неполные полосы помечены `complete_*`. HL-футпринт NL/NS (`/v1/hyperliquid/footprint`): изменение лонгов и шортов тейкера и мейкера по уровням цены Hyperliquid, в монетах. Тиковые поисковики ленты (`/v1/tape/events`): удары, серии и уровни одного инструмента за окно колонками — тело источника как есть, деньги — e8 USD точным целым строкой, сила `score` 0–1000; профиль (`/v1/tape/profile`) — квантили метрики символа, по которым дана сила. Группа тарифа — сделки; вес событий — сутки окна, вверх (1–31); закрытое осевшее окно — `immutable`. CSV нет",
      "externalDocs": {
        "url": "https://docs.lootx.trade/ru/market-api/conventions",
        "description": "Соглашения: имена, время, страницы"
      }
    },
    {
      "name": "derivatives",
      "description": "Открытый интерес, фандинг, long/short ratio, mark и index. У long/short колонка `as_of` — момент, к которому относится значение: по ней ряды разных бирж и видов сводятся без сдвига на бакет; объёмы тейкера `buy_vol`/`sell_vol` — строкой, точно. Цены mark и index — строкой, в точности биржи; разбирайте их как decimal, не как float",
      "externalDocs": {
        "url": "https://docs.lootx.trade/ru/market-api/oi-funding",
        "description": "Открытый интерес и фандинг"
      }
    },
    {
      "name": "liquidations",
      "description": "Ликвидации из сервиса data: события, бары, покрытие лент, живая лента. Деньги — `*_e8` строкой (USD × 10⁸); дыра ленты — «не знаем», а не ноль. Позиции Hyperliquid (`/v1/hyperliquid/*`, книга позиций по снимку узла): карта ликвидаций по цене и по минутам (HMP), крупнейшие позиции, киты и их журнал, long/short, покрытие; `fresh` — честная свежесть минуты. Книга TP/SL Hyperliquid (`/v1/hyperliquid/triggers`, по минутам — `/triggers/heatmap`, HMP): неисполненные тейк-профиты и стоп-лоссы всех счетов по уровням цены — монеты, USD и число ордеров по видам `tp_long`/`tp_short`/`sl_long`/`sl_short`; несвежая книга — без строк. Ликвидации Hyperliquid в `/v1/liquidations/*` — из data: `hyperliquid:perp:BTC`, рынок HIP-3 — `hyperliquid:perp:AMZNUSDC.XYZ`. Карт, сводок и прогнозов ликвидаций по data нет — `404 not_available`",
      "externalDocs": {
        "url": "https://docs.lootx.trade/ru/market-api/conventions",
        "description": "Соглашения: имена, время, страницы"
      }
    },
    {
      "name": "margin",
      "description": "Маржинальное кредитование: займы и возвраты пула маржи Binance (кросс и изолированный), чистые займы и их z, запас пула, ставки займа Binance, OKX, Bybit и ставка кредитора Gate, эпизоды «пул пуст», покрытие источников. Деньги — `*_usd_e8` целым строкой (USDT × 10⁸), количества, цены и ставки `rate_apr` — точной десятичной строкой, z и проценты — числом; `null` — «нет данных», а не ноль. Без ключа Binance на узле запас не опрашивается: суммы и запас — `null`, покрытие говорит `no_key`, ставки и цены отвечают",
      "externalDocs": {
        "url": "https://docs.lootx.trade/ru/market-api/margin",
        "description": "Маржинальное кредитование"
      }
    },
    {
      "name": "options",
      "description": "Опционы Deribit, Binance, Bybit и OKX: базы площадок с цепочками (`/bases`), каталог инструментов по цепочкам, экспирации с суммами объёма и OI, цепочка последней минуты и минуты, закрытой в `at` (котировки, mark, `iv_bp` — волатильность в 0,01 пункта, OI на момент `oi_asof_ms`, объёмы, форвард, индекс), история одной цепочки за диапазон до 360 минут (`/chain/range`: кадры цепочки или ряд одного инструмента), покрытие — дыры сбора и лаг цепочек, ряд волатильности одной книги по границам часа (до 90 суток) или суток (до 365; `/vol/book-range`: ATM IV постоянного срока 7, 30 и 90 суток, крылья 25Δ 30 суток, RR, BF, индекс; любое число может быть `null`, дыры — в `coverage.gaps`), экспозиция новейшей минуты книги или суммы площадок `venue=all` (`/exposure/latest`: GEX, DEX, VEX, CEX по страйкам группы экспираций `expiry`, суммы, профиль net GEX, доли площадок; режим `mode=naive`), история уровней одной книги (`/levels/range`: шаг `1m` до 7 суток, `5m` до 30, `1h` до 90; индекс, форвард, zero gamma, стены, abs gamma, net GEX, max pain, ожидаемый ход). Деньги — `*_usd_e8` целым строкой (× 10⁸) в валюте площадки: `volume_usd_e8` — премия за 24 ч (Deribit — USD, Binance — USDT), `volume_notional_usd_e8` — номинал за 24 ч, только Bybit (в монете расчёта: USDT; на `_USDC` — USDC); USDT — не USD. Валюта цепочки — `settle`, `price_ccy` (валюта `bid`, `ask`, `mark`), `volume_usd_ccy`, `volume_notional_ccy` — в каталоге, экспирациях и JSON цепочки; в кадрах OPC1 её нет — она в каталоге и `/bases`. Цены — за 1 монету базы в валюте котировки цепочки (inverse — в монете базы). Цены, страйки и количества — точной десятичной строкой, количества — в контрактах (× `contract_size` — монеты базы); `null` — «нет данных», а не ноль. Время — Unix-мс UTC. JSON — тело источника как есть; у chain, chain/latest и chain/range ещё `format=opc1` — кадры OPC1 насквозь (`application/octet-stream`, только параметром, не по `Accept`). Предварительный формат: версия кадра (байт 4 после магии `OPC1`) может вырасти без смены версии API; клиент обязан отвергать незнакомую версию. JSON и protobuf — стабильны. Чего нет в ответе — в `missing` и в заголовке `x-options-missing`: у chain и chain/latest — цепочки (`ЦЕПОЧКА:причина`), у chain/range — интервалы минут (`FROM_MS-TO_MS:причина`). Каждый ответ с `ETag` (`If-None-Match` — `304`); целая осевшая минута `chain?at=`, целый осевший диапазон `chain/range` и целый ряд `vol/book-range` или `levels/range` с осевшей последней границей — `immutable`, остальное (и `exposure/latest` всегда) — `no-cache`. Вес `chain/range` — час диапазона (1–6 единиц), `vol/book-range` — границы шага на 64, вверх (1–34 единицы), `levels/range` — точки шага на 1440, вверх (1–7 единиц), `exposure/latest` — 1. CSV нет: ответы — вложенные объекты",
      "externalDocs": {
        "url": "https://docs.lootx.trade/ru/market-api/options",
        "description": "Опционы"
      }
    },
    {
      "name": "streams",
      "description": "WebSocket-потоки (бета)",
      "externalDocs": {
        "url": "https://docs.lootx.trade/ru/market-api/websocket",
        "description": "Потоки WebSocket"
      }
    }
  ],
  "externalDocs": {
    "url": "https://docs.lootx.trade/ru/market-api",
    "description": "Документация Market API"
  }
}
