trade-router-mcp

Trade Router — ClawHub スキル

AI エージェント向けの、カストディアルではない Solana 取引 API です。 スワップ、MEV 保護付き執行、ウォレットの保有資産、指値注文、トレーリングストップ、DCA、TWAP、コンボ注文を単一のインターフェースで利用できます。秘密鍵は API を呼び出すエージェントが保持します。

安全ですか？

はい。その理由を詳しく説明します。 秘密鍵が api.traderouter.ai にネットワーク経由で送信されることはありません。POST /swap は 署名されていない トランザクションを返し、エージェントがローカルで署名します。その後、署名済み トランザクションだけが POST /protect（Jito の MEV 保護付きバンドル）に送信されます。サーバーの応答は、ハードコードされた信頼アンカーを使って Ed25519 で検証されます。脅威モデル、データフロー図、権限マニフェストの詳細については、SECURITY.md をご覧ください。

署名の流れ：

1. エージェントがスキルの swap アクションを呼び出す → api.traderouter.ai への HTTPS リクエストで、ウォレットの アドレス（公開鍵）、トークンのミントアドレス、数量を送信します
2. API が 署名されていない トランザクションを返します
3. エージェントが秘密鍵を使って、ローカルでトランザクションに 署名します
4. 署名済み トランザクションが /protect（Jito の MEV 保護付きバンドル）に送信されます
5. サーバーが確認を行い、残高の変更を返します。秘密鍵がエージェントのマシンから外に出ることはありません。

このスキルを利用する 2 つの方法

A. API を直接統合する（SKILL.md の説明を参照）

API 仕様の全容については SKILL.md をご覧ください。REST エンドポイント、WebSocket 注文プロトコル、リクエストとレスポンスの形式、エラー処理、エージェントの参考実装コードが記載されています。任意の HTTP クライアントと Solana 署名ライブラリを組み合わせてください。

SKILL.md のサンプルコードでは、次の規約を使用しています（自由に変更できます。これらはエージェント側の選択であり、API が強制するものではありません）。

サンプル環境変数	サンプルのデフォルト値	参考エージェントでの用途
PRIVATE_KEY	（必須）	エージェントプロセスが保持する Solana の base58 秘密鍵
DRY_RUN	true	安全を優先するためのゲート。スワップアクションは DRY_RUN=false に設定した場合のみ送信されます
MAX_DAILY_LOSS_LAMPORTS	2_000_000_000（2 SOL）	上限を超えると、参考エージェントの KILL_SWITCH が作動します

これらは参考エージェント独自の規約です。API 自体は、これらを必要としません。

B. すぐに使える MCP サーバー（@traderouter/trade-router-mcp）

Claude Desktop、Cursor、Cline、および任意の MCP 対応クライアントでは、公開済みの MCP サーバーを通じて同じ API を利用できます。

npx -y @traderouter/trade-router-mcp

または、MCP クライアントの設定に追加してください。

{
  "mcpServers": {
    "traderouter": {
      "command": "npx",
      "args": ["-y", "@traderouter/trade-router-mcp"],
      "env": {
        "TRADEROUTER_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

MCP サーバーの環境変数の規約は SKILL.md のサンプルコードとは異なり、複数の MCP を使う環境で名前空間を整理できるよう、TRADEROUTER_ が接頭辞として付いています。

MCP 環境変数	必須	用途
TRADEROUTER_PRIVATE_KEY	✅	Solana の base58 秘密鍵（ローカルでのみ使用）
SOLANA_RPC_URL	❌	カスタム RPC（デフォルトは mainnet-beta）
TRADEROUTER_SERVER_PUBKEY	❌	サーバーの Ed25519 信頼アンカーを上書きします
TRADEROUTER_SERVER_PUBKEY_NEXT	❌	サーバーの鍵のローテーション中に、追加の鍵を受け入れます
TRADEROUTER_REQUIRE_SERVER_SIGNATURE	❌	デフォルトは true。order_filled の検証に失敗した場合、処理を拒否します
TRADEROUTER_REQUIRE_ORDER_CREATED_SIGNATURE	❌	デフォルトは true。order_created の検証に失敗した場合、処理を拒否します

MCP サーバーには現在、DRY_RUN や日次損失上限は実装されていません。これらは SKILL.md の参考エージェントのサンプルにのみ含まれています。これらを一貫して適用する必要がある場合は、参考エージェントのパターンを直接使用するか、独自のゲートで MCP ツールの呼び出しをラップしてください。

詳細、21 個すべてのツール、および LangChain アダプターのコード例については、npm パッケージの README をご覧ください：https://www.npmjs.com/package/@traderouter/trade-router-mcp

機能

REST エンドポイント

エンドポイント	目的
POST /swap	署名前のスワップを構築します（複数の DEX に対応：Raydium、PumpSwap、Orca、Meteora）
POST /protect	Jito バンドル経由で署名済み tx を送信します。MEV から保護され、確定した残高の変化を返します
POST /holdings	正確なウォレットスキャンを実行します。標準 RPC で検出できないトークンも検出します
GET /mcap	任意のトークンの時価総額と価格を取得します
GET /flex	取引カードの PNG を生成します
GET /security	サーバーの信頼アンカー公開鍵を取得します

WebSocket（wss://api.traderouter.ai/ws）

サーバー側で注文を監視するための永続的な接続です。

• 指値注文 — 時価総額または価格でトリガーします
• トレーリングストップ — 率または絶対値で設定します
• DCA / TWAP — 時間加重で約定します
• コンボ注文 — 指値+トレーリング、指値+TWAP、トレーリング+TWAP、指値+トレーリング+TWAP

サーバーは約 5 秒ごとに時価総額を確認します。注文がトリガーされると、署名前の tx が届きます。ローカルで署名してから送信してください。

信頼アンカー

組み込みのサーバー公開鍵は EXX3nRzfDUvbjZSmxFzHDdiSYeGVP1EGr77iziFZ4Jd4 です。すべての order_filled、order_created、twap_execution メッセージは、信頼できる情報として扱う前に、この鍵を使用して Ed25519 で検証されます。サーバーは TRADEROUTER_SERVER_PUBKEY_NEXT を使用して鍵をローテーションできます。

手数料

/protect のルーティングに組み込まれた、スワップ取引高に対する一律 1% の手数料です。サブスクリプション、API キー、月額最低利用料はありません。読み取り専用のエンドポイント（/holdings、/mcap）は無料です。

リンク

• ウェブサイト： https://traderouter.ai
• llms.txt： https://traderouter.ai/llms.txt
• npm（MCP サーバー）： https://www.npmjs.com/package/@traderouter/trade-router-mcp
• PyPI（MCP サーバー）： https://pypi.org/project/traderouter-mcp/
• MCP Registry： https://registry.modelcontextprotocol.io/v0/servers?search=trade-router
• ClawHub の掲載ページ： https://clawhub.ai/re-bruce-wayne/trade-router
• GitHub のソース： https://github.com/re-bruce-wayne/openclaw-skills/tree/main/trade-router
• X/Twitter： https://x.com/trade_router
• Moltbook： https://moltbook.com/u/traderouter

セキュリティに関する報告

脆弱性を発見しましたか？[email protected] にメールするか、このリポジトリで GitHub Security Advisories を利用してください。48 時間以内に受領確認を行います。ポリシーの全文は SECURITY.md をご覧ください。

ライセンス

MIT。LICENSE をご覧ください。

変更履歴

CHANGELOG.md をご覧ください。