Aster Agent Gateway

aster-agent-gateway

Aster 列出了约 580 种期货，其中约 32 种是你不会想到能在加密货币 DEX 上交易的资产：黄金、石油、国债、个股和指数永续合约，它们全天候交易，而标的市场却处于休市状态。这个 MCP 服务将整个市场列表以及约 68 个现货交易对、资金费率、订单簿、K 线和金库存款流，呈现在 AI Agent 面前。只读且无需密钥；仅使用公共端点（fapi.asterdex.com/fapi/v3、sapi.asterdex.com/api/v3、tapi.asterdex.com/info、Solana RPC、可选的 EVM RPC），并进行缓存和速率限制。

使用场景

先看资金费率，因为这正是 Aster 与众不同之处。各市场的间隔从 1 小时到 8 小时不等；如果直接年化，8 小时结算的市场读数会低估 8 倍。筛选器会根据每一行对应的间隔计算数据，并同时显示上限和下限，因此显示 4,148%/年的读数时，也会附上解释这一数据的背景。

接着看看凌晨 3 点的 TradFi 市场列表：黄金报 $4,365，成交量实时更新；石油的负资金费率让多头持仓获利（我们查看时为 -0.0001%/1 小时）；Micron 隔夜上涨 4.8%。只需一个 API，且采用与加密货币市场行相同的惯例。

mark_index_divergence 会按标记价格与指数价格的价差为全部约 756 个市场排序。我们记录数据的那天早上，RTXUSDT 同时位居该榜单（溢价 505 个基点）和资金费率榜首，这是典型的挤空前兆。金库存款流显示资金被存放在何处；未平仓合约量快照按交易对展示，并如实说明 Aster 无法提供无需密钥的未平仓合约量历史数据。

完整演练：examples/use-cases.md。

快速入门

Claude Code：

claude mcp add aster -- uvx aster-agent-gateway

stdio（默认，用于本地 Agent）：

uvx aster-agent-gateway

或从检出目录运行：

git clone https://github.com/alekskram/aster-agent-gateway
cd aster-agent-gateway
uv sync
uv run aster-agent-gateway

Claude Desktop / Cursor 配置：

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

托管形式，通过 8904 端口提供可流式传输的 HTTP 服务：

uvx aster-agent-gateway --http             # 127.0.0.1:8904
curl http://127.0.0.1:8904/health   # -> {"ok": true, "service": "aster-agent-gateway", ...}

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

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

# 2) register it (merges into ~/.zcode/cli/config.json)
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", {})["aster"] = {
    "type": "http", "url": "http://127.0.0.1:8904/mcp"}
json.dump(cfg, open(p, "w"), indent=2)
print("aster-agent-gateway registered:", p)
PY

所有 13 个工具均为只读（标注为 readOnlyHint: true, destructiveHint: false）。

为什么使用网关，而不是原始 API？

Aster 的 fapi/sapi/tapi 端点都是普通 REST 接口。难点在于语义：

速率限制

本地执行的两个 REST 限流桶，会根据权重进行控制：

• fapi 每分钟 2400 权重，sapi 每分钟 6000 权重（每次调用后读取响应头 X-MBX-USED-WEIGHT-1M）。超过限流桶容量的 80% 后，客户端会自动限速；遇到 429 时会遵照 Retry-After 退避；遇到 418（重复出现 429 导致 IP 封禁）时，会触发 60 秒拒绝冷却期。深度和 K 线请求的 limit 会调整至有定价的档位，避免调用方意外耗尽权重。
• Solana 每分钟 10 个请求、tapi 每分钟 30 个请求、EVM 每分钟 20 个请求的本地限额 （各自独立计数，超限时会快速返回如实说明的错误）。

TTL 缓存：exchangeInfo 为 3600 秒，fundingInfo 为 600 秒，premiumIndex 和 tickers 为 15 秒，深度为 5 秒，K 线为 60 秒，交易为 10 秒，openInterest 为 30 秒。

数据说明

• API 返回的所有数值在上游均为 STRING；使用不会抛出异常的辅助函数解析，null 始终表示“不可用”，绝不表示零。
• 所有上游故障均返回错误字典 {"error", "source", "reason"}，绝不返回回溯。
• 无密钥时不存在 OI 历史数据（/futures/data/openInterestHist 返回 404）——网关会如实说明，而不会捏造数据。
• EVM 金库日志需要 ASTER_EVM_RPC_URL（或按链设置 ASTER_EVM_RPC_URL_{BSC,ETH,ARB}）；免费的公共 RPC 会以 -32005 拒绝金库查询。未设置时 -> 如实提示“未配置 RPC”。
• tapi 账户隐私：大多数账户是私有的；空结果会报告为隐私限制，而不是数据。
• 缓存响应会包含 age_seconds / fetched_at 新鲜度字段。

套件组成

四个同类只读 MCP 网关，风格一致：无需密钥、带缓存、如实降级。

这四个项目都可在 glama.ai 和 PyPI 上找到；任何一个都可以通过 uvx <name> 安装。

许可证

MIT。