Поставить заявку
Собрать запрос
Меняйте значения — команда меняется следом. Токен здесь не вводится: команда берёт его из переменной окружения 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"}