Ордера — LootX

Создание заявки

POST/v1/orders

Создаёт заявку. Идемпотентен по requestId — подробности в разделе Интеграция с сервисами.

Тело

Поле	Тип	Обязательно	Описание
`exchange`	string	да	Код биржи
`symbol`	string	да	Инструмент
`side`	string	да	`buy` / `sell`
`type`	string	да	`market` / `limit` / `stop_market` / `stop_limit`
`qty`	string	да	Объём
`price`	string	для limit	Цена
`triggerPrice`	string	для stop	Цена срабатывания
`stopLoss`	string	нет	Абсолютная цена стопа
`takeProfit`	string	нет	Абсолютная цена тейка
`reduceOnly`	bool	нет	Только уменьшать позицию
`postOnly`	bool	нет	Отменить, если станет тейкером
`requestId`	string	нет, но нужно	Ключ идемпотентности

Shell

curl -X POST https://api.lootx.trade/v1/orders \
  -H "Authorization: Bearer $LOOTX_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "exchange": "bybit",
    "symbol": "BTCUSDT",
    "side": "buy",
    "type": "limit",
    "qty": "0.01",
    "price": "61500",
    "postOnly": true,
    "requestId": "a1b2c3"
  }'

TypeScript

const order = await lootx.post("/v1/orders", {
  exchange: "bybit",
  symbol: "BTCUSDT",
  side: "buy",
  type: "limit",
  qty: "0.01",
  price: "61500",
  postOnly: true,
  requestId: crypto.randomUUID(),
});

Изменение и отмена

PATCH/v1/orders/:id

Меняет цену и/или объём активной заявки. Реализовано как cancel/replace там, где биржа не умеет изменять заявку: id в ответе может отличаться от запрошенного — ориентируйтесь на него, а не на старый.

DELETE/v1/orders/:id

Отменяет заявку. 404 означает, что заявки уже нет: либо исполнилась, либо отменена раньше. Это не ошибка вашего кода — проверьте историю.

DELETE/v1/orders

Отменяет все заявки: по инструменту (symbol), по бирже (exchange) или вообще все. Единственный запрос в API, который мы советуем повесить на горячую клавишу.

История

GET/v1/fills

Исполнения, от новых к старым. Курсорная пагинация: cursor из nextCursor, окно не больше 31 дня за один проход.

Параметр	Описание
`from`, `to`	ISO-8601, границы периода
`symbol`	Фильтр по инструменту
`limit`	До 500 записей за страницу