Перейти до вмісту
HTTP APIТригерні заявки

Змінити тригерну ціну

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

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

Команда
curl -X PATCH 'http://127.0.0.1:48180/v1/orders/trigger/42' \
  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "connection_id": 12,
  "instrument": "binance:futures:BTCUSDT",
  "kind": "stop_loss",
  "trigger_price": "65500"
}'
PATCH
/orders/trigger/{id}

Встановлює нову тригерну ціну. Термінал скасовує попередній тригер і ставить новий, як це робить вікно. Для stop потрібен ще й side.

Авторизація

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

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

Право: trading:write

Параметри шляху

id*string

Числовий id тригера з GET /account/orders. Ключ на кшталт t-… або sl_… не приймається.

Match^[0-9]+$

Тіло запиту

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

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

kind*TriggerKind
Значення з"stop_loss""take_profit""stop"
trigger_price*string

Нова тригерна ціна.

side?string

Лише для stop.

Значення з"buy""sell"
rule?TriggerRule
Значення з"price_above_or_equal""price_below_or_equal"

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

Термінал прийняв команду. 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 PATCH 'http://127.0.0.1:48180/v1/orders/trigger/42' \  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN" \  -H 'Content-Type: application/json' \  -d '{  "connection_id": 12,  "instrument": "binance:futures:BTCUSDT",  "kind": "stop_loss",  "trigger_price": "65500"}'
Приклад відповіді
{  "accepted": true,  "operation_id": "173029440000000008",  "key": null,  "connection_id": 12,  "instrument": "binance:futures:BTCUSDT"}