# Введение в Predictfun Bot

### Что такое Predict.fun Bot?

Predict.fun Bot — это автоматизированный торговый бот на сети BNB Smart Chain (BSC). Бот реализует стратегию split-торговли и limit-торговли: сплитит USDT в YES + NO токены, затем продаёт каждую сторону лимитными ордерами с наценкой, генерируя торговый объём и извлекая прибыль из спреда.

Predict.fun Bot создан для пользователей, которым необходимо автоматизировать маркетмейкинг на Predict.fun Markets - для набивки объёма, фарма поинтов или иных задач, связанных с торговлей на prediction-рынках

***

### Ключевые возможности

<table><thead><tr><th>Функция</th><th width="373">Описание</th></tr></thead><tbody><tr><td><strong>Split-торговля</strong></td><td>Автоматический сплит USDT → YES + NO токены с последующей продажей лимитками</td></tr><tr><td><strong>Limit-торговля</strong></td><td>Параллельная покупка и продажа токенов лимитными ордерами с контролем best bid/ask</td></tr><tr><td><strong>Мониторинг ордеров</strong></td><td>Отслеживание статуса всех открытых ордеров в реальном времени</td></tr><tr><td><strong>Stop-loss</strong></td><td>Автоматическая защита от убытков с настраиваемым порогом</td></tr><tr><td><strong>Merge позиций</strong></td><td>Объединение YES + NO токенов обратно в USDT</td></tr><tr><td><strong>Market sell</strong></td><td>Быстрая продажа всех позиций по рыночной цене</td></tr><tr><td><strong>Claim resolved</strong></td><td>Автоматический сбор выигрышей с завершённых маркетов</td></tr><tr><td><strong>Telegram-уведомления</strong></td><td>Алерты о балансах, исполнении ордеров и стоп-лоссах</td></tr><tr><td><strong>Multi-account</strong></td><td>Работа с большим количеством кошельков и прокси</td></tr></tbody></table>

***

### Технический стек

| Компонент     | Технология                          |
| ------------- | ----------------------------------- |
| **Язык**      | <h4>Python 3.10+</h4>               |
| **Runtime**   | asyncio                             |
| **Сеть**      | BNB Smart Chain (BSC)               |
| **Платформа** | [Predict.fun](https://predict.fun/) |
| **Кошельки**  | EOA + Proxy Wallets (Safe)          |

***

### Для кого этот бот?

Predict.fun Bot подходит для:

* **Маркетмейкеров** — автоматизация предоставления ликвидности на prediction-маркетах
* **Трейдеров** — генерация торгового объёма с минимальным рыночным риском благодаря хеджированию
* **Фермеров** — накрутка торговой активности на нескольких аккаунтах с встроенной anti-sybil защитой

***

### Архитектура бота (обзор)

Predict.fun Bot состоит из нескольких ключевых компонентов:

````
```
+-------------------------------------------------------------------+
|                     Predict.fun Bot                          |
|                                                                   |
|  +-----------+   +---------------+   +-------------------------+  |
|  | Accounts  |-->|  Main Menu    |-->|  Trading Engines        |  |
|  | Loader    |   |  (10 actions) |   |                         |  |
|  |           |   |               |   |  1. Limit Trader        |  |
|  | keys.txt  |   | 1. Limit      |   |  2. Market Maker (Split)|  |
|  | proxy.txt |   | 2. Split      |   |  3. Position Manager    |  |
|  |           |   | 3. Monitor    |   |  4. Order Manager       |  |
|  +-----------+   +---------------+   +-------------------------+  |
|                                                                   |
|  +---------------+   +--------------+   +------------------+      |
|  | PredictBrowser|   |  Databases   |   |   Telegram       |      |
|  | API Client    |   |  JSON files  |   |   Notifications  |      |
|  +---------------+   +--------------+   +------------------+      |
+-------------------------------------------------------------------+
```
````

1. **Accounts Loader** - управляет состояниями аккаунтов (доступен / в сделке / кулдаун / отключён)
2. **Main Menu** -формирует батчи из доступных аккаунтов и распределяет маркеты по worker'ам
3. **Limit Trader** - торговый движок: размещение ордеров → мониторинг → retreat → ротация
4. **Market Maker (Split)** - периодическое сканирование и отбор подходящих маркетов по заданным фильтрам
5. **Position Manager** - хранение статистики, состояния аккаунтов и истории торгов
6. **Order Manager** - визуальная консольная панель с метриками работы
7. **PredictBrowser** - обёртка над Predict.fun API с авторизацией и подписью транзакций

***

Быстрый старт Если вы хотите сразу начать, выполните следующие шаги:

1. Установите **Python 3.10+**
2. Установите зависимости: `pip install -r requirements.txt`
3. Получите **API-ключ** в Discord Predict.fun (#api-access)
4. Вставьте API-ключ в `settings.yaml` → поле `predict.api_key`
5. Добавьте приватные ключи в `input_data/privatekeys.txt`
6. Добавьте прокси в `input_data/proxies.txt` (рекомендуется)
7. Настройте маркеты в `input_data/markets.yaml`
8. Установите approvals: выберите пункт **9** в меню (первый запуск)
9. Запустите бота: `python main.py`

> Подробная пошаговая инструкция — в разделе Установка.
>
> Все параметры с описаниями — в разделе Конфигурация.

***

### **Безопасность**

* Никогда не делитесь файлом `input_data/privatekeys.txt` и не публикуйте приватные ключи в открытых источниках
* Используйте отдельные кошельки для бота — не храните на них лишние средства
* API-ключ в `settings.yaml` также является конфиденциальным — не публикуйте его