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