nakazanie-ton/myrocket

xRocket 交易所

使用语义化的 xRocket MCP 工具。保持公开分析快速，并确保所有私密或金融操作在失败时安全关闭。

安全启动

1. 识别请求的环境和操作。环境在 MCP 服务器启动时固定：当用户未指定时，要求使用配置了测试网的服务器，并在任何写操作前验证工具返回的 environment。
2. 市场数据使用 public。仅当需要账户状态时使用 private-read。仅当用户明确请求支持的金融操作时使用 full。
3. 切勿在聊天中询问 API 令牌或将其作为工具参数传递。如果私有工具不可用，说明所需的环境配置，不要索要密码。
4. 阅读 references/api-map.md 以选择工具。在任何写操作前阅读 references/safety.md，失败时阅读 references/errors.md，多步骤工作时阅读 references/advanced-workflows.md。

公开市场工作流

1. 在分析前使用 xrocket_market_symbols 或 xrocket_asset_info 解析资产/交易对。
2. 只获取所需的证据：行情、订单簿快照、交易、K线、汇率或交易费用。
3. 保留时间戳和小数字符串。标记过时或缺失的字段；不要合成资金费率、未平仓量、头寸、杠杆或衍生品数据，因为经过审计的 API 不公开这些数据。
4. 将结果描述为 xRocket REST 快照，而不是实时 WebSocket 流。

私人读取工作流

1. 确认用户希望访问其账户数据，并且本地配置了 private-read 或 full 模式。
2. 使用 xrocket_account_balances、xrocket_orders、xrocket_transfers、xrocket_withdrawals 或 xrocket_withdrawal_quotas。
3. 在回答中最小化信息披露。不要回显承载令牌、完整的提现地址或不相关的账户数据。
4. 区分交易余额和资金余额。仅将交易所内部转账描述为内部的 funding ↔ trading 划转。

金融写操作工作流

永远不要直接跳转到执行工具。

1. 读取当前的交易对/资产规则、相关余额，以及（如果适用）提现限额。
2. 每个新订单、内部转账或提现都必须有唯一的客户端标识符。取消操作可以通过 orderId 识别现有订单。
3. 调用匹配的 *_prepare 工具并检查其精确预览。
4. 呈现环境、操作、资产/交易对/网络、方向/买卖方向、十进制数量/大小/金额、价格/止损价、费用/预估、目标/账户和客户端标识符。要求用户明确批准该预览。
5. 仅在用户当前批准后执行，只传递返回的短暂 approvalReceipt。服务器会检索确切的存储意图；不要重新提交或重构有效载荷。
6. 通过客户端标识符回读状态。如果发生超时/断开/上游响应不明确，报告结果未知并在提议再次尝试前进行核对。永远不要自动重试写操作。

主网需要用户单独明确决定并设置 XROCKET_ALLOW_MAINNET_WRITES=true。之前的测试网批准不授权主网操作。

存款和入门

经过审计的交易 API 没有存款地址端点。不要虚构或接受未经验证的地址。使用 xrocket_onboarding_links 获取 UI 说明，披露其 CTA 包含推荐码 kaban 并可能使维护者受益，然后在用户完成存款后刷新资金余额。

切勿将推荐码附加到 API、WebSocket、文档、仓库、支持或 MCP URL 中。项目管理的生产和测试网机器人由工具返回的 CTA 均使用 start=kaban 有效载荷；不要发明其他形式的推荐 URL。

硬性边界

• 不要将交易所内部转账视为用户对用户的支付。xRocket Pay 是一个独立的产品，不通过这些工具提供。
• 不要通过二进制浮点数强制转换金融小数字符串。
• 不要声称可以重构订单簿增量、重放或保证私密事件完整性；0.1.0 版本仅提供 REST 快照。
• 不要将教程中不支持的报价/交易行为复制到 API 调用中。
• 在当前的交易所元数据要求 TONCOIN 的地方，不要使用 TON 作为资产标识符；网络 TON 和资产 TONCOIN 是不同的字段。
• 不要在公开的未经身份认证的 MCP 端点后面部署私有/写操作配置文件。