Поставити заявку
Зібрати запит
Змінюйте значення — команда змінюється слідом. Токен тут не вводиться: команда бере його зі змінної оточення SPECTRE_LOCAL_API_TOKEN. Запускайте її у своєму командному рядку.
curl -X POST 'http://127.0.0.1:48180/v1/orders' \
-H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"connection_id": 12,
"instrument": "binance:futures:BTCUSDT",
"side": "buy",
"type": "limit",
"price": "67000.1",
"size": "0.012",
"reduce_only": false,
"post_only": false,
"time_in_force": "gtc",
"client_key": "bot-42"
}'Ставить лімітну або ринкову заявку. Повтор із тим самим client_key повертає попередню відповідь і не ставить другої заявки. Термінал пам’ятає останні 1000 ключів.
bearerToken trading:writeАвторизаціяBearer <token>Токен Local API: spt_ і 64 шістнадцяткові символи. Скопіюйте його в Settings App → Загальні → Local API. Він приймається лише в заголовку Authorization. Назви, перелічені біля операції, — це права, яких вона потребує. Токен термінала має їх усі.
Право: trading:write
application/json- body
connection_id*integerint64instrument*stringАдреса інструмента, exchange:market:symbol.
side*string"buy""sell"type*stringЛімітна заявка потребує price. Ринкова заявка ціни не приймає.
"limit""market"price?stringДесятковий рядок.
size?stringРозмір у базовій монеті. Рівно одне з size і notional.
notional?stringСума у валюті котирування. Рівно одне з size і notional.
reduce_only?booleanfalsepost_only?booleanfalsetime_in_force?stringБез нього застосовується типове значення біржі.
"gtc""ioc""fok""post_only"client_key?stringКлюч ідемпотентності клієнта.
Термінал прийняв команду. Заявка з’являється в account.orders під ключем key.
application/json- response
Відповідь на кожну торгову команду, команду тригера і команду плеча.
accepted*booleanПрийнято терміналом, а не біржею.
operation_id*stringІдентифікатор операції в журналі торгових операцій термінала. Ключ поставленої заявки — це t- і цей ідентифікатор.
key*|Ключ поставленої заявки, t-…, або поставленого тригера: sl_…, tp_… чи stop_…. null для скасувань, змін і плеча.
connection_id*integerint64instrument*stringcurl -X POST 'http://127.0.0.1:48180/v1/orders' \ -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN" \ -H 'Content-Type: application/json' \ -d '{ "connection_id": 12, "instrument": "binance:futures:BTCUSDT", "side": "buy", "type": "limit", "price": "67000.1", "size": "0.012", "reduce_only": false, "post_only": false, "time_in_force": "gtc", "client_key": "bot-42"}'{ "accepted": true, "operation_id": "173029440000000001", "key": "t-173029440000000001", "connection_id": 12, "instrument": "binance:futures:BTCUSDT"}