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

Встановити плече

Зібрати запит

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

Команда
curl -X POST 'http://127.0.0.1:48180/v1/account/leverage' \
  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "connection_id": 12,
  "instrument": "binance:futures:BTCUSDT",
  "leverage": 20
}'
POST
/account/leverage

Встановлює фіксоване плече або режим плеча. Передайте рівно одне з leverage і mode. Застосоване значення видно в GET після відповіді біржі.

Авторизація

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

Токен Local API: spt_ і 64 шістнадцяткові символи. Скопіюйте його в Settings App → Загальні → Local API. Він приймається лише в заголовку Authorization. Назви, перелічені біля операції, — це права, яких вона потребує. Токен термінала має їх усі.

Право: trading:write

Тіло запиту

application/json
  1. body
connection_id*integer
Форматint64
instrument*string

Адреса інструмента, exchange:market:symbol.

leverage?integer

Фіксоване плече. Рівно одне з leverage і mode.

Діапазон1 <= value
mode?string

Режим плеча термінала. Рівно одне з leverage і mode.

Значення з"max""smart"

Тіло відповіді

Термінал прийняв команду. key дорівнює null.

application/json
  1. response

Відповідь на кожну торгову команду, команду тригера і команду плеча.

accepted*boolean

Прийнято терміналом, а не біржею.

operation_id*string

Ідентифікатор операції в журналі торгових операцій термінала. Ключ поставленої заявки — це t- і цей ідентифікатор.

key*|

Ключ поставленої заявки, t-…, або поставленого тригера: sl_…, tp_… чи stop_…. null для скасувань, змін і плеча.

connection_id*integer
Форматint64
instrument*string
curl -X POST 'http://127.0.0.1:48180/v1/account/leverage' \  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN" \  -H 'Content-Type: application/json' \  -d '{  "connection_id": 12,  "instrument": "binance:futures:BTCUSDT",  "leverage": 20}'
Приклад відповіді
{  "accepted": true,  "operation_id": "173029440000000009",  "key": null,  "connection_id": 12,  "instrument": "binance:futures:BTCUSDT"}

Плече і режим маржі GET

Плече, яке термінал завантажив для інструмента. Воно завантажується, коли інструмент вибирають у вікні або коли плече встановлюють через `POST`. До того відповідь — `409 not_active`.

Встановити режим маржі POST

Біржа відхиляє зміну, поки позиція відкрита. Відповідь `accepted` цього не показує.