Pacifica MCP 技能

适用场景

当用户出现以下情况时触发：

• 询问 Pacifica / Solana 上的加密货币价格、永续合约（perps）或交易相关问题
• 希望查询其交易账户、持仓头寸或未成交订单
• 希望下单、修改订单或撤销订单
• 需要市场数据（如订单簿、K 线图、资金费率、最新成交记录）
• 提及 BTC、ETH、SOL 或 Pacifica 上任意永续合约标的
• 希望通过 WebSocket 实现实时价格/交易监控

不适用场景

• 通用知识类问题（例如：“什么是永续合约？”）
• 数学或计算类问题（例如：“1000 美元使用 10 倍杠杆是多少？”）
• 仅凭训练数据即可回答的问题

工具选择指南

参数说明

• symbol：永续合约使用大写无后缀格式 — BTC、ETH、SOL、DOGE；现货市场使用 SOL-USDC、BTC-USDC、ETH-USDC 格式。运行 pacifica-markets 可获取全部支持的 symbol 列表。
• side："bid" 表示做多/买入，"ask" 表示做空/卖出
• amount：始终为十进制字符串（如 "0.1"、"1.5"），最小订单价值为 10 美元。
• price：始终为十进制字符串（如 "70000"、"3500"）
• tif：GTC（默认）、IOC（立即成交否则取消）、ALO（仅挂单）、TOB（最优价成交）
• interval：1m、3m、5m、15m、30m、1h、2h、4h、8h、12h、1d

关键行为规范

• set-tpsl 中的 side 指的是退出方向，而非建仓方向：多头持仓 → side: "ask"；空头持仓 → side: "bid"。
• 以下操作成功时返回 null：set-leverage、set-margin-mode、set-tpsl。可通过 pacifica-account-settings 或 pacifica-positions 验证变更是否生效。
• 充值操作需在 Pacifica 网页端完成（测试网地址为 test-app.pacifica.fi，主网为 pacifica.fi），不可通过 MCP 或 CLI 执行。
• 钱包自动生成于首次运行时，路径为 ~/.pacifica-mcp/config.json。用户需将私钥导入 Phantom / Backpack 钱包以完成充值。
• 订单确认机制：交互式使用时，应在下单前简要向用户确认订单细节；自动化 / Bot 场景下可直接执行。
• 仅支持 USDC 提现。若用户持有 SOL 或其他现货资产并希望提现，须先在现货市场将其卖出（例如执行 pacifica-market-order symbol: "SOL-USDC" side: "ask"）兑换为 USDC，再发起提现。
• 子账户资金注入：须先通过网页端向主账户充值，再使用 pacifica-transfer-funds 将 USDC 划转至子账户。单笔最低划转金额为 10 美元。
• 现货市场（如 SOL-USDC、BTC-USDC、ETH-USDC）：可复用相同订单工具，但需使用现货 symbol 格式；最大杠杆为 1x（现货不支持杠杆）。

WebSocket（实时数据）

支持的频道（channel）：prices、trades、orderbook、account_info、account_positions、account_trades

• trades 和 orderbook 必须传入 symbol 参数。
• prices 频道会推送所有市场的行情 — 使用 watch-read 时建议启用 summary_only: true 参数，避免数据过载。
• watch-read 支持 max_events（默认值为 100）与 summary_only（默认值为 false）参数。

免签 vs 钱包签名要求

免签（无需钱包签名）：markets、prices、orderbook、candles、mark-candles、recent-trades、funding-rates、account、positions、orders、order-history、trade-history、portfolio、balance-history、order-by-id、account-settings、wallet、tools、watch、watch-start、watch-read、watch-stop

需钱包签名：market-order、limit-order、stop-order、set-tpsl、cancel-order、cancel-stop、edit-order、batch-order、set-leverage、set-margin-mode、create-subaccount、list-subaccounts、transfer-funds、withdraw

错误处理

典型工作流示例

开立杠杆多单

1. pacifica-prices (symbol: "BTC") → 查询标记价格
2. pacifica-set-leverage (symbol: "BTC", leverage: 10)
3. pacifica-market-order (symbol: "BTC", side: "bid", amount: "0.01")
4. pacifica-positions → 确认头寸已建立

风险管理

1. pacifica-positions → 查看当前持仓方向
2. pacifica-set-tpsl (symbol: "BTC", side: "ask", take_profit_price: "100000", stop_loss_price: "60000")
   （因是平多头，所以 side 为 "ask"）

实时监控与响应

1. pacifica-watch-start (channel: "trades", symbol: "BTC")
2. pacifica-watch-read (subscription_id: "...", summary_only: true) → 检查市场活跃度
3. pacifica-watch-stop → 清理订阅资源

CLI 替代方案

全部 36 个工具同样提供独立 CLI 版本，适用于终端环境：

npm install -g @pacifica-dev/cli

pacifica prices --symbol BTC
pacifica positions
pacifica market-order --symbol SOL --side bid --amount 0.5
pacifica wallet
pacifica watch --channel trades --symbol ETH --duration 10

输出格式为 JSON。可配合 jq 进行过滤： pacifica prices --symbol BTC | jq '.mark'

安装方式

# MCP 服务端（支持 Claude Code、Cursor、Windsurf、VS Code Copilot 等）
claude mcp add pacifica npx @pacifica-dev/mcp

# 独立 CLI 工具
npm install -g @pacifica-dev/cli