> For the complete documentation index, see [llms.txt](https://tools.oxygen.wiki/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tools.oxygen.wiki/docs/soft/perpland.md).

# PerpLand

## 🎬 Видеообзор и начало работы

{% embed url="<https://www.youtube.com/watch?v=gtukiVU67Bw>" %}

[Смотреть видео на YouTube](https://www.youtube.com/watch?v=gtukiVU67Bw)

{% hint style="success" %}
Совместимость: Windows, MacOS, Linux
{% endhint %}

## 📚 Описание проекта

**Perp DEX** - новый тренд в крипте с фармом поинтов на большом количестве разных площадок со фьючерсами. Наш софт помогает открывать зеркальные позиции, накручивать объемы и экономить огромное количество сил и времени при отработке.

Затраты:

* **Backpack 1 acc:** 400-500$ acc
* **Paradex 1 acc:** 400-500$ acc
* **Hyperliquid 1 acc:** 200$-300$ acc
* **Lighter 1 acc:** 40$ acc
* **Aster 1 acc:** any size
* **Edgex 1 acc**: any size
* **Extended 1 acc**: any size
* **Ethereal 1 acc**: any size
* **Nado 1 acc**: any size

Ожидаемый профит:

* **Paradex:** x3-4 к затратам
* **Hyperliquid:** x3-4 к затратам
* **Pacifica:** x3-4 к затратам
* **Backpack:** x2 к затратам
* **Edgex**: x3 к затратам
* **Extended**: x5 к затратам
* **Ethereal**: x8 к затратам
* **Nado:** x3-4 к затратам

Завершенные:

* Aster: x1-x1.1 к затратам
* Lighter: x45 к затратам

{% hint style="info" %}
Подробное описание проектов в этом посте: [ТЫК](https://t.me/blacktaraxacum/3621)
{% endhint %}

***

## 🚀 Доступные в софте активности

PerpLand 3.1.3 открывает и сопровождает хеджи, ведёт статистику и отчёты. Управление доступно в браузере и Telegram Mini App.

* **Аккаунты:** импорт списком или по одному, прокси, токены, теги и фильтры.
* **Стратегии:** группы по 3–4 аккаунта на Lighter, Lighter RH, Variational или Polymarket; межбиржевые пары, например Lighter RH ↔ Variational. Несколько стратегий работают одновременно.
* **Торговля:** автоподбор рынков и категорий, вход и выход частями, добор во время удержания, защита запаса до ликвидации.
* **Наблюдение:** дашборд, статистика бирж, отчёты запусков и добровольный лидерборд.
* **Агент и поддержка:** анализ данных, предложения настроек, карточка «План» и тикеты с диагностикой.

В версии 3.1.3 доступны Backpack, Paradex, Lighter, Lighter RH, Hyperliquid, Aster, EdgeX, Pacifica, Extended, Nado, Variational, NoneXYZ и Polymarket. Стратегии с тегами и автоподбор поддерживают Lighter, Lighter RH, Variational и Polymarket. Для остальных площадок используется запуск по бирже; доступные функции зависят от площадки. Ethereal выведена из активной торговли, её прежняя история сохраняется.

### Что нового в 3.1.3

* **Подъём цены входа:** допустимая стоимость части растёт от стартового значения до потолка. После исполнения можно удерживать уровень, сбрасывать его или делать шаг назад. Настройка включается отдельно.
* **Закрыть мягко сейчас:** начать обычный плановый выход, не дожидаясь конца удержания. Доступно для стратегии, площадки и отдельной группы.
* **Variational:** бот прекращает повторять одинаковые распознанные отказы, обновляет шаг объёма и показывает в логе фактическую стоимость RFQ-частей.
* **Polymarket:** ожидание технических работ, фильтр **Дубли**, обновление статистики во время удержания и отдельный **Пересчитать с нуля**.
* **Oxygen-агент:** анализ фактической стоимости входа и оценка экономии от подъёма цены. Рецепт **самый дешёвый фарм** обновлён.

### Пошаговые инструкции

* [Теги, стратегии и автоматический перенос пулов](/docs/soft/perpland/perpland-strategies.md)
* [Настройки, выбор монет, вход и выход, защита позиций](/docs/soft/perpland/perpland-settings.md)
* [Telegram и управление с телефона](/docs/soft/perpland/perpland-telegram.md)
* [Oxygen-агент и поддержка](/docs/soft/perpland/perpland-agent.md)
* [Oxygen Cookie: получение данных аккаунтов](/docs/soft/perpland/perpland-oxygen-cookie.md)
* [Polymarket: подключение и перевод средств в Perps](/docs/soft/perpland/perpland-polymarket.md)

За обновлениями следите в [паблике Oxygen.Tools](https://t.me/oxygen_tools).

***

## ⚙️ Установка

#### **Требования:**

* Установка Node Js: <https://nodejs.org/>

#### **Скачивание:**

1. Перейти в нашего бота: <https://t.me/OduLandBot?start=r_oxygen_x>
2. Личный кабинет -> Доступ к софтам -> Выбрать интересующий вас продукт

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2FkCMAk5SVTUySYflhdno0%2F05182-ezgif.com-video-to-gif-converter.gif?alt=media&amp;token=8b090cc5-d5c0-4cd5-9f23-cb0d1b37a21e" alt=""><figcaption><p>Скачивание продукта</p></figcaption></figure>

***

## ▶ Первый запуск

Инструкция для **PerpLand 3.1.3**. Запуск выполняется через исполняемый файл, управление — в браузере или Telegram Mini App.

1. Разархивируйте бот в отдельную папку. На Windows запустите `perp-bot-win.exe`.
2. Бот создаст рабочие файлы и откроет локальный интерфейс по одноразовой ссылке. Обычно адрес — `http://127.0.0.1:7437`; точный адрес указан в консоли.
3. На первом экране выберите язык: русский, английский или украинский. Задайте мастер-пароль от 12 символов и введите ключ Oxygen.Tools. Telegram можно подключить позже.
4. Завершите первый запуск, откройте **Аккаунты** и импортируйте данные нужной биржи.
5. Для Lighter, Lighter RH, Variational и Polymarket поставьте аккаунтам теги и создайте **Стратегию**. Остальные площадки запускаются по бирже. Общие значения задаются на странице **Настройки**, собственные — в редакторе стратегии.
6. Для стратегии проверьте состав в **Если запустить сейчас**, сохраните её и нажмите **Запустить**. Для запуска по бирже выберите нужную площадку на дашборде.

Окно консоли оставьте открытым: в нём работает процесс бота. Вкладку браузера можно закрыть и открыть снова. Если одноразовая ссылка устарела, нажмите **Получить новую ссылку** и откройте ссылку из консоли.

Бот хранит настройки, базу и логи в папке, **из которой запущен**. Запускайте его из одной и той же рабочей папки, чтобы сохранить доступ к прежней истории.

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2Fgit-blob-7c7c730af4f80515fc528ed52d16b2160dc9e22a%2Fperpland-first-launch.gif?alt=media" alt="Первый запуск PerpLand: от исполняемого файла до дашборда"><figcaption><p>Первый запуск PerpLand: от исполняемого файла до дашборда</p></figcaption></figure>

### Обновление с 2.x и хранилище ключей

При запуске новой версии в прежней папке мастер перехода перенесёт ключи в зашифрованное хранилище и создаст зашифрованную резервную копию. История, статистика и настройки сохраняются. С версии 3.1.1 прежние пулы автоматически превращаются в теги и стратегии при запуске или открытии хранилища. Проверьте [результат переноса](/docs/soft/perpland/perpland-strategies.md) в интерфейсе.

Мастер-пароль открывает хранилище ключей. Восстановить его нельзя. PIN интерфейса задаётся отдельно. Пока хранилище закрыто, торговля недоступна; статистику и отчёты можно читать. Ключи бирж и API-ключи AI сохраняются в `config/vault.enc`. Токен Telegram хранится отдельно, чтобы удалённое подключение могло работать до открытия хранилища. В настройках доступа есть журнал безопасности и проверка безопасности сервера: они показывают действия с хранилищем и подсказки по окружению.

Ключ Oxygen.Tools находится в [личном кабинете Telegram-бота](https://t.me/OduLandBot?start=r_oxygen_x): **Личный кабинет → Доступ к софтам → API Ключ**.

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2FYFuRxKQgROwHn33boVHg%2FFind%20Login%20and%20API%20key.gif?alt=media&amp;token=55a6e71c-f4b6-44a2-b667-3752f29ada05" alt=""><figcaption><p>Авторизация</p></figcaption></figure>

### Запуск на macOS

Скачайте сборку `perp-bot-macos` для Apple Silicon и поместите её в папку, например **PerpBot** на рабочем столе. В Терминале выполните по очереди:

```bash
cd ~/Desktop/PerpBot
chmod +x perp-bot-macos
xattr -d com.apple.quarantine perp-bot-macos
./perp-bot-macos
```

Если файл переименован в `perp-bot`, используйте это имя во всех командах. Один `Ctrl+C` начинает мягкую остановку, повторный завершает процесс немедленно.

***

### Если окно сразу закрывается

На Windows откройте папку бота в Проводнике, в адресной строке введите `cmd` и нажмите **Enter**. В открывшейся консоли запустите `perp-bot-win.exe`: текст ошибки останется на экране. На macOS и Linux запускайте файл из Терминала в его папке.

Передайте текст ошибки или скриншот в [поддержку Oxygen.Tools](https://t.me/oxygen_support_bot). Тикет внутри бота доступен после его запуска.

## ✅ Настройка и начало работы

1. **Аккаунты → биржа → Добавить аккаунты**.
2. Выберите **Списком** для строк в форматах ниже или **По одному** для отдельных полей. При массовом импорте каждый аккаунт занимает одну строку.
3. Проверьте ошибки строк и подтвердите сохранение. Данные сохранятся в хранилище.
4. Проверьте прокси и обновите балансы. Для Lighter, Lighter RH, Variational и Polymarket переходите к [тегам и стратегиям](/docs/soft/perpland/perpland-strategies.md), для остальных площадок — к запуску по бирже.

Для Variational, Lighter RH и Polymarket готовую строку копирует [Oxygen Cookie](/docs/soft/perpland/perpland-oxygen-cookie.md). TXT-файлы больше не являются обязательным шагом: основной способ — импорт через интерфейс. Файловый inbox остаётся дополнительным режимом и по умолчанию выключен. Строки с `@vault` — ссылки на хранилище, а не строки для переноса в другую установку.

**Формат прокси:** `host:port:username:password`.

### Работа с аккаунтами

* **Заменить прокси** доступно для одного аккаунта и выделенного списка; проверка выполняется до сохранения.
* **Тип аккаунта** позволяет выбрать премиум или стандарт без переименования.
* Для Variational виден срок токена. **Обновить токен** применяет новые данные без перезапуска бота.
* Поиск работает по имени, адресу кошелька и прокси. **Копировать адрес** находится в карточке аккаунта.
* Теги, их цвета, правила и фильтры описаны в [гайде стратегий](/docs/soft/perpland/perpland-strategies.md). На телефоне теги показаны цветными точками, панель выделения — внизу.
* Для Polymarket фильтр **Дубли** показывает один кошелёк, добавленный под разными именами. Такие строки стоят рядом. На Lighter, Lighter RH и Variational автоматической проверки дубля кошелька нет.

### Настройки Backpack

**Импорт:** **Аккаунты → Backpack → Добавить аккаунты → Списком / По одному**.

Формат - `label,apiKey,apiSecret,proxy`

`label` - обязательная метка для обозначения аккаунта\
`apiKey` - API ключ аккаунта для доступа к открытию позиций\
`apiSecret` - API секретная фраза для доступа к открытию позиций\
`proxy` - прокси аккаунта

Как получить `apiKey` и `apiSecret`:

1. Зайдите в свой аккаунт Backpack
2. Перейдите в портфолио
3. Внизу нажмите Settings
4. Выберите вкладку API Keys
5. Нажмите на кнопку New API key

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2F9fAPEznRVulh3pgU8aUl%2Fimage.png?alt=media&amp;token=6e07b840-975c-45b9-9bea-f723654427fe" alt=""><figcaption><p>Создание apiKey + apiSecret</p></figcaption></figure>

***

### Настройки Lighter / Lighter RH

Lighter и Lighter RH — отдельные площадки в **Аккаунтах** и **Настройках**. Их технические обозначения — `LIGHTER` и `LIGHTER_RH`.

#### Lighter

**Импорт:** **Аккаунты → Lighter → Добавить аккаунты → Списком / По одному**.

Формат — `label,seed,l1Address,index,proxy`

* `label` — метка аккаунта. Используйте уникальные метки для всех бирж.
* `seed` — данные подписи аккаунта Lighter из браузера.
* `l1Address` — адрес привязанного EVM-кошелька.
* `index` — индекс аккаунта обычного Lighter.
* `proxy` — прокси аккаунта.

Как получить `seed` и `index`:

1. Войдите в свой аккаунт Lighter через браузер.
2. Откройте консоль разработчика: **F12 → Console**.
3. Вставьте команду ниже и нажмите **Enter**.
4. Скопируйте `seed` и `index` в строку аккаунта.

```javascript
const [index, obj] = Object.entries(JSON.parse(localStorage.getItem('signature_v5')))[0];
console.log('index:', index);
console.log('seed:', obj.seed);
```

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2FGlqksDTc8Q6PpOhGaN6I%2FUDei1K6u9c.png?alt=media&amp;token=69428bfc-f10d-4810-8c8d-381a34268fb1" alt=""><figcaption><p>Получение Index + Seed (F12 -> Console -> Снизу вставляем код и нажимаем Enter)</p></figcaption></figure>

**Параметры биржи:** на странице **Настройки**, в разделе Lighter.

* `slippage` — допустимый запас к цене для маркет-ордера, в процентах. `0.2` означает `0.2%`.
* `wasm_link` — запасная ссылка на модуль подписи. Обычно оставьте `""`: модуль уже встроен в бот. Файл по ссылке должен совпадать со встроенным; бот проверяет его хеш.

<details>

<summary>Прежний способ поиска запасной ссылки WASM</summary>

Для обычной настройки этот шаг не нужен: модуль подписи встроен в бот.

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2FGg1ri0gEee3jVJFM2Ctn%2Fimage.png?alt=media&amp;token=284bba61-bc78-4bdf-aeee-b08d444dadeb" alt=""><figcaption></figcaption></figure>

</details>

**Ошибка Invalid signature:** заново получите `seed` и `index` из браузера и обновите строку аккаунта. Данные могут измениться после новой авторизации или смены профиля.

{% hint style="info" %}
Oxygen Cookie пока не копирует данные обычного Lighter. Для него используйте способ через консоль выше.
{% endhint %}

#### Lighter RH — Robinhood Chain

**Импорт:** **Аккаунты → Lighter RH → Добавить аккаунты → Списком / По одному**.

Формат — `label,l1Address,accountIndex,apiKeyIndex,apiPrivateKey,proxy`

* `label` — уникальная метка аккаунта, например `Account1-RH`.
* `l1Address` — адрес подключённого кошелька.
* `accountIndex` — индекс аккаунта в Robinhood Chain. Индекс обычного Lighter сюда не подходит.
* `apiKeyIndex` — индекс вашего API-ключа: от `2` до `254`.
* `apiPrivateKey` — приватный ключ API, созданный на сайте. Это не приватный ключ кошелька.
* `proxy` — обязательный прокси аккаунта.

Как добавить аккаунт:

1. Откройте [Lighter RH](https://robinhoodchain.lighter.xyz/) в Oxygen Atmos и подключите кошелёк.
2. Перейдите в **API Keys** и нажмите **Generate API Key**. Сразу сохраните приватный ключ API: сайт показывает его один раз.
3. Откройте Oxygen Cookie и карточку **RH Lighter**.
4. Укажите **Label**, **Private key (API key)** и **Proxy**. **Account index** и **API key index** заполняются автоматически; проверьте выбранный ключ.
5. Нажмите **Copy to clipboard** и вставьте строку в **Аккаунты → Lighter RH → Добавить аккаунты → Списком**.

[Установка и использование Oxygen Cookie](/docs/soft/perpland/perpland-oxygen-cookie.md)

**Параметры биржи:** на странице **Настройки**, в разделе Lighter RH.

* `slippage` — запас к цене маркет-ордера, в процентах.
* `waf_token` — служебный токен защиты сайта. Обычно оставьте `""`; он нужен только при отказах защиты сайта с рабочими API-ключами.

{% hint style="warning" %}
Если у обычного Lighter и Lighter RH совпадают индексы аккаунтов, их нельзя одновременно подключать в одном запуске бота. Запускайте такие аккаунты отдельно.
{% endhint %}

***

### Настройки Paradex

**Импорт:** **Аккаунты → Paradex → Добавить аккаунты → Списком / По одному**.

Формат - `label,ethereumPrivateKey,paradexAddress,paradexPrivateKey,proxy`

`label` - обязательная метка для обозначения аккаунта\
`ethereumPrivateKey` - приватный ключ кошелька связанного с Paradex аккаунтом\
`paradexAddress` - адрес аккаунта Paradex\
`paradexPrivateKey` - приватный ключ аккаунта Paradex\
`proxy` - прокси аккаунта

Как получить `paradexAddress` и `paradexPrivateKey`:

1. Зайдите в свой аккаунт Paradex
2. Нажмите на адрес кошелька справа сверху
3. Скопируйте Paradex Address и Paradex Private Key

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2FZNy6xaXJbRrCrQtaeSgb%2Fimage.png?alt=media&amp;token=bcc03097-1238-4ce3-9d8d-271ff26fb3e5" alt=""><figcaption><p>Экспорт paradexAddress + paradexPrivateKey (Адрес -> Wallet)</p></figcaption></figure>

***

### Настройки Hyperliquid

**Импорт:** **Аккаунты → Hyperliquid → Добавить аккаунты → Списком / По одному**.

Формат - `label,ethereumPrivateKey,proxy`

`label` - обязательная метка для обозначения аккаунта\
`ethereumPrivateKey` - приватный ключ кошелька связанного с Hyperliquid аккаунтом\
`proxy` - прокси аккаунта

***

### Настройки Aster

**Импорт:** **Аккаунты → Aster → Добавить аккаунты → Списком / По одному**.

Формат - `label,apiKey,apiSecret,proxy`

`label` - обязательная метка для обозначения аккаунта\
`apiKey`- api ключ аккаунта Aster\
`apiSecret` - секрет от api аккаунта Aster\
`proxy` - прокси аккаунта

Как получить `apiKey` и `apiSecret`:

1. Зайдите в свой аккаунт Aster
2. Нажмите на адрес кошелька справа сверху
3. Скопируйте API key и API secret key

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2FDNIXmSEj5qhQJJ6gPgcj%2Fimage.png?alt=media&amp;token=711609f9-b8a2-4254-ab0f-9f8de13de6d9" alt=""><figcaption></figcaption></figure>

***

### Настройки Pacifica

**Импорт:** **Аккаунты → Pacifica → Добавить аккаунты → Списком / По одному**.

Формат - `label,privateKey,solanaAddress,proxy`

`label` - обязательная метка для обозначения аккаунта\
`privateKey`- приватный ключ от API вашего аккаунта Pacifica\
`solanaAddress` - адрес SOL кошелька, который привязан к аккаунту Pacifica\
`proxy` - прокси аккаунта

Как получить `privateKey`:

1. Зайдите в свой аккаунт Pacifica
2. Перейдите во вкладку API Keys
3. Скопируйте ключ белого цвета

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2FF4Bks57x3emkac2CVmAI%2Fimage.png?alt=media&amp;token=528730b1-4ae2-4d1a-8ca6-a9f0c52b531b" alt=""><figcaption></figcaption></figure>

***

### Настройки EdgeX

**Импорт:** **Аккаунты → EdgeX → Добавить аккаунты → Списком / По одному**.

Формат - `label,console_key,proxy`

`label` - обязательная метка для обозначения аккаунта\
`console_key` - данные аккаунта полученные из консоли браузера\
`proxy` - прокси аккаунта

Как получить `console_key`:

1. Зайдите в свой аккаунт EdgeX через браузер
2. Откройте консоль разработчика (нажмите F12)
3. Вставьте команду ниже и нажмите Enter
4. `console_key` появятся в логах, его можно скопировать

```javascript
const user = JSON.parse(localStorage.getItem('user'))
const currentAccount = user.state.currentActiveAccount
const keys = currentAccount.keys
console.log(`${currentAccount.id},${Object.values(keys.apiKey).join(',')},${keys.l2Key.privateKey}`)
```

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2FmeFQm4m1FrdB6JcKZGe3%2Fimage.png?alt=media&amp;token=2269f66d-929a-41db-b616-25a3c309b743" alt=""><figcaption></figcaption></figure>

***

### Настройки Extended

**Импорт:** **Аккаунты → Extended → Добавить аккаунты → Списком / По одному**.

Формат - `label`,`apiKey`, `starkPublicKey`, `starkPrivateKey`, `vaultNumber`, `clientId`,`proxy`

`label` - обязательная метка для обозначения аккаунта\
`apiKey`, `starkPublicKey`, `starkPrivateKey`, `vaultNumber`, `clientId` - данные API созданного на аккаунте Extended\
`proxy` - прокси аккаунта

Как получить `apiKey`, `starkPublicKey`, `starkPrivateKey`, `vaultNumber`, `clientId`:

1. Зайдите в свой аккаунт Extended через браузер
2. Перейдите в More -> API
3. Нажмите Generate API Key -> Show API Details
4. Скопируйте все нужные данные

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2FVlAsSIp1lbMpTOna5B05%2FFrame%201376.png?alt=media&amp;token=dcfbb420-5341-4e9a-bd55-a605dc6385ac" alt=""><figcaption></figcaption></figure>

***

### Настройки Nado

**Импорт:** **Аккаунты → Nado → Добавить аккаунты → Списком / По одному**.

Формат - `label`,`privateKey`, `proxy`

`label` - обязательная метка для обозначения аккаунта\
`privateKey` - приватный ключ от вашего кошелька связанного с аккаунтом Nado\
`proxy` - прокси аккаунта

***

### Настройки Variational

**Импорт:** **Аккаунты → Variational → Добавить аккаунты → Списком / По одному**.

Формат — `label,token,proxy`

* `label` — уникальная метка аккаунта.
* `token` — токен сессии `vr-token` из аккаунта Variational.
* `proxy` — прокси аккаунта.

Как получить строку аккаунта:

1. Откройте [Variational](https://omni.variational.io/) в профиле Oxygen Atmos и подключите кошелёк.
2. Откройте Oxygen Cookie и карточку **Variational**.
3. Заполните **Label** и **Proxy**.
4. Нажмите **Copy to clipboard** и вставьте строку в **Аккаунты → Variational → Добавить аккаунты → Списком**.

[Установка и использование Oxygen Cookie](/docs/soft/perpland/perpland-oxygen-cookie.md)

Если расширение показывает **Please log in**, войдите на сайт и снова откройте расширение. При истечении или отклонении токена переподключите кошелёк и нажмите **Обновить токен** в карточке аккаунта. Перезапуск не требуется; срок сессии виден заранее.

Бот также принимает приватный ключ кошелька вместо токена, но вход этим способом может блокировать Cloudflare. Для подключения используйте токен через Oxygen Cookie. Если аккаунт уже добавлен, обновляйте его токен, а не создавайте новую запись. Обновление токена сохраняет ранее введённый приватный ключ; его удаление — отдельное действие **Удалить приватный ключ**. Бот не позволит оставить аккаунт без рабочего способа входа.

**Параметры биржи:** на странице **Настройки**, в разделе Variational.

`slippage` — допустимое проскальзывание маркет-ордера, в процентах. `0.5` означает `0.5%`.

Variational поддерживает криптовалютные и RWA-перпы, а также свопы: `XAUS` (золото), `XAGS` (серебро), `US500S`, `US100S`, `TWIS` (индексы), `USOILP`, `UKOILP` (нефть). Плечо перпов ограничивается рынком: для криптовалют ориентир до `50`, для RWA — до `20`.

У свопов изолированная маржа: биржа выделяет её для позиции. Плечо — до `10x`; если в `max_leverage` задано больше, бот применит лимит свопа. Торговых комиссий и обычного фандинга у свопов нет. Вместо фандинга раз в сутки применяется небольшое финансирование. Бот не учитывает его в выборе направления хеджа.

Если биржа отклоняет открытие из-за перекоса лонгов и шортов, бот запоминает причину и обычно пропускает монету на 15 минут для групп этой биржи. При автоподборе часть монет с перекосом отсеивается заранее. Если других кандидатов нет, бот может повторить проверку.

В 3.1.3 при входе частями бот распознаёт повторные отказы Variational и прекращает бесполезные попытки. Проблемный аккаунт может получить паузу или выйти из текущего запуска; остальные продолжают работу. Шаг объёма обновляется; в логе части видна стоимость по фактическому исполнению, когда биржа его сообщает. [Правила отказов и набора](/docs/soft/perpland/perpland-settings.md).

#### Торговые часы свопов

У свопов есть ежедневный перерыв, обычно **21:00–22:00 UTC**, и пауза на выходные. Бот использует расписание конкретного рынка от биржи: у отдельных инструментов могут быть дополнительные перерывы.

Когда рынок закрыт, бот не открывает новый хедж. После возобновления торговли он ждёт **15 минут** перед новым входом. Перед ближайшим закрытием бот тоже прекращает открывать новые хеджи: запас времени зависит от настроек ожидания входа и составляет не меньше 10 минут. Уже открытые позиции можно закрывать до окончания торговой сессии.

***

### Настройки Polymarket Perps

Добавьте аккаунт через **Аккаунты → Polymarket → Добавить аккаунты**. Поддерживаются строка торгового ключа из Oxygen Cookie и приватный ключ кошелька. Возможности этих способов различаются: перевод **Выигрыши → Perps** требует ключа кошелька и подтверждения на ПК.

[Полная инструкция Polymarket](/docs/soft/perpland/perpland-polymarket.md)

### Настройки NoneXYZ

Добавьте аккаунт через **Аккаунты → NoneXYZ → Добавить аккаунты**. Используйте поля и формат строки, показанные в форме выбранной площадки.

***

## ⚙️ Настройки и запуск стратегии

Откройте **Настройки**, чтобы задать общие значения и профиль биржи. Для Lighter, Lighter RH, Variational и Polymarket создайте стратегию по тегам и задайте её отличия в редакторе. Источник каждого значения виден рядом с полем; основные торговые изменения применяются со следующего запуска. Число потоков можно менять во время работы.

[Пошаговый пример троек Variational и управление стратегиями](/docs/soft/perpland/perpland-strategies.md)

[Справочник настроек: рынки, стоимость, добор, выход, защита](/docs/soft/perpland/perpland-settings.md)

Пулы больше не управляют торговлей. Перенос в теги и стратегии выполняется автоматически; неперенесённые пулы показаны с причиной и блокируют запуск своей площадки до устранения проблемы. Для сценариев по бирже остаётся редактор фиксированных групп в настройках. Ручное создание `groups.txt` для стратегии с тегами не требуется.

### Как устроены тройки и четвёрки <a href="#kak-ustroena-troika" id="kak-ustroena-troika"></a>

Один аккаунт открывает одну сторону, два остальных — противоположную на тот же суммарный объём. Например, лонг на 500$ хеджируется двумя шортами на 220$ и 280$.

При отработке одной биржи на 2 аккаунтах — на одном лонг, а на другом шорт, вы получите блокировку с шансом 98%.\
Но если вы используете 3 аккаунта, то шанс поймать блокировку стремится к 0%. Бот будет брать 1 аккаунт за главного, при чем каждый раз разного, и открывать полную позицию, а противоположную сделку разделит на другие аккаунты поровну.

В группе из четырёх аккаунтов одна сторона тоже уравновешивает другую по суммарному объёму. На скриншоте группа **39** набирает хедж: один аккаунт — **Short 50%**, три других — **Long 21%, 10% и 19%**. Это пример распределения: доли отдельных аккаунтов могут различаться. Остальные показанные группы состоят из трёх аккаунтов.

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2Fgit-blob-7a526070cde0a39195a346afc7399363b63a0708%2Fperpland-groups-three-four.png?alt=media" alt="Тройки и четвёрки в PerpLand: состав групп, направления и доли аккаунтов"><figcaption><p>Тройки и четвёрки в PerpLand: состав групп, направления и доли аккаунтов</p></figcaption></figure>

## 🧠 Логика софта

Бот подбирает монету по доступной ликвидности, стоимости входа и выхода, ограничениям выбранных категорий и расписанию. В режиме `accumulate` набирает сбалансированные части по потолку цены, добирает в начальном окне удержания и выходит частями. Реальные затраты и откаты учитываются при следующем выборе рынка.

Защита проверяет запас до ликвидации при входе и удержании. Время свопов сверяется с биржей. Если рынок закрыт, позиция ожидает открытия, а остальные группы продолжают работу. После перезапуска хеджи восстанавливаются отдельно по стратегиям.

Подробности, включая лестницу смягчения цены выхода и поведение при ошибках связи, — в [настройках и логике торговли](/docs/soft/perpland/perpland-settings.md).

С 3.1.3 **Подъём цены входа** позволяет начинать с более низкой допустимой стоимости и постепенно доходить до установленного потолка. По умолчанию подъём выключен. **Закрыть мягко сейчас** переносит обычный плановый выход на текущее время; у стратегии или площадки прекращаются новые хеджи, у отдельной группы после закрытия круги продолжаются. [Управление стратегией](/docs/soft/perpland/perpland-strategies.md).

Карточка группы показывает состав, круг, объём, PnL, комиссии и фандинг. При перемешивании новый состав получает новую карточку; прежние находятся в **Завершённых**. Используйте фильтры **Активные**, **На паузе**, **Внимание**, **Завершённые**.

На дашборде **Стратегии и запуски** выберите карточку, чтобы отфильтровать группы, аккаунты, события и логи. В **Аккаунтах прогона** показана стратегия; **Сейчас в: …** ведёт к ней из аккаунта.

## 📊 Статистика и отчёты

**Статистика** открывается в браузере и Mini App. Здесь доступны данные бирж, история баланса и результаты фарма. Для Lighter, Lighter RH и Variational результат аккаунта считается как **баланс − внесено + выведено** и включает открытый PnL. У Polymarket дополнительно вычитаются внутренние поступления и прибавляются внутренние отправления, чтобы перевод между аккаунтами не выглядел прибылью. Данные и доступные поинты зависят от биржи; неполные значения помечаются. У точки истории баланса видно количество учтённых аккаунтов. Комиссии разделены на точные, неизвестные и оценочные; цену поинта можно сравнить с комиссиями и без них.

* **Variational:** объёмы, тир, бусты, недельные начисления, фандинг и комиссии. Цена поинта считается по начисленным неделям.
* **Lighter / Lighter RH:** баланс, вводы и выводы, объём, live-поинты и начисления. У Lighter RH пятничная раздача учитывается отдельно, недели не задваиваются.
* **Фарм:** хеджи, объём, PnL, ликвидации, цена live-поинта и цена поинта с раздачей. Рядом с live-оценкой показано число хеджей; при недостаточной выборке — **мало замеров**.
* **Пары:** цена поинта учитывает результат всего хеджа, включая противоположную ногу.
* **Polymarket:** баланс Perps, движения средств, объём, комиссии и фандинг. Бот не считает поинты этой площадки; свежие пополнения и внутренние переводы учитываются в результате отдельно от торговли.

**Результат прогона** на дашборде, в Telegram, статусе и отчётах — это PnL закрытых хеджей с учётом комиссий и известного фандинга: комиссия вычитается, полученный фандинг прибавляется, уплаченный — вычитается. Подробности открываются через **ⓘ**. Знак `≈` означает неполные составляющие или старый запуск без всех записанных данных. Отдельный **PnL сделок** остаётся показателем до комиссий и фандинга.

Снимки баланса записываются в начале и конце запуска стратегии или биржи, а также при присоединении аккаунта на ходу. Между этими событиями график может сохранять последнюю точку. Если баланс прочитать не удалось, фиктивный ноль не записывается. Изменение баланса само по себе не равно прибыли.

Цена поинта в **Фарме** имеет свой расчёт; её не следует приравнивать к результату прогона. Подпись **Без комиссий** означает, что эта оценка рассчитана без вычета комиссий, поскольку часть данных о них неизвестна; рядом может быть оценка по ставкам. Для подтверждённых стандартных аккаунтов Lighter/RH нулевая комиссия учитывается как известный ноль; неизвестная комиссия других сделок не обнуляется. Измеренная стоимость входа и выхода хеджа сохраняется после перезапуска.

Статистику и отчёты можно фильтровать по стратегиям и тегам. **Обновить данные** дочитывает новые записи с биржи. Для Polymarket кнопка **Пересчитать с нуля** с подтверждением заново читает историю площадки; это занимает больше времени. Неизвестная комиссия не считается нулевой; известные комиссии других сделок сохраняются в расчёте.

У Polymarket обычное обновление уже собранной статистики доступно во время удержания. Первое чтение, полный пересчёт и восстановление неполной истории денег откладываются до освобождения аккаунта. При ошибке остаются сохранённые значения: интерфейс показывает причину и дату данных, а итог с устаревшими или неполными данными помечает **≈**. [Обновление статистики Polymarket](/docs/soft/perpland/perpland-polymarket.md).

В **Отчётах** хранится история запусков: результат, аккаунты, хеджи, настройки и журнал. Архив запусков ведётся с версии 3; прежняя история хеджей остаётся в статистике. Доступна выгрузка CSV.

При `points_log` журнал записывается в `reports/points-by-hedge.csv`, временной ряд — в `reports/points-timeline.csv`. У ног сохраняется плечо. В 3.1.3 журнал также записывает потолок стоимости входа (`entry_cap_bps`) и стратегию (`strategy`). Старый CSV сохраняется; запись продолжается в файле с новым набором колонок и суффиксом. Поинты могут появляться с задержкой. Отчёт **Фарм завершён** и отдельные карточки хеджей можно получать в Telegram.

## 🏆 Лидерборд

Сравнивайте результаты за 7 и 30 дней, площадки, категории и рынки. Во вкладке **Рынки** монета появляется, когда её торговали минимум три участника. Публикация добровольная: автопубликация изначально выключена, включите её сами. В блоке **Что публиковать** выберите аккаунты нужных тегов или стратегий.

Сверка с биржей учитывает сделки ещё открытых хеджей. Для пары результат и цена поинта относятся ко всему хеджу. При неполных данных интерфейс показывает соответствующую отметку.

Можно посмотреть настройки участника и применить шаблон после проверки различий. Для шаблона выбирается вариант с наибольшим объёмом за 30 дней. Перед применением проверьте свои балансы, плечо и рынки; применение настроек не запускает торговлю.

Для **Polymarket** рейтинг строится по стоимости $1 млн объёма, без поинтовых колонок. Минимум для места — 10 000$ за 7 дней или 30 000$ за 30 дней. Отрицательная стоимость означает положительный результат.

Для **Lighter RH**, когда сервер поддерживает окна по раздачам и у бота есть нужная история, появляется пометка **по раздаче …**. Показатели считаются по одному окну между обнаруженными начислениями; 30 дней охватывают примерно четыре таких недели. Это приближение периода начисления, а не опубликованный биржей точный календарь. При недостатке данных может использоваться обычное скользящее окно. Автопубликация учитывает ограничения сервера и откладывает повтор при лимите.

## 📱 Телефон, агент и поддержка

Через свой Telegram-бот откройте Mini App, чтобы управлять PerpLand из другой сети. Компьютер или VPS с ботом должен продолжать работать. [Настройка Telegram и привязка телефона](/docs/soft/perpland/perpland-telegram.md).

**Oxygen-агент** объясняет результаты и причины ожидания, предлагает изменения, теги и стратегии карточкой **План**. Применяете и запускаете вы. [Подключение и возможности агента](/docs/soft/perpland/perpland-agent.md).

Для обращения откройте **Агент → Поддержка → Новый тикет**. Бот соберёт диагностику без секретов и покажет её до отправки. Ответ приходит в интерфейс и Telegram. Подключать AI для поддержки не требуется.

***

{% hint style="info" %}
Обновления — в [паблике Oxygen.Tools](https://t.me/oxygen_tools). Обсуждение — в [закрытом комьюнити](https://t.me/c/1908008923/61461/64129).
{% endhint %}

<details>

<summary>Архив: записи консольного интерфейса прежних версий</summary>

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2FG43w9Eb7YinnxJdLEs1S%2Fimage.png?alt=media&amp;token=83970821-bbe0-4ae9-81ad-1c84a369359c" alt=""><figcaption><p>Пример стратегии на 3 аккаунта</p></figcaption></figure>

Эти записи сохранены для истории. В версии 3.1.2 первый запуск, импорт и управление выполняются через браузер по инструкции выше.

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2FOK78gW0SUsDaupgXKvMI%2FPerpLand%20Setup.gif?alt=media&amp;token=2f2c9657-8a0c-4b8c-990e-ff7fab97e24a" alt=""><figcaption><p>Запуск софта</p></figcaption></figure>

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2FnrX6MAHDDes7CX3O5VmV%2Fperpl.gif?alt=media&amp;token=52bf6bca-843b-41ac-95de-6c26c02061ad" alt=""><figcaption><p>Интерфейс софта</p></figcaption></figure>

</details>
