GET /api/v1/market/orderbook/{market_id}

Возвращает текущую книгу ордеров для рынка, показывая все открытые лимитные ордера. Биды отсортированы от высшей к низшей цене, аски — от низшей к высшей.

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

Не требуется. Это публичный эндпоинт.

Запрос

Параметры пути

Параметр	Тип	Обязательно	Описание
market_id	integer	Да	ID рынка

Пример

curl https://intotes.com/api/v1/market/orderbook/101

Ответ

200 OK

Цены выражены целыми числами в диапазоне 0--10000, представляя вероятность от 0% до 100% с точностью до двух десятичных знаков (например, 5500 = 55.00%). Объёмы указаны в центах акций.

{
  "market_id": 101,
  "bids": [
    {
      "price": 5500,
      "amount": 10000
    },
    {
      "price": 5400,
      "amount": 25000
    },
    {
      "price": 5200,
      "amount": 15000
    }
  ],
  "asks": [
    {
      "price": 5600,
      "amount": 12000
    },
    {
      "price": 5800,
      "amount": 8000
    },
    {
      "price": 6000,
      "amount": 30000
    }
  ]
}

Поля

Поле	Тип	Описание
market_id	integer	Рынок, которому принадлежит эта книга ордеров
bids	array	Ордера на покупку, отсортированные по убыванию цены
bids[].price	integer	Цена бида (шкала 0--10000)
bids[].amount	integer	Размер бида в центах акций
asks	array	Ордера на продажу, отсортированные по возрастанию цены
asks[].price	integer	Цена аска (шкала 0--10000)
asks[].amount	integer	Размер аска в центах акций

Шкала цен

Книга ордеров использует целочисленную шкалу цен от 0 до 10000:

Значение цены	Вероятность	Значение
0	0.00%	Невозможно
2500	25.00%	Низкая вероятность
5000	50.00%	Равные шансы
7500	75.00%	Высокая вероятность
10000	100.00%	Достоверно

Ошибки

Статус	Код	Описание
400	invalid_market_id	ID рынка не является допустимым целым числом
404	market_not_found	Рынок с указанным ID не найден
500	internal_error	Непредвиденная ошибка сервера