// Lootx Market Data API — бинарный ответ (`?format=protobuf` или // `Accept: application/x-protobuf`). Отдаётся на GET /v1/proto, лежит в SDK. // // Один конверт на ЛЮБОЙ маршрут. JSON-ответ шлюза — объект, в котором есть таблицы // (`columns` + `rows`) и прочие поля; Response — тот же объект, разложенный по колонкам. // Перевод взаимно однозначный: из Response восстанавливается ровно тот же JSON (порядок // ключей объекта не сохраняется — в JSON он и не значим): // // columns, rows верхнего уровня → tables[name = ""] // поле-объект {columns, rows[, next_cursor]} (levels, windows у /v1/footprint) // → tables[name = имя поля] // next_cursor верхнего уровня → next_cursor + paged // всё остальное (instrument, tf, ts, coverage, ...) → meta // // Тип колонки выводится по значениям: целые остаются целыми (sint64, время — Unix-мс UTC), // дробные — double, строки — string. null хранится отдельно номерами строк. // // Ошибки (4xx/5xx) — всегда JSON, в любом формате. syntax = "proto3"; package lootx.v1; // Ответ маршрута. Content-Type: application/x-protobuf; messageType=lootx.v1.Response message Response { // Таблицы ответа. Главная (columns/rows верхнего уровня JSON) — с пустым именем и всегда // первая; вложенные — под именем поля JSON. repeated Table tables = 1; // Прочие поля верхнего уровня JSON. repeated Field meta = 2; // Курсор следующей страницы (поле next_cursor). Не задан — страниц больше нет; передайте // его как `cursor=` в следующий запрос. optional string next_cursor = 3; // true — у ответа есть поле next_cursor (маршрут листается), даже если оно null. bool paged = 4; } // Таблица по колонкам. message Table { // "" — главная таблица ответа; иначе имя поля JSON (levels, windows). string name = 1; // Число строк. uint32 row_count = 2; // Колонки в порядке columns JSON. repeated Column columns = 3; // Курсор вложенной таблицы (её собственное поле next_cursor). У главной не бывает: // её курсор — Response.next_cursor. optional string next_cursor = 4; // true — у вложенной таблицы есть поле next_cursor, даже если оно null. bool paged = 5; } // Какой массив значений заполнен у колонки. enum ColumnType { // Все значения null (или строк нет). Массивы значений пусты, null_rows пуст. COLUMN_TYPE_NULL = 0; // Целые, sint64 — `ints`. Время — Unix-мс UTC. COLUMN_TYPE_INT64 = 1; // Целые больше 2^63-1 — `uints`. COLUMN_TYPE_UINT64 = 2; // Дробные — `doubles`. Если в JSON-колонке вперемешку целые и дробные, номера строк с // целыми — в `int_rows` (такие целые по модулю не больше 2^53, точны в double). COLUMN_TYPE_DOUBLE = 3; // Строки — `strings`. COLUMN_TYPE_STRING = 4; // true/false — `bools`. COLUMN_TYPE_BOOL = 5; // Прочее (массивы, объекты, смесь типов): каждое значение JSON-текстом в `strings`. COLUMN_TYPE_JSON = 6; } // Колонка таблицы. // // Значение строки r (0 <= r < row_count): если r есть в null_rows — null; иначе — очередное // значение из массива, выбранного type. Значений в массиве row_count - len(null_rows). message Column { string name = 1; ColumnType type = 2; // Номера строк (с 0, по возрастанию), где значение null. repeated uint32 null_rows = 3; repeated sint64 ints = 4; repeated uint64 uints = 5; repeated double doubles = 6; repeated string strings = 7; repeated bool bools = 8; // Только у DOUBLE: номера строк (по возрастанию), где в JSON стоит целое число. repeated uint32 int_rows = 9; } // Поле верхнего уровня JSON, не таблица. message Field { string name = 1; oneof value { // JSON null; значение всегда true. bool null_value = 2; bool bool_value = 3; sint64 int_value = 4; // Целое больше 2^63-1. uint64 uint_value = 5; double double_value = 6; string string_value = 7; // Объект или массив — JSON-текстом (coverage, instruments, ...). string json_value = 8; } }