ocean-agent

🧪 ЗАКРЫТАЯ БЕТА — Ocean Agent находится в закрытой бете с 11 августа 2026. Движок торговли с измеряемыми результатами сначала проходит живую валидацию на наших собственных средствах. Публичная бета открывается на следующей неделе, открытая бета — через неделю после этого. Следите за ежедневной таблицей результатов в Telegram.

English · 한국어

🌊 Веб-сайт: oceanagent.fi · PyPI: ocean-agent

Скажите своему ИИ торговать. MCP-сервер для Pacifica, который превращает естественный язык в корректные, риск-взвешенные ордера на бессрочные фьючерсы, плюс круглосуточный автономный торговый агент, управляемый файлом политики, который вы контролируете.

uvx ocean-agent        # no install needed

⚠️ Это размещает реальные ордера с реальными деньгами. Прочтите дисклеймер перед подключением аккаунта.

Полностью построен на Pacifica. Напрямую вызывает REST API Pacifica с тем же подписыванием Ed25519 agent-key, которое использует официальный инструментарий, без npm-зависимости.

Почему это вместо прямого доступа к API

Официальный MCP Pacifica предоставляет API как есть: ваш ИИ должен сам вычислять точные цены и размеры, а цена, не кратная шагу цены рынка, отклоняется биржей. ocean-agent добавляет слой поверх этого:

Related MCP server: asterdex-mcp-server

MCP-инструменты

Рынок и анализ

• analyze_chart, мультитаймфреймовый снимок индикаторов с измеренными показателями попаданий по каждому сигналу на этой конкретной монете и таймфрейме. Говорит «преимущества не обнаружено», когда его нет.

• top_setups, живой рейтинг статистически подтверждённых сеток (EV × процент выигрышей × доверие к выборке), с входом, стопом, целью и плечом

• market_context, чтение режима Fear & Greed

• scan_funding, все рынки, ранжированные по годовой ставке финансирования

• learned_winrates / learned_combos, база данных процентов выигрышей, построенная на живых наблюдениях, включая комбинации сигналов

• review_predictions, прошлые прогнозы, оценённые по фактическим результатам

Торговля

• open_with_bracket, вход плюс нативные TP/SL на бирже одним вызовом. Стопы живут на бирже, поэтому срабатывают даже при выключенной машине.

• protect_position, добавление нативных TP/SL к любой открытой позиции

• open_funding_position / close_funding_position, дельта-нейтральный перенос финансирования (покупка спота + короткая позиция по перпу), исполняемый атомарно как пакет

• plan_oi_hedge, рассчитывает размер OI-фарминг-позиции с её кросс-биржевым хеджем, включая комиссии и математику финансирования

• open_pacifica_leg, check_position, account_status

Print (экспериментально, использует эндпоинт, который Pacifica не документировала; может меняться без уведомления)

• print_quote, живая премия, подразумеваемая волатильность и цена ликвидации

• print_order / print_status / print_close

• evaluate_print, статистический вердикт о том, стоит ли предложение Print: вероятность исполнения, средний перелёт и безубыточный APY, который бы его компенсировал

Автономный торговый агент

Самоуправляемый трейдер, управляемый policy.yaml, контрактом делегирования. Он не может действовать за пределами этих границ.

Это отдельный постоянно работающий процесс, а не MCP-инструмент. MCP-сервер работает только когда его вызывает ваш ИИ-клиент; трейдер, который должен держать позиции и управлять стопами круглосуточно, нуждается в собственном процессе. Запустите его осознанно, и он продолжает работать независимо от того, подключён ли какой-либо ИИ.

python -m ocean_agent.autonomous --init    # create policy.yaml to edit
python -m ocean_agent.autonomous --dry     # decide, but place no orders
python -m ocean_agent.autonomous           # run continuously
python -m ocean_agent.autonomous --once    # single cycle
python -m ocean_agent.autonomous --report  # performance summary

Прочтите policy.yaml перед первым реальным запуском: капитал, лимит плеча, риск на сделку и порог жёсткого стопа — всё это там. Начните с --dry.

Каждый цикл он читает рынок, оценивает то, чему научился, управляет открытыми позициями и входит только в те сетки, которые проходят все ворота.

Портфельные корзины, капитал распределён между направленной торговлей, переносом финансирования и денежным резервом, ребалансируется каждый цикл.

Уход за позицией, перемещает стоп в точку безубыточности, когда сделка выходит в плюс, тянет его за ростом прибыли и фиксирует частичную прибыль на цели. Стопы двигаются только в вашу пользу.

Ворота ликвидности, пропускает рынки, где ваш собственный ордер был бы большой долей дневного объёма. Тонкие книги — реальная опасность: ордер, который исполняется лишь частично, и стоп, который не может быть исполнен по своей цене.

Лимит чистой экспозиции, ограничивает, насколько односторонней может стать книга, чтобы один разворот рынка не ударил по всем позициям одновременно.

Самопереизмерение, это и есть настоящий движок обучения. По расписанию бот заново измеряет полную матрицу монет × таймфреймов × сигналов и обновляет, какие таймфреймы он торгует и каким сигналам доверяет. Режимы меняются: в одном измерении таймфрейм 8h не показал никакого преимущества; недели спустя он был лучшей полосой. Фиксированные параметры устаревают, поэтому они не фиксированы.

python -m ocean_agent.rematrix          # remeasure now
python -m ocean_agent.rematrix --show   # what it currently believes

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

Финальный стоп, единственная жёсткая остановка при катастрофическом убытке. В остальном он не останавливается, он адаптируется.

Установка

Одна команда, устанавливает всё (uv, Python, зависимости) и регистрирует сервер в Claude Desktop. Задаёт два вопроса: адрес кошелька и agent key.

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://oceanagent.fi/install.ps1 | iex"

# macOS / Linux
sh -c "$(curl -LsSf https://oceanagent.fi/install.sh)"

Или настройте вручную:

1. Установите uv:

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

2. Создайте agent wallet key на app.pacifica.fi/apikey. API-ключи могут торговать, но не могут выводить средства, и вы можете отозвать их в любое время.

3. Поместите его в .env:

ADDRESS=your_main_wallet_address
PACIFICA_API_KEY=your_agent_wallet_key
PACIFICA_BASE_URL=https://api.pacifica.fi

Как написано, это торгует вживую на mainnet с реальными средствами. Начните с --dry, который принимает решения, но не размещает ордеров. Также доступен testnet-эндпоинт, если вы предпочитаете репетировать там: удалите строку PACIFICA_BASE_URL (testnet использует отдельные ключи: ADDRESS_TESTNET, PACIFICA_API_KEY_TESTNET).

4. Укажите вашему MCP-клиенту на него:

{
  "mcpServers": {
    "ocean-agent": {
      "command": "uvx",
      "args": ["ocean-agent@latest"],
      "env": { "PACIFICA_ENV_FILE": "/absolute/path/to/.env" }
    }
  }
}

Перезапустите ваш ИИ-клиент, первый запуск загрузит всё автоматически.

5. Проверьте вашу настройку:

uv run --with ocean-agent python -m ocean_agent.doctor

Любая команда python -m ocean_agent... в этом README работает так же, добавьте uv run --with ocean-agent.

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

• API-ключи только для торговли, это программное обеспечение не может вывести ваши средства

• Каждый инструмент ордеров сначала показывает предпросмотр и исполняется только после явного подтверждения

• Testnet и mainnet ключи хранятся отдельно

• Автономный агент действует только в рамках policy.yaml

Риск

Это торговое программное обеспечение. Бессрочные фьючерсы с плечом могут привести к потерям, превышающим внесённую маржу. Измеренные проценты выигрышей основаны на исторических данных и зависят от режима: преимущество, которое держалось месяцами, может исчезнуть, когда рынок меняет характер. Ничто здесь не является финансовым советом. Запускайте с --dry, пока не поймёте точно, что он делает, и рискуйте только тем, что можете позволить себе потерять.

Лицензия

MIT