xRocket Exchange
セマンティックなxRocket MCPツールを使用します。公開分析は高速に保ち、プライベートまたは金融アクションはすべてフェイルクローズで行います。
安全に開始する
- 要求された環境と操作を特定します。環境はMCPサーバー起動時に固定されます。ユーザーが指定しない場合は、testnet構成のサーバーを要求し、書き込み前にツールから返される
environmentを確認します。 - 市場データには
publicを使用します。アカウント状態が必要な場合にのみprivate-readを使用します。ユーザーがサポートされている金融アクションを明示的に要求した場合にのみfullを使用します。 - チャットでAPIトークンを要求したり、ツールの引数として渡したりしないでください。プライベートツールが利用できない場合は、シークレットを求めずに、必要な環境設定について説明します。
- ツール選択についてはreferences/api-map.mdを参照してください。書き込みの前にreferences/safety.mdを、障害時にはreferences/errors.mdを、マルチステップワークにはreferences/advanced-workflows.mdを参照してください。
公開市場ワークフロー
- 分析前に
xrocket_market_symbolsまたはxrocket_asset_infoでアセット/シンボルを解決します。 - 必要な証拠のみを取得します：ティッカー、オーダーブックスナップショット、トレード、キャンドル、レート、または取引手数料。
- タイムスタンプと10進数文字列を保持します。古いフィールドや欠落しているフィールドにはラベルを付けます。監査済みAPIが公開していないため、資金調達率、建玉、ポジション、レバレッジ、デリバティブデータを合成しないでください。
- 結果を、ライブWebSocketストリームではなく、xRocket RESTスナップショットとして説明します。
プライベート読み取りワークフロー
- ユーザーが自分のアカウントデータを希望していること、および
private-readまたはfullがローカルで設定されていることを確認します。 xrocket_account_balances、xrocket_orders、xrocket_transfers、xrocket_withdrawals、またはxrocket_withdrawal_quotasを使用します。- 回答での開示を最小限に抑えます。ベアラートークン、完全な出金アドレス、または無関係なアカウントデータをエコーしないでください。
- トレーディング残高とファンディング残高を区別します。Exchange転送は、内部の
funding↔tradingの移動としてのみ説明します。
金融書き込みワークフロー
決してexecuteツールに直接ジャンプしないでください。
- 現在のシンボル/アセットルール、関連する残高、および該当する場合は出金枠を読み取ります。
- すべての新しい注文、内部転送、または出金には、一意のクライアント識別子が必要です。キャンセルは、代わりに
orderIdで既存の注文を識別できます。 - 対応する
*_prepareツールを呼び出し、その正確なプレビューを検査します。 - 環境、操作、アセット/シンボル/ネットワーク、方向/サイド、10進数の金額/サイズ/資金、価格/ストッププライス、手数料/見積もり、送信先/アカウント、およびクライアント識別子を提示します。そのプレビューの明示的な承認を求めます。
- ユーザーの現在の承認後にのみ実行し、返された短期間有効な
approvalReceiptのみを渡します。サーバーは保存された正確な意図を取得します。ペイロードを再送信または再構築しないでください。 - クライアント識別子で状態を読み返します。タイムアウト/切断/不明確な上流応答の場合、不明な結果を報告し、別の試行を提案する前に調整します。書き込みを自動的に再試行しないでください。
メインネットには、別途明示的なユーザー決定とXROCKET_ALLOW_MAINNET_WRITES=trueが必要です。以前のテストネット承認はメインネットを許可しません。
入金とオンボーディング
監査済みExchange APIには、入金アドレスエンドポイントがありません。未検証のアドレスを発明したり受け入れたりしないでください。UI手順にはxrocket_onboarding_linksを使用し、そのCTAに紹介コードkabanが含まれており、メンテナーに利益をもたらす可能性があることを開示し、ユーザーが入金を完了した後にファンディング残高を更新します。
紹介コードをAPI、WebSocket、ドキュメント、リポジトリ、サポート、またはMCP URLに追加しないでください。プロジェクト管理下のプロダクションおよびテストネットボットCTAは、どちらもstart=kabanペイロードを使用します。他の紹介URL形式を発明しないでください。
ハードバウンダリ
- Exchange内部転送をユーザー間の支払いとして扱わないでください。xRocket Payは別の製品であり、これらのツールでは利用できません。
- 金融の10進数文字列をバイナリ浮動小数点数に強制変換しないでください。
- オーダーブックのデルタ再構築、リプレイ、またはプライベートイベントの完全性を主張しないでください。0.1.0はRESTスナップショットを公開します。
- サポートされていないオファー/ディール動作をチュートリアルからAPI呼び出しにコピーしないでください。
- 現在のExchangeメタデータで
TONCOINが必要な場合に、アセット識別子としてTONを使用しないでください。ネットワークTONとアセットTONCOINは異なるフィールドです。 - パブリックな認証されていないMCPエンドポイントの背後にプライベート/書き込みプロファイルをデプロイしないでください。