POST /api/v1/market/orders

Размещение лимитного или рыночного ордера на рынке предсказаний.

Аутентификация

Обязательно. Bearer-токен в заголовке Authorization.

Запрос

Параметры тела запроса

Параметр	Тип	Обязательно	Описание
market_id	int64	Да	ID рынка, на котором размещается ордер.
type	string	Да	Сторона ордера: "buy" или "sell".
kind	string	Да	Тип ордера: "limit" или "market".
token_type	string	Да	Токен для торговли: "YES" или "NO".
price	int	Да*	Цена в базисных пунктах (0--10000). Обязательно для лимитных ордеров, игнорируется для рыночных.
amount	int	Да	Для ордеров на покупку с amount_type: "cents" — бюджет в центах. Для ордеров на продажу с amount_type: "shares" — количество акций для продажи.
amount_type	string	Да	"cents" (на основе бюджета) или "shares" (на основе количества).
use_bonus	bool	Нет	Если true, для оплаты ордера используется бонусный баланс. По умолчанию false.

Пример

curl -X POST https://intotes.com/api/v1/market/orders \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "market_id": 42,
    "type": "buy",
    "kind": "limit",
    "token_type": "YES",
    "price": 6500,
    "amount": 1000,
    "amount_type": "cents"
  }'

Ответ

200 OK

{
  "id": 1001,
  "user_id": 7,
  "market_id": 42,
  "type": "buy",
  "kind": "limit",
  "token_type": "YES",
  "price": 6500,
  "amount": 1000,
  "filled": 0,
  "status": "pending",
  "use_bonus": false,
  "created_at": "2026-04-04T12:00:00Z"
}

Поля ответа

Поле	Тип	Описание
id	int64	Уникальный идентификатор ордера.
user_id	int64	ID пользователя, разместившего ордер.
market_id	int64	Рынок, на котором размещён ордер.
type	string	"buy" или "sell".
kind	string	"limit" или "market".
token_type	string	"YES" или "NO".
price	int	Лимитная цена в базисных пунктах.
amount	int	Общая сумма ордера (центы или акции).
filled	int	Уже исполненная сумма.
status	string	Статус ордера: "pending", "partial", "filled" или "cancelled".
use_bonus	bool	Использовался ли бонусный баланс.
created_at	string	Временная метка создания ордера в формате ISO 8601.

Ошибки

Статус	Код	Описание
400	INVALID_AMOUNT	Сумма должна быть положительным целым числом.
400	INVALID_PRICE	Цена должна быть от 0 до 10000 (базисные пункты).
402	INSUFFICIENT_BALANCE	У пользователя недостаточно средств для размещения ордера.
409	MARKET_PAUSED	Торговля на рынке в данный момент приостановлена.
409	MARKET_RESOLVED	Рынок уже разрешён.