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

Закрити позицію

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

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

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

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

Авторизація

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.

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

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

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/positions/close' \  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN" \  -H 'Content-Type: application/json' \  -d '{  "connection_id": 12,  "instrument": "binance:futures:BTCUSDT"}'
Приклад відповіді
{  "accepted": true,  "operation_id": "173029440000000004",  "key": "t-173029440000000004",  "connection_id": 12,  "instrument": "binance:futures:BTCUSDT"}

Скасувати заявку DELETE

Надсилає скасування на біржу. Підтвердження надходить у стрімі.

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

`stop_loss` і `take_profit` ставляться на відкриту позицію й приймають лише `trigger_price`. `stop` потребує власних `side` і `notional`. Без `rule` стоп на купівлю спрацьовує вище ринку, а стоп на продаж — нижче.