Перейти к содержимому
Spectre Docs
РуководствоРазработчикам
HTTP APIРабочее пространство

Открыть стек

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

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

Команда
curl -X POST 'http://127.0.0.1:48180/v1/workspace/stacks' \
  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "instrument": "binance:futures:BTCUSDT",
  "connection_id": 25,
  "chart": true,
  "target": "new_tab",
  "window_id": 1,
  "activate": true
}'
POST
/workspace/stacks

Открывает стек инструмента в новой вкладке или в новом окне. Вкладка называется по символу инструмента. Сторона и доля графика берутся из настроек мультивью, но если там выбрано «Без графиков», график всё равно открывается сверху.

Авторизация

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

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

Право: workspace:write

Тело запроса

application/json
  1. body
instrument*string

Инструмент из справочника.

connection_id?integer

Без него терминал берёт торговое подключение биржи и рынка, а если такого нет — подключение только для чтения.

Форматint64
chart?boolean

Открыть ещё и график того же инструмента.

По умолчаниюfalse
target?WorkspaceTarget

new_tab открывает вкладку в окне window_id, а без него — в окне в фокусе. new_window открывает новое окно.

По умолчанию"new_tab"
Значение из"new_tab""new_window"
window_id?integer

Окно для новой вкладки. С new_window не используется.

Форматint64
Диапазон0 <= value
activate?boolean

false открывает вкладку в фоне. Новое окно всегда получает фокус.

По умолчаниюtrue

Тело ответа

Где открылся стек. stacks и charts — виджеты новой вкладки.

application/json
  1. response

Что открыла или затронула команда рабочего пространства. Номера, которых она касается, заполнены. Остальное — null или пусто.

window_id*|
Форматint64
tab_id*|
Форматint64
stacks*array<>
charts*array<>
Пример запроса
curl -X POST 'http://127.0.0.1:48180/v1/workspace/stacks' \  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN" \  -H 'Content-Type: application/json' \  -d '{  "instrument": "binance:futures:BTCUSDT",  "connection_id": 25,  "chart": true,  "target": "new_tab",  "window_id": 1,  "activate": true}'
Пример ответа
{  "window_id": 1,  "tab_id": 2,  "stacks": [    14  ],  "charts": [    15  ]}

Открыть вкладку с инструментами POST

Открывает вкладку с колонкой на каждый элемент `items`, в порядке списка. Без `name` вкладка получает символ первого инструмента и число остальных, если они есть: `BTCUSDT +1`. Сторона и доля графика берутся из настроек мультивью.

Сменить инструмент стека PATCH

Меняет инструмент стека и графиков его группы. Неактивная вкладка становится активной на время команды.