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

Поставить триггерную заявку

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

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

Команда
curl -X POST 'http://127.0.0.1:48180/v1/orders/trigger' \
  -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": "66000",
  "client_key": "sl-42"
}'
POST
/orders/trigger

stop_loss и take_profit ставятся на открытую позицию и принимают только trigger_price. Для stop нужны свои side и notional. Без rule стоп на покупку срабатывает выше рынка, а стоп на продажу — ниже.

Авторизация

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.

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

Десятичная строка.

side?string

Только для stop.

Значение из"buy""sell"
notional?string

Только для stop: сумма в валюте котировки.

rule?TriggerRule
Значение из"price_above_or_equal""price_below_or_equal"
client_key?string

Ключ идемпотентности, как в POST /orders.

Тело ответа

Терминал принял команду.

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/orders/trigger' \  -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": "66000",  "client_key": "sl-42"}'
Пример ответа
{  "accepted": true,  "operation_id": "173029440000000005",  "key": "sl_17302944001230005",  "connection_id": 12,  "instrument": "binance:futures:BTCUSDT"}

Закрыть позицию POST

Закрывает позицию по инструменту так, как это делает окно. На фьючерсах отправляет рыночную заявку на размер позиции. На споте снимает все заявки и закрывает позицию одной командой.

Снять все триггерные заявки POST

Снимает триггерные заявки одного инструмента. Обычные заявки не затрагиваются. Их снимает `POST /orders/cancel-all`.