Перейти до вмісту
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

Змінює інструмент стека й графіків його групи. Неактивна вкладка стає активною на час команди.