ocean-agent

🧪 CLOSED BETA — Ocean Agent befindet sich seit dem 11. August 2026 in der Closed Beta. Die gemessene Bracket-Trading-Engine wird zunächst mit eigenen Mitteln live validiert. Die öffentliche Beta startet nächste Woche, die offene Beta in der Woche darauf. Verfolge das tägliche Scoreboard auf Telegram.

English · 한국어

🌊 Website: oceanagent.fi · PyPI: ocean-agent

Sag deiner KI, sie soll handeln. Ein MCP-Server für Pacifica, der natürliche Sprache in korrekte, risikobemessene Perpetual-Futures-Orders umwandelt, plus eine rund um die Uhr aktive autonome Trading-Entität, die durch eine von dir kontrollierte Policy-Datei gesteuert wird.

uvx ocean-agent        # no install needed

⚠️ Dies platziert echte Orders mit echtem Geld. Lies den Haftungsausschluss, bevor du ein Konto verbindest.

Vollständig auf Pacifica aufgebaut. Ruft die Pacifica-REST-API direkt mit derselben Ed25519-Agent-Key-Signierung auf, die auch die offiziellen Tools verwenden, ohne npm-Abhängigkeit.

Warum das statt direktem API-Zugriff

Die offizielle Pacifica-MCP-API stellt die API unverändert bereit: Deine KI muss exakte Preise und Größen selbst berechnen, und ein Preis, der kein Vielfaches der Tick-Größe des Marktes ist, wird von der Börse abgelehnt. ocean-agent fügt die Ebene darüber hinzu:

Related MCP server: asterdex-mcp-server

MCP-Tools

Markt & Analyse

• analyze_chart, Multi-Zeitrahmen-Indikator-Snapshot mit gemessenen Trefferquoten pro Signal auf genau dieser Münze und diesem Zeitrahmen. Sagt „kein Edge erkannt", wenn keiner vorhanden ist.

• top_setups, Live-Ranking statistisch belegter Setups (EV × Gewinnrate × Stichproben-Konfidenz), mit Einstieg, Stop, Ziel und Hebel

• market_context, Fear & Greed-Regime-Lesung

• scan_funding, alle Märkte nach Funding-APR sortiert

• learned_winrates / learned_combos, Gewinnraten-Datenbank, aufgebaut aus Live-Beobachtung, einschließlich Multi-Signal-Kombinationen

• review_predictions, vergangene Calls, bewertet anhand dessen, was tatsächlich passiert ist

Trading

• open_with_bracket, Einstieg plus börseneigene TP/SL in einem Aufruf. Die Stops liegen an der Börse, sodass sie auch bei ausgeschaltetem Rechner auslösen.

• protect_position, nachträgliche native TP/SL auf jede offene Position

• open_funding_position / close_funding_position, delta-neutrale Funding-Carry (Spot-Kauf + Perp-Short), atomar als Batch ausgeführt

• plan_oi_hedge, dimensioniert eine OI-Farming-Position mit ihrem Cross-Exchange-Hedge, inklusive Gebühren- und Funding-Mathematik

• open_pacifica_leg, check_position, account_status

Print (experimentell, nutzt einen Endpunkt, den Pacifica nicht dokumentiert hat; kann ohne Vorankündigung geändert werden)

• print_quote, Live-Prämie, implizite Volatilität und Liquidationspreis

• print_order / print_status / print_close

• evaluate_print, statistisches Urteil, ob ein Print-Angebot es wert ist: Fill-Wahrscheinlichkeit, durchschnittlicher Overshoot und der Break-even-APY, der das kompensieren würde

Autonome Trading-Entität

Ein selbstgesteuerter Trader, gesteuert durch policy.yaml, einen Delegationsvertrag. Er kann sich nicht außerhalb dieser Grenzen bewegen.

Dies ist ein separater, immer laufender Prozess, kein MCP-Tool. Ein MCP-Server läuft nur, wenn dein KI-Client ihn aufruft; ein Trader, der Positionen halten und Stops rund um die Uhr verwalten muss, braucht einen eigenen Prozess. Starte ihn bewusst, und er läuft weiter, ob nun eine KI verbunden ist oder nicht.

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

Lies policy.yaml vor dem ersten echten Lauf: Kapital, Hebel-Limit, Risiko pro Trade und die harte Stop-Schwelle stehen dort. Starte mit --dry.

Jeder Zyklus liest den Markt, bewertet, was er gelernt hat, verwaltet offene Positionen und geht nur Setups ein, die jedes Gate passieren.

Portfolio-Buckets, Kapital aufgeteilt in direktionales Trading, Funding-Carry und eine Barreserve, jeden Zyklus neu ausbalanciert.

Positions-Nachsorge, verschiebt den Stop auf Break-even, sobald ein Trade im Plus ist, zieht ihn nach, wenn der Gewinn wächst, und nimmt Teilgewinne am Ziel. Stops bewegen sich nur zu deinen Gunsten.

Liquiditäts-Gate, überspringt Märkte, in denen deine eigene Order einen großen Anteil des Tagesvolumens ausmachen würde. Dünne Bücher sind die echte Gefahr: eine Order, die nur teilweise gefüllt wird, und ein Stop, der zu seinem Preis nicht ausführbar ist.

Netto-Exposure-Limit, begrenzt, wie einseitig das Buch werden kann, sodass eine einzelne Marktumkehr nicht alle Positionen gleichzeitig trifft.

Selbst-Neumessung, das ist die eigentliche Lern-Engine. Nach einem Zeitplan misst der Bot die gesamte Matrix aus Münzen × Zeitrahmen × Signalen neu und aktualisiert, welche Zeitrahmen er handelt und welchen Signalen er vertraut. Regime ändern sich: In einer Messung zeigte der 8h-Zeitrahmen überhaupt keinen Edge; Wochen später war er das beste Band. Feste Parameter werden stale, also sind sie nicht fest.

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

Adaption, Signale, die im Live-Grading verlieren, werden ausgesetzt, die Größe wird während eines Drawdowns reduziert und bei Erholung wiederhergestellt. Parameter passen sich innerhalb der Policy-Grenzen an; der Bot schreibt nie seinen eigenen Code um.

Finaler Stop, ein einziger harter Halt bei katastrophalem Verlust. Ansonsten stoppt er nicht, er passt sich an.

Einrichtung

Ein Befehl, installiert alles (uv, Python, Abhängigkeiten) und registriert den Server bei Claude Desktop. Er stellt zwei Fragen: Wallet-Adresse und 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)"

Oder manuell einrichten:

1. Installiere 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. Erstelle einen Agent-Wallet-Key unter app.pacifica.fi/apikey. API-Keys können handeln, aber keine Gelder abheben, und du kannst sie jederzeit widerrufen.

3. Füge ihn in .env ein:

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

Wie geschrieben handelt dies live auf dem Mainnet mit echtem Geld. Starte mit --dry, das entscheidet, platziert aber keine Orders. Ein Testnet-Endpunkt ist ebenfalls verfügbar, falls du dort proben möchtest: Entferne die Zeile PACIFICA_BASE_URL (Testnet verwendet separate Keys: ADDRESS_TESTNET, PACIFICA_API_KEY_TESTNET).

4. Richte deinen MCP-Client darauf aus:

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

Starte deinen KI-Client neu, der erste Start lädt alles automatisch herunter.

5. Überprüfe deine Einrichtung:

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

Jeder python -m ocean_agent...-Befehl in dieser README läuft auf dieselbe Weise, stelle uv run --with ocean-agent voran.

Sicherheit

• API-Keys sind nur für den Handel, diese Software kann deine Gelder nicht abziehen

• Jedes Order-Tool zeigt zuerst eine Vorschau und führt nur nach expliziter Bestätigung aus

• Testnet- und Mainnet-Keys werden getrennt gehalten

• Die autonome Entität handelt nur innerhalb von policy.yaml

Risiko

Dies ist Trading-Software. Gehebelte Perpetual-Futures können mehr verlieren als die Margin, die du hinterlegst. Gemessene Gewinnraten stammen aus historischen Daten und sind regimeabhängig; ein Edge, der monatelang hielt, kann verschwinden, wenn der Markt seinen Charakter ändert. Nichts hier ist Finanzberatung. Führe es mit --dry aus, bis du genau verstehst, was es tut, und riskiere nur, was du dir leisten kannst zu verlieren.

Lizenz

MIT