ocean-agent

🧪 BETA CERRADA — Ocean Agent está en beta cerrada desde el 11 de agosto de 2026. El motor de trading con brackets medido se está validando en vivo con nuestros propios fondos primero. La beta pública se abre la próxima semana, y la beta abierta la siguiente. Sigue el marcador diario en Telegram.

Inglés · 한국어

🌊 Sitio web: oceanagent.fi · PyPI: ocean-agent

Dile a tu IA que opere. Un servidor MCP para Pacifica que convierte el lenguaje natural en órdenes correctas y de tamaño de riesgo de futuros perpetuos, además de una entidad de trading autónoma 24/7 gobernada por un archivo de política que tú controlas.

uvx ocean-agent        # no install needed

⚠️ Esto coloca órdenes reales con dinero real. Lee el aviso legal antes de conectar una cuenta.

Construido enteramente sobre Pacifica. Llama a la API REST de Pacifica directamente con el mismo firmado de clave de agente Ed25519 que usa la herramienta oficial, sin dependencia de npm.

Por qué esto en lugar de acceso directo a la API

El MCP oficial de Pacifica expone la API tal cual: tu IA debe calcular precios y tamaños exactos por sí misma, y un precio que no sea múltiplo del tamaño de tick del mercado es rechazado por el exchange. ocean-agent añade la capa por encima:

Related MCP server: asterdex-mcp-server

Herramientas MCP

Mercado y análisis

• analyze_chart, instantánea de indicadores multi-timeframe con tasas de acierto medidas por señal en esa moneda y plazo específicos. Dice "no se detecta ventaja" cuando no la hay.

• top_setups, ranking en vivo de configuraciones estadísticamente probadas (EV × tasa de acierto × confianza de la muestra), con entrada, stop, objetivo y apalancamiento

• market_context, lectura del régimen de Miedo y Codicia

• scan_funding, todos los mercados clasificados por APR de financiación

• learned_winrates / learned_combos, base de datos de tasas de acierto construida con observación en vivo, incluyendo combinaciones de múltiples señales

• review_predictions, llamadas pasadas calificadas contra lo que realmente sucedió

Trading

• open_with_bracket, entrada más TP/SL nativo del exchange en una sola llamada. Los stops viven en el exchange, así que se ejecutan incluso con tu máquina apagada.

• protect_position, retroadaptar TP/SL nativo a cualquier posición abierta

• open_funding_position / close_funding_position, carry de financiación delta-neutral (compra spot + corto perp) ejecutado atómicamente como lote

• plan_oi_hedge, dimensiona una posición de cultivo de OI con su cobertura entre exchanges, incluyendo comisiones y matemáticas de financiación

• open_pacifica_leg, check_position, account_status

Print (experimental, usa un endpoint que Pacifica no ha documentado; puede cambiar sin previo aviso)

• print_quote, prima en vivo, volatilidad implícita y precio de liquidación

• print_order / print_status / print_close

• evaluate_print, veredicto estadístico sobre si una oferta de Print vale la pena: probabilidad de ejecución, exceso promedio y el APY de equilibrio que lo compensaría

Entidad de trading autónoma

Un trader autodirigido gobernado por policy.yaml, un contrato de delegación. No puede actuar fuera de esos límites.

Este es un proceso separado siempre activo, no una herramienta MCP. Un servidor MCP solo se ejecuta cuando tu cliente de IA lo llama; un trader que debe mantener posiciones y gestionar stops las 24 horas necesita su propio proceso. Inícialo deliberadamente, y sigue ejecutándose esté o no conectada una IA.

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

Lee policy.yaml antes de la primera ejecución real: capital, límite de apalancamiento, riesgo por operación y el umbral de parada dura están ahí. Comienza con --dry.

Cada ciclo lee el mercado, califica lo que aprendió, gestiona posiciones abiertas y solo entra en configuraciones que superan todos los filtros.

Categorías de cartera, capital dividido entre trading direccional, carry de financiación y una reserva de efectivo, reequilibrado cada ciclo.

Cuidado posterior de la posición, mueve el stop al punto de equilibrio cuando una operación está en ganancia, lo sigue a medida que crece el beneficio y toma beneficios parciales en el objetivo. Los stops solo se mueven a tu favor.

Filtro de liquidez, evita mercados donde tu propia orden sería una gran parte del volumen diario. Los libros delgados son el peligro real: una orden que solo se llena parcialmente, y un stop que no puede ejecutarse a su precio.

Límite de exposición neta, limita cuán unidireccional puede ser el libro, para que una sola reversión del mercado no pueda golpear todas las posiciones a la vez.

Auto-medición, este es el motor de aprendizaje real. En un horario, el bot vuelve a medir la matriz completa de monedas × plazos × señales y actualiza qué plazos opera y qué señales confía. Los regímenes cambian: en una medición el plazo de 8h no mostró ninguna ventaja; semanas después era la banda con mejor rendimiento. Los parámetros fijos se vuelven obsoletos, así que no son fijos.

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

Adaptación, las señales que pierden en la calificación en vivo se suspenden, el tamaño se reduce durante las pérdidas y se restaura en la recuperación. Los parámetros se adaptan dentro de los límites de la política; el bot nunca reescribe su propio código.

Parada final, una detención dura ante pérdida catastrófica. De lo contrario, no se detiene, se adapta.

Configuración

Un comando, instala todo (uv, Python, dependencias) y registra el servidor con Claude Desktop. Hace dos preguntas: dirección de billetera y clave de agente.

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

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

O configúralo manualmente:

1. Instala 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. Crea una clave de billetera de agente en app.pacifica.fi/apikey. Las claves API pueden operar pero no pueden retirar fondos, y puedes revocarlas en cualquier momento.

3. Ponla en .env:

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

Tal como está escrito, esto opera en vivo en mainnet con fondos reales. Comienza con --dry, que decide pero no coloca órdenes. También hay un endpoint de testnet disponible si prefieres ensayar allí: elimina la línea PACIFICA_BASE_URL (testnet usa claves separadas: ADDRESS_TESTNET, PACIFICA_API_KEY_TESTNET).

4. Apunta tu cliente MCP a él:

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

Reinicia tu cliente de IA, el primer lanzamiento descarga todo automáticamente.

5. Verifica tu configuración:

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

Cualquier comando python -m ocean_agent... en este README se ejecuta de la misma manera, antepón uv run --with ocean-agent.

Seguridad

• Las claves API son solo de trading, este software no puede mover tus fondos fuera

• Cada herramienta de órdenes previsualiza primero y ejecuta solo con confirmación explícita

• Las claves de testnet y mainnet se mantienen separadas

• La entidad autónoma actúa solo dentro de policy.yaml

Riesgo

Esto es software de trading. Los futuros perpetuos apalancados pueden perder más que el margen que depositas. Las tasas de acierto medidas provienen de datos históricos y dependen del régimen, una ventaja que se mantuvo durante meses puede desaparecer cuando el mercado cambia de carácter. Nada aquí es asesoramiento financiero. Ejecútalo con --dry hasta que entiendas exactamente qué hace, y solo arriesga lo que puedas permitirte perder.

Licencia

MIT