dYdX Agent Gateway

dYdX Agent Gateway

1 つの MCP サーバーに 22 個の読み取り専用ツールを備え、エージェントはデスクのアナリストのように dYdX v4 の情報を読み取れます。リアルタイムのファンディング、信頼できるトレーダー損益、異常検知、ランキングを確認できます。API キーは一切不要です。このゲートウェイは何も署名せず、何も保存せず、資金を動かすこともできません。

ユースケース

まず効果を発揮するのがコピー取引です。誰かをフォローする前に、trader_pnl_stats が入金と送金を考慮してそのトレーダーの資産曲線を照合します。差分を見れば、数字が本物かどうかが分かります。「今週のトップトレーダー」が実際には全期間で 1,271 ドルの損失を出し、77％のドローダウンを記録していたのを見て、この機能を作りました。

ファンディング分析では、各行に OI のコンテキストを添え、|rate| 順に並べたヒートマップ、実績に基づく 1 時間ごとのファンディング履歴、痛手につながる前兆パターンを検出する機能を利用できます。たとえば、価格が横ばいのまま OI が急上昇するパターンや、|Δprice|↑ + OI↓ のカスケードシグネチャーなどです。

トレーダーの発見は、スクレイピングではなくオンチェーンで行います。ブロックをスキャンするトレーダー登録簿、資金提供済みアカウントの検査、報酬目当てのファーマーではなくトレーダーをコピーするためのファーマーボットフラグを備えています。market_digest を 1 回呼び出すだけで、その日のイベント、ファンディングの極値、ランキング上位をまとめて取得できます。エントリーの準備ができたら、suggest_stops がポジション方向に応じた ATR ベースのストップ、利確水準、ブレークイーブントリガー、トレーリング水準を返します。

実際の出力を含む詳しい手順： examples/use-cases.md。

インストール

Claude Code:

claude mcp add dydx -- uvx dydx-agent-gateway

Claude Desktop / Cursor / 任意の mcp.json:

{"mcpServers": {"dydx": {
  "command": "uvx",
  "args": ["dydx-agent-gateway"]}}}

[mcp_servers.dydx]
command = "uvx"
args = ["dydx-agent-gateway"]

# 1) start the gateway (keep it running)
uvx dydx-agent-gateway --http --port 8901 &

# 2) register it (merges into ~/.zcode/cli/config.json; workspace .zcode/config.json works too)
python3 - <<'PY'
import json, os
p = os.path.expanduser("~/.zcode/cli/config.json")
os.makedirs(os.path.dirname(p), exist_ok=True)
cfg = json.load(open(p)) if os.path.exists(p) else {}
cfg.setdefault("mcp", {}).setdefault("servers", {})["dydx"] = {
    "type": "http", "url": "http://127.0.0.1:8901/mcp"}
json.dump(cfg, open(p, "w"), indent=2)
print("dydx MCP server registered:", p)
PY

# 3) copy the agent skill (tool guide + data gotchas)
git clone -q --depth 1 https://github.com/alekskram/dydx-agent-gateway /tmp/dag
cp -r /tmp/dag/.agents/skills/dydx-gateway ~/.zcode/skills/ && rm -rf /tmp/dag
echo "ZCode setup done, restart your session and call any dydx tool"

通常の Python:

pip install dydx-agent-gateway
python -c "from dydx_mcp import server; import json; print(json.dumps(server.market_digest(), default=str)[:400])"

ホスト型（ストリーミング可能な HTTP）： dydx-agent-gateway --http --port 8901 を実行し、任意のクライアントから接続します：

{"mcpServers": {"dydx": {"type": "http", "url": "http://host:8901/mcp"}}}

Python ≥ 3.11 が必要です。依存関係（fastmcp、pycryptodome、ecdsa）は自動的にインストールされます。すぐに使える設定と、動作する自律型エージェントのスクリプトは examples/ をご覧ください。

ツール（22 個 — 読み取り専用、キー不要）

すべてのツールの実際の出力：examples/tool-output.md。

実際のトレーダーの課題を解決する、ライブデータを使った 5 つのシナリオ：examples/use-cases.md。

何が違うのか

監査可能な PnL です。trader_pnl_stats は、すべてのアカウントで恒等式 equity-Δ = Δpnl + ΣnetTransfers を照合します。残差がゼロでない場合、数値に誤りがあり、ツールはその誤りを平均化して隠すのではなく、そのことを示します。実際のアカウントで実行したところ、残差は $0.0000 になりました。同じ処理で、入金調整後の最大 DD、日次勝率、シャープレシオに類似した比率も算出されます。

ダッシュボードではなく、検出機能です。ファンディングの極端な値、価格変動を伴わない OI の急増、エクイティの急変、清算カスケードの特徴（|Δprice|↑ + OI↓）を検出します。ライブで検出された結果は reports/ に保存されます。

そのほかはアナリスト向けの機能です。実績ファンディング履歴、約定データから算出する CVD、ベータを含む市場間相関、執行レビュー用の生約定データ、MACD／VWAP／実現ボラティリティによる拡張、ソルティノレシオに類似した下方リスク分析を利用できます。

そして、問題の原因を記録しておく習慣があります。素朴な分析を気付かないうちに破損させるインデクサーの落とし穴を5つ、.agents/skills/dydx-gateway/references/data-gotchas.md に記載しています。129件（現在は133件）のテストを、CI で Python 3.11 と 3.13 に対して実行しています。

なぜ生のインデクサー API ではなくゲートウェイなのか？

エージェントから indexer.dydx.trade に直接アクセスさせて、面倒が始まるまでどこまで進めるか試してみてください。

インデクサーの落とし穴として記載している5項目：.agents/skills/dydx-gateway/references/data-gotchas.md。

データに関する注意事項

インジケーターは現在のローソク足ウィンドウを対象に計算され、新しいバーが追加されるたびに変化します。nextFundingRate は取引所のライブ予測値で、継続的に再計算されます。volume24H はローリング値です。1分間隔で2回呼び出すと値が変わるのは正常であり、バグではありません。

安全性モデル

すべてのツールは読み取り専用で、キーは不要です。ゲートウェイは署名を行わず、認証情報も保持しません。オフラインテスト済みの EIP-712 署名機能は、独自の執行レイヤーを構築する人向けのライブラリとして dydx_mcp/signer.py に置かれています。いずれの MCP ツールにも接続されていません。

よくある質問

• 取引を行いますか？ いいえ。分析のみです。これが当初の設計方針です。
• API キーは必要ですか？ 不要です。公開インデクサーエンドポイントを使用します。
• レート制限はありますか？ 認証は不要です。60秒間のマーケットキャッシュにより、過剰なリクエストを防ぎます。
• コピーする前にトレーダーを評価するには？ trader_profile、次に trader_pnl_stats、その後 fills_review の順に確認してください。まず恒等式の残差とメイカー／テイカーの比率を確認してください。

スイートの一部

同じ設計方針を持つ、読み取り専用の兄弟 MCP ゲートウェイが4つあります。キー不要、キャッシュ対応、障害時も誠実に動作します。

4つすべてが glama.ai と PyPI で公開されています。いずれも uvx <name> でインストールできます。

ライセンス

MIT。dYdX Trading Inc. とは提携していません。