Aster Agent Gateway

aster-agent-gateway

Asterにはおよそ580銘柄の先物があり、そのうち約32銘柄は、暗号資産DEXでは想定しにくい商品です。金、原油、米国債、個別株、そして原資産の市場が閉まっている間も24時間365日取引されるインデックスの無期限先物が含まれています。このMCP サーバーは、市場全体に加え、約68の現物ペア、資金調達率、オーダーブック、Kライン、ボールトへの入金フローをAI エージェントに提供します。読み取り専用で、キーは不要です。公開エンドポイントのみを使用し（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％上昇していました。暗号資産の銘柄と同じ基準で、1つのAPIから取得できます。

mark_index_divergenceは、マーク価格とインデックス価格の乖離幅で約756の全市場をランキングします。データを取得した朝、RTXUSDTはこのランキング（505 bpsの割高）と資金調達率ランキングの両方で首位でした。これは典型的なスクイーズ前の状況です。ボールトへの入金フローからは資金がどこに置かれているかがわかります。OIスナップショットは銘柄ごとに提供され、Asterにはキー不要のOI履歴がないことも明示します。

詳しい手順：examples/use-cases.md。

クイックスタート

Claude Code：

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

stdio（デフォルト。ローカルエージェント向け）：

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 の2つのバケットをローカルで適用し、ウェイトを考慮します。

• fapi 2400 weight/min、sapi 6000/min（各呼び出し後にヘッダー X-MBX-USED-WEIGHT-1M を読み取ります）。バケットの80%を超えると クライアントが自動的にスロットリングします。429では Retry-After に従ってバックオフし、418（429の反復によるIP BAN）では 60秒間の拒否クールダウンが発生します。板情報／ローソク足のリミットは 価格帯に合わせて切り詰められるため、呼び出し側が誤ってウェイトを 消費することはありません。
• Solana 10 req/min、tapi 30/min、EVM 20/min のローカル予算 （個別の台帳を使用し、正直なエラーを即時に返します）。

TTL キャッシュ：exchangeInfo 3600秒、fundingInfo 600秒、premiumIndex と tickers 15秒、板情報 5秒、ローソク足 60秒、取引 10秒、openInterest 30秒。

データに関する注意事項

• API からの数値はすべて、上流では文字列です。例外を発生させないヘルパーで解析します。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ゲートウェイが4つあり、いずれもキー不要、キャッシュ対応、障害時も誠実に動作する同じスタイルです。

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

ライセンス

MIT。