dYdX Agent Gateway

dYdX Agent Gateway

一个 MCP 服务，提供 22 个只读工具，让你的 Agent 突然能够像交易台分析师一样读取 dYdX v4：实时资金费率、可信的交易者 PnL、异常检测器和排行榜。不需要任何 API 密钥。这个网关不会签署任何内容、不会存储任何内容，即使它想，也无法转移资金。

使用场景

跟单交易是它最先发挥作用的场景。在你跟随任何人之前，trader_pnl_stats 会根据存款和转账核对他们的权益曲线；差额能告诉你这些数字是否真实。我们是在看到一位“本周顶级交易者”后开发它的，结果发现这位交易者历史累计亏损 1,271 美元，最大回撤达 77%。

资金费率分析：按 |rate| 排序的热力图，每行都带有 OI 背景信息；已实现的 1h 资金费率历史；以及用于检测先兆风险模式的检测器，例如 OI 飙升而价格横盘，或 |Δprice|↑ + OI↓ 的连锁特征。

发现交易者依靠链上数据，而非抓取数据：通过扫描区块建立的交易者注册表、已注资账户探测器，以及农场机器人标记，帮助你跟随交易者而非奖励农场。一次 market_digest 调用即可在单个响应中获取当天的事件、资金费率极值和排行榜前列。准备入场时，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])"

**托管服务（streamable HTTP）：**运行 dydx-agent-gateway --http --port 8901，然后使用任意客户端：

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

需要 Python ≥ 3.11。依赖项（fastmcp、pycryptodome、ecdsa）会自动安装。请参阅 examples/，其中提供了现成的配置和可运行的自主 Agent 脚本。

工具（22 个，只读，无需密钥）

所有工具的真实输出：examples/tool-output.md。

解决真实交易者问题：五个使用实时数据的场景：examples/use-cases.md。

有何不同

可审计的 PnL。trader_pnl_stats 会对每个账户核对恒等式 equity-Δ = Δpnl + ΣnetTransfers；残差不为零时，数据就有问题，该工具会如实指出，而不是把问题平均掉。我们用真实账户运行过该工具，残差结果为 $0.0000。存款调整后的 maxDD、日胜率和类夏普比率也会在同一轮计算中得出。

用检测器，而不是仪表盘。资金费率极值、价格未变时的 OI 激增、权益跳变，以及清算级联特征（|Δprice|↑ + OI↓）。实时捕获结果位于 reports/。

其余都是分析工具：已实现资金费率历史、根据成交记录计算的 CVD、带 beta 的跨市场相关性、供执行审查的原始成交、MACD/VWAP/已实现波动率增强指标，以及类 Sortino 下行风险。

还会记录那些容易踩的坑。五个会悄悄破坏简单分析的索引器问题已记录在 .agents/skills/dydx-gateway/references/data-gotchas.md；CI 会在 3.11 和 3.13 上运行 129 项测试（现为 133 项）。

为什么选择网关，而不是直接使用原始索引器 API？

直接让 Agent 连接 indexer.dydx.trade，看看在麻烦开始之前能走多远：

已记录的五个索引器问题：.agents/skills/dydx-gateway/references/data-gotchas.md。

数据说明

指标根据当前 K 线窗口计算，并随每根新 K 线变化。nextFundingRate 是交易所提供的实时预览值，会持续重新计算；volume24H 是滚动值。间隔一分钟的两次调用结果确实可能不同，这不是错误。

安全模型

所有工具均为只读，且无需密钥。网关不会签名，也不持有任何凭据。经过离线测试的 EIP-712 签名器保留在 dydx_mcp/signer.py 中，作为供构建自定义执行层者使用的库；它未连接到任何 MCP 工具。

常见问题

• 它会交易吗？ 不会，只做分析。这就是最初的设计目标。
• 需要 API 密钥吗？ 不需要。使用公开的索引器端点。
• 有速率限制吗？ 无需认证；60 秒的市场数据缓存可避免请求过于频繁。
• 复制交易前如何评估交易者？ 依次使用 trader_profile、trader_pnl_stats，再使用 fills_review。首先检查恒等式残差和 maker/taker 比例。

系列项目

四个同系列的只读 MCP 网关，风格一致：无需密钥、带缓存、故障时如实降级。

这四个项目都可在 glama.ai 和 PyPI 上获取；使用 uvx <name> 即可安装任意一个。

许可证

MIT。与 dYdX Trading Inc. 无关联。