Размещение ордеров

Отправляйте ордера на рынки типа orderbook с помощью эндпоинта POST /api/v1/market/orders. Это основной способ торговли, когда рынок использует пиринговое сопоставление ордеров.

Эндпоинт

POST /api/v1/market/orders
Authorization: Bearer <token>
Content-Type: application/json

Тело запроса

Поле	Тип	Обязательно	Описание
market_id	integer	Да	Рынок для торговли.
type	string	Да	"buy" или "sell".
kind	string	Да	"limit" или "market".
token_type	string	Да	"YES" или "NO".
price	integer	Только для limit	Цена в копейках, диапазон 0--10000 (0%--100%). Обязательна для лимитных ордеров, игнорируется для рыночных.
amount	integer	Да	Для ордеров покупки: бюджет в копейках (сколько хотите потратить). Для ордеров продажи: количество акций в копейках (сколько акций продать).
use_bonus	boolean	Нет	Если true, списывается с бонусного баланса пользователя. По умолчанию false.

Ключевые правила

• Диапазон цен: Должен быть между 0 и 10000 (включительно). Цена 5000 означает 50%.
• Сумма покупки = бюджет: При покупке amount -- это общая сумма, которую вы готовы потратить (в копейках). Количество полученных акций зависит от цены исполнения.
• Сумма продажи = акции: При продаже amount -- это количество акций-копеек, которые вы хотите продать.
• Лимитные ордера требуют цену: Поле price обязательно для лимитных ордеров и определяет максимальную цену (для покупок) или минимальную цену (для продаж).
• Рыночные ордера без цены: Рыночные ордера исполняются немедленно по лучшей доступной цене в книге ордеров.

Пример: Размещение лимитного ордера на покупку

Купить токены YES на рынке по максимальной цене 6500 (65%), потратив до 100000 копеек (1000 единиц валюты):

curl -X POST https://api.intotes.com/api/v1/market/orders \
  -H "Authorization: Bearer eyJhbG..." \
  -H "Content-Type: application/json" \
  -d '{
    "market_id": 100,
    "type": "buy",
    "kind": "limit",
    "token_type": "YES",
    "price": 6500,
    "amount": 100000
  }'

Пример: Размещение рыночного ордера на продажу

Продать 5000 акций-копеек токенов NO по текущему лучшему bid:

curl -X POST https://api.intotes.com/api/v1/market/orders \
  -H "Authorization: Bearer eyJhbG..." \
  -H "Content-Type: application/json" \
  -d '{
    "market_id": 100,
    "type": "sell",
    "kind": "market",
    "token_type": "NO",
    "amount": 5000
  }'

Ответ

Успешный ответ возвращает объект созданного ордера с его id, текущим status и временными метками. Ордер начинает сопоставление немедленно, если это рыночный ордер, или попадает в книгу ордеров, если это лимитный ордер.

Отмена ордера

Для отмены ожидающего или частично исполненного лимитного ордера:

DELETE /api/v1/market/orders/{order_id}
Authorization: Bearer <token>

Только ордера со статусом pending или partial могут быть отменены. Неисполненная часть возвращается на ваш баланс.

Случаи ошибок

Сценарий	Описание
Недостаточный баланс	Ваш баланс (или бонусный баланс при use_bonus true) не покрывает сумму ордера.
Недействительный рынок	market_id не существует или рынок не активен.
Недопустимый диапазон цен	Цена вне диапазона 0--10000 для лимитного ордера.
Отсутствует цена для limit	Лимитный ордер отправлен без поля price.
Рынок закрыт	Рынок больше не принимает ордера (событие разрешено или приостановлено).

См. также

• Типы ордеров -- Подробное описание всех четырех комбинаций ордеров
• Движок сопоставления -- Как отправленные ордера сопоставляются
• AMM-торговля -- Альтернативный механизм торговли для LMSR-рынков