Перейти к содержимому
HTTP APIНастройки

Строки настроек

Собрать запрос

Меняйте значения — команда меняется следом. Токен здесь не вводится: команда берёт его из переменной окружения SPECTRE_LOCAL_API_TOKEN. Запускайте её в своей командной строке.

Команда
curl 'http://127.0.0.1:48180/v1/settings?category=multiview' \
  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
GET
/settings

Строки, как они хранятся, без подстановки умолчаний, в порядке scope, scope_id, category, key. Строки global относятся ко всему терминалу, а строки order_book хранят настройки стакана инструмента или их умолчания. writable равен false у плеча, у trading/leverage_mode и у служебных строк окна.

Авторизация

bearerToken settings:read
headerАвторизацияBearer <token>

Токен Local API: spt_ и 64 шестнадцатеричных символа. Скопируйте его в Settings App → Общие → Local API. Он принимается только в заголовке Authorization. Имена, перечисленные у операции, — это права, которые ей нужны. У токена терминала есть все.

Право: settings:read

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

scope?string

С instrument область всегда order_book.

По умолчанию"global"
Значение из"global""order_book"
category?string

Фильтр по категории.

key?string

Фильтр по ключу.

connection_id?integer

Строки этого подключения. Без него — строки, не принадлежащие никакому подключению.

Форматint64
instrument?string

Строки этой пары.

Тело ответа

Строки.

application/json
  1. response
data*array<>
Пример запроса
curl 'http://127.0.0.1:48180/v1/settings?category=multiview' \  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
Пример ответа
{  "data": [    {      "scope": "global",      "scope_id": "default",      "connection_id": null,      "category": "multiview",      "key": "stack_width_px",      "value": 250,      "writable": true    }  ]}

Открыть монету на всех биржах POST

Открывает монету так, как это делает кнопка «Мультивью» в окне. Учитываются строки «Раскладки бирж», их переключатели стакана и графика и валюта котировки каждой биржи. Без `target` вкладка открывается так, как задано настройкой мультивью «Открывать».

Изменить настройки PATCH

До 100 изменений в запросе. Сначала проверяются все, затем они применяются по порядку. Если изменение не применилось, список на нём останавливается, а ответ называет его номер: `changes[2]: …`. Уже применённые изменения не откатываются. Изменение адресуется так: - `scope` по умолчанию равен `global`. С `instrument` область всегда `order_book`. - `instrument` адресует строку пары. `connection_id` тогда выбирается по общему правилу. - Для `order_book` без `instrument` поле `connection_id` адресует умолчание этого подключения. Без него изменение идёт в глобальное умолчание. - `connection_id` не принимается для `global`. Некоторые ключи обрабатываются по-своему. `appearance/theme` принимает объект с любым набором из `stack`, `graphic` и `interface`. Каждое значение — имя темы, а `graphic` и `interface` принимают только `light` и `dark`. `hotkeys_*` принимают `{ "code", "modifiers" }` или `null`. Сочетание, занятое другим действием, отклоняется. `appearance/font_family` и `localization/current_language` тоже обрабатываются по-своему. Лимит — 5 запросов в секунду на всех клиентов вместе.