Ключевые концепции
На этой странице описаны основные строительные блоки платформы прогнозных рынков Yoyo Market (далее — Yoyo).
Иерархия рынков
Yoyo организует прогнозы в трехуровневую иерархию:
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.
Цены и вероятности
Все цены на Yoyo используют целочисленный формат от 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 RUB | 1 |
| 1.00 RUB | 100 |
| 10.00 RUB | 1000 |
| 100.00 RUB | 10000 |
Это относится к балансам, суммам сделок, объемам и значениям PnL.
Механизмы торговли
Yoyo предлагает два способа торговли на любом рынке. Оба могут быть активны одновременно.
Книга ордеров (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)
Когда событие разрешается, все рынки внутри него рассчитываются:
- Создатель события (или администратор) объявляет результат: YES или NO.
- Держатели выигрышной стороны получают 10000 копеек (= 100.00 RUB) за акцию по полной стоимости контракта.
- Держатели проигравшей стороны получают 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 |