Перейти к основному содержимому

Ключевые концепции

На этой странице описаны основные строительные блоки платформы прогнозных рынков Intotes.


Иерархия рынков

Intotes организует прогнозы в трехуровневую иерархию:

Event
└── Pool
└── Market (YES / NO)

События (Events)

Событие -- это контейнер верхнего уровня, представляющий реальный вопрос или тему. Примеры:

  • "Достигнет ли BTC $100k к концу 2026?"
  • "Победитель финала НБА 2026"
  • "Следующие президентские выборы в США"

События имеют жизненный цикл статусов: draft -> active -> closed -> resolved. Пользователи могут торговать только в активных событиях.

Пулы (Pools)

Пул -- это конкретный вопрос внутри события. Каждое событие может содержать один или более пулов.

Например, событие "Финал НБА 2026" может содержать пулы:

  • "Выиграют ли Селтикс?"
  • "Дойдет ли серия до 7 игр?"

Каждый пул имеет:

  • live_at -- Когда открывается торговля.
  • finish_at -- Когда торговля закрывается и начинается определение результата.

Рынки (Markets)

Рынок -- это отдельный бинарный исход внутри пула. Большинство пулов имеют два рынка: один для YES и один для NO.

Каждый рынок имеет:

  • Вероятность (текущая цена).
  • Объем (общая сумма торгов).
  • Сторону: YES или NO.

Цены и вероятности

Все цены на Intotes используют целочисленный формат от 0 до 10000, представляющий вероятность от 0% до 100%.

ВероятностьВнутренняя ценаЗначение
0%0Рынок считает событие невозможным
25%2500Низкая вероятность
50%5000Равные шансы
75%7500Высокая вероятность
100%10000Рынок считает событие определенным

Цена YES и цена NO всегда в сумме дают 10000. Если YES оценен в 6500 (65%), то NO оценен в 3500 (35%).


Денежный формат

Все денежные значения в API выражены в копейках. Числа с плавающей запятой не используются.

Отображаемое значениеЗначение API (копейки)
0.01 RUB1
1.00 RUB100
10.00 RUB1000
100.00 RUB10000

Это относится к балансам, суммам сделок, объемам и значениям PnL.


Механизмы торговли

Intotes предлагает два способа торговли на любом рынке. Оба могут быть активны одновременно.

Книга ордеров (Orderbook)

Книга ордеров работает как традиционная биржа:

  • Лимитные ордера -- Вы указываете цену и количество. Ваш ордер остается в книге, пока другой пользователь не исполнит его.
  • Рыночные ордера -- Вы указываете количество и получаете исполнение по лучшей доступной цене из существующих ордеров.

Ордера сопоставляются пользователь-с-пользователем. Если нет подходящего контрагента, лимитный ордер ожидает в книге. Частично исполненные ордера остаются в книге на неисполненный остаток.

Ключевые эндпоинты:

  • POST /api/v1/market/order -- Разместить лимитный или рыночный ордер.
  • DELETE /api/v1/market/order?order_id=... -- Отменить открытый ордер.

Автоматический маркетмейкер LMSR (AMM)

LMSR (Logarithmic Market Scoring Rule) -- это автоматический маркетмейкер, который всегда обеспечивает ликвидность. Вы можете торговать в любое время без необходимости наличия контрагента.

Как это работает:

  • AMM использует функцию стоимости C(q) = b * ln(sum of e^(q_i / b)), где b -- параметр ликвидности, а q_i -- количество токенов.
  • Покупка толкает цену вверх; продажа толкает цену вниз.
  • К каждой сделке применяется комиссия (настраивается через FeePercent).

Ключевые эндпоинты:

  • POST /api/v1/lmsr/trade -- Исполнить сделку с AMM.
  • GET /api/v1/lmsr/preview -- Предварительный просмотр стоимости сделки без исполнения.

Гибридное исполнение: Когда оба механизма доступны, лимитные ордера, которые не могут быть сопоставлены в книге ордеров, могут быть исполнены через LMSR AMM на оставшийся объем.


Позиции

Позиция представляет вашу экспозицию на конкретном рынке.

Тип позицииЗначениеВы получаете прибыль когда
LongВы держите токены YES (купили YES)Событие произошло (YES)
ShortВы держите токены NO (купили NO)Событие не произошло (NO)

Каждая позиция отслеживает:

  • Акции -- Сколько токенов вы держите.
  • Средняя цена -- Средневзвешенная цена, по которой вы их приобрели.
  • Нереализованный PnL -- Ваша бумажная прибыль или убыток на основе текущей рыночной цены.

Вы можете закрыть позицию в любое время, продав свои акции обратно (через книгу ордеров или LMSR AMM).


Расчет (Settlement)

Когда событие разрешается, все рынки внутри него рассчитываются:

  1. Создатель события (или администратор) объявляет результат: YES или NO.
  2. Держатели выигрышной стороны получают 10000 копеек (= 100.00 RUB) за акцию по полной стоимости контракта.
  3. Держатели проигравшей стороны получают 0.

Например, если вы купили 10 акций YES по цене 6500 (потратив 65000 копеек), и событие разрешилось как YES:

  • Вы получаете 10 x 10000 = 100000 копеек.
  • Ваша прибыль составляет 100000 - 65000 = 35000 копеек (350.00 RUB).

Если событие разрешилось как NO, вы получаете 0 и теряете все вложенные 65000 копеек.


Сводка

КонцепцияОписание
СобытиеКонтейнер верхнего уровня для реального вопроса
ПулКонкретный вопрос внутри события с окном торговли
РынокБинарный исход YES/NO с ценой вероятности
ЦенаЦелое число 0-10000, представляющее вероятность 0%-100%
ДеньгиВсе значения в копейках. 100 = 1.00 RUB
Книга ордеровПиринговое сопоставление лимитных и рыночных ордеров
LMSR AMMАлгоритмический маркетмейкер, обеспечивающий мгновенную ликвидность
ПозицияLong (токены YES) или Short (токены NO)
РасчетВыигрышная сторона получает полную стоимость (10000/акция), проигравшая -- 0