ocean-agent

🧪 封闭测试 — Ocean Agent 截至 2026 年 8 月 11 日处于封闭测试阶段。 经过实测的 bracket 交易引擎首先用我们自己的资金进行实盘验证。 公开测试版下周开放，开放测试版再下一周。 在 Telegram 上关注每日记分卡。

English · 한국어

🌊 网站： oceanagent.fi · PyPI： ocean-agent

告诉你的 AI 去交易。 一个面向 Pacifica 的 MCP 服务器，将自然语言转换为正确、按风险定规模的永续合约订单，外加一个由你控制的策略文件治理的 24/7 自主交易实体。

uvx ocean-agent        # no install needed

⚠️ 这会用真实资金下达真实订单。在连接账户之前，请阅读免责声明。

完全基于 Pacifica 构建。直接调用 Pacifica REST API，使用与官方工具相同的 Ed25519 代理密钥签名，无 npm 依赖。

为什么用这个而不是原始 API 访问

官方 Pacifica MCP 按原样暴露 API：你的 AI 必须自行计算精确的价格和数量，而如果价格不是市场最小变动价位的倍数，交易所会拒绝。ocean-agent 在其之上增加了一层：

Related MCP server: asterdex-mcp-server

MCP 工具

市场与分析

• analyze_chart，多时间框架指标快照，包含该特定币种和时间框架上每个信号的实测命中率。当不存在优势时会显示“未检测到优势”。

• top_setups，经统计验证的形态的实时排名（期望值 × 胜率 × 样本置信度），包含入场、止损、目标和杠杆

• market_context，恐惧与贪婪指数市场状态读取

• scan_funding，按资金费率 APR 对所有市场进行排名

• learned_winrates / learned_combos，基于实盘观察构建的胜率数据库，包括多信号组合

• review_predictions，根据实际发生情况对过去的预测进行评分

交易

• open_with_bracket，一次调用完成入场并附带交易所原生止盈/止损。止损单驻留在交易所上，即使你的机器关机也会触发。

• protect_position，为任何未平仓头寸加装原生止盈/止损

• open_funding_position / close_funding_position，以原子批量方式执行 delta 中性资金费率套利（现货买入 + 永续做空）

• 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 服务器只在你的 AI 客户端调用它时运行；而一个必须全天候持有头寸并管理止损的交易者需要自己的进程。有意启动它后，无论是否有 AI 连接，它都会持续运行。

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 启动。

每个周期它都会读取市场、评估所学内容、管理未平仓头寸，并且只进入通过所有门槛的形态。

投资组合分桶，资金在方向性交易、资金费率套利和现金储备之间分配，每个周期重新平衡。

持仓后续管理，一旦交易盈利，将止损移至盈亏平衡点；随着利润增长进行移动止损，并在目标位部分止盈。止损只会朝有利方向移动。

流动性门槛，跳过你自己的订单将占日成交量很大比例的市场。薄盘才是真正的危险：订单只能部分成交，止损无法按其价格执行。

净敞口限制，限制整个账簿的单向程度，这样单一市场反转不会同时冲击所有头寸。

自我重新测量，这是真正的学习引擎。机器人按计划重新测量币种 × 时间框架 × 信号的完整矩阵，并更新它交易哪些时间框架、信任哪些信号。市场状态会变化：在某次测量中，8 小时时间框架完全没有优势；几周后它却成了表现最好的区间。固定参数会过时，所以它们不是固定的。

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

自适应，在实盘评估中失利的信号会被暂停，回撤期间削减仓位，恢复后重新加回。参数在策略边界内自适应；机器人从不重写自己的代码。

最终止损，在灾难性损失时一次性硬性停止。否则它不会停止，而是自适应。

设置

一条命令，安装所有内容（uv、Python、依赖）并向 Claude Desktop 注册服务器。它会询问两个问题：钱包地址和代理密钥。

# 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. 在 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

按此配置，它会在主网上用真实资金实盘交易。先用 --dry 启动，它会做决策但不下任何订单。如果你更愿意在测试网上演练，也可以使用测试网端点：删除 PACIFICA_BASE_URL 行（测试网使用单独的密钥：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" }
    }
  }
}

重启你的 AI 客户端，首次启动会自动下载所有内容。

5. 检查你的设置：

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

本 README 中的任何 python -m ocean_agent... 命令都以相同方式运行，在前面加上 uv run --with ocean-agent。

安全

• API 密钥仅限交易使用，本软件无法将你的资金转出

• 每个订单工具都会先预览，并且仅在明确确认后执行

• 测试网和主网密钥分开保存

• 自主实体仅在 policy.yaml 范围内行动

风险

这是交易软件。杠杆永续合约的亏损可能超过你缴纳的保证金。实测胜率来自历史数据，并且依赖于市场状态；一个持续数月的优势可能在市场性质改变时消失。这里的一切都不构成财务建议。先用 --dry 运行，直到你完全了解它的行为，并且只承担你能够承受的损失。

许可证

MIT