SwapHunt crypto market context

SwapHunt MCP サーバー

Claude やその他の AI エージェントに、30 種類の有料 SwapHunt ツールを提供する MCP サーバーです。価格、BTC の市場レジーム、レンジ相場の検出、ボラティリティ、予想変動幅、資金調達率、アルトシーズン指数、コインの強さ、BTC に対するモメンタムと相関、FOMO を抑えるための健全性チェック（これは押し目か、ブレイクアウトか、サポートか、売られすぎか、乗り遅れているか、ポンプが始まってからどれくらい経つか、価格の伸び、陽線の連続回数）を利用できます。これらはすべて Hyperliquid の無期限先物（USDC 建て）から算出されます。また、Crypto Fear & Greed Index（現在値、過去の日との比較、日次履歴）、半減期までのカウントダウン、現在の取引セッションと週末の流動性も利用できます。エージェントは、ユーザーが管理するウォレットから、セッションごとの上限額の範囲内で、x402 を介して Base 上の USDC でツールの呼び出しごとに支払います。

各ツールの説明には価格が記載されているため、エージェントは呼び出しを実行する前に費用を確認できます。

uvx swaphunt-mcp            # needs uv: https://docs.astral.sh/uv/

ツール

ツール	価格	返される情報
get_spending	無料	セッションでの支出額と残りの予算
get_fear_greed	$0.001	Crypto Fear & Greed Index（0～100）とそのラベル
get_fear_greed_compare	$0.002	現在の指数と、昨日、7 日前、30 日前の指数、およびその変化
get_fear_greed_history	$0.005	最大 365 日分の日次指数値
get_halving	$0.001	BTC または LTC の半減期までのカウントダウン
get_trading_session	$0.001	現在の取引セッションと、そのセッションにおける通常のボラティリティ
get_weekend_liquidity	$0.001	週末または流動性の低い時間帯と、0～100 の流動性スコア

Hyperliquid の無期限先物（USDC 建て）から算出

これらのツールは Hyperliquid の無期限先物から算出され、すべての結果に "source": "Hyperliquid perpetuals" が含まれます。価格の単位は USDC です（USD と USDT も別名として利用できます）。資金調達は 1 時間ごとに決済され、年率は 1 時間あたりのレート x 8760 です。

ツール	価格	返される情報
get_price	$0.001	1 つの資産の USDC 建て価格（price_type は mark または mid）、24 時間の変化率と取引量
get_prices	$0.003	1 回の呼び出しで最大 20 資産の価格
get_supported_assets	$0.001	価格ツールで価格を取得できるすべての資産（稼働中の Hyperliquid 無期限先物すべて）
get_market_regime	$0.002	12 時間 EMA20 に対する価格から判定した BTC のレジーム（BULLISH/BEARISH/NEUTRAL）
get_chop_detection	$0.003	1 時間、4 時間、または 1 日足のトレンド相場かレンジ相場か（ADX、+DI/-DI）
get_volatility	$0.002	過去 7 日、14 日、または 30 日の実現ボラティリティと、低／通常／高／極端のレベル
get_market_silence	$0.002	市場の静寂度スコア 0～1（低い取引量、低いボラティリティ、小さな値動き）
get_compression_alert	$0.003	1 時間、4 時間、または 1 日足のボラティリティ収縮（ボリンジャーバンド幅のパーセンタイル）
get_expected_move	$0.003	4 時間、1 日、または 1 週間の ATR ベースの価格範囲（68％、95％）
get_funding_rates	$0.003	最大 20 コインの現在の 1 時間あたりの資金調達率、年率、および過去 7 日／30 日の平均
get_top_funding_rates	$0.003	すべての無期限先物の中で、最も高いまたは最も低い資金調達率
get_funding_history	$0.004	1 コインの最大 365 日分の 1 時間ごとの資金調達履歴と、最新レートのパーセンタイル
get_alt_season	$0.003	SwapHunt アルトシーズン指数（0～100）：90 日間で BTC を上回った主要な無期限先物の割合

コイン分析と健全性チェック（Hyperliquid 無期限先物、上位 50 コイン）

これらのツールも Hyperliquid の無期限先物（USDC 建て）を対象として計算され、価格と水準は USDC で表示されます。対象は、30 日間の出来高に基づく Hyperliquid 無期限先物の上位 50 銘柄です（get_supported_assets の covered リスト）。対象外のコインの場合、API は支払いを求める前に 422 not_covered を返します。料金は請求されず、セッション上限にもカウントされません。また、ツールは対象コインのリストを返すため、エージェントは別のコインを選べます。

ツール	価格	返される内容
get_coin_strength	$0.003	24 時間、7 日間、または 30 日間の、BTC に対するコインのリターンを very_strong から very_weak で評価
get_momentum_rank	$0.003	24 時間、7 日間、または 30 日間のリターンで対象コインを順位付け：上昇率と下落率の上位
get_correlation	$0.003	7 日間または 30 日間における、コインのリターンと BTC のリターンのピアソン相関係数
is_this_a_dip	$0.003	14 日間の高値からの下落幅と 14 日間の ATR を比較：本格的な押し目か、単なるノイズか
is_this_a_breakout	$0.003	価格水準を上または下にブレイクした場合、ブレイクが確認されたか、だましの可能性が高いか
is_this_support	$0.003	価格水準が本当のサポートかどうか：過去 90 日間のタッチ回数、直近性、反発の質
is_this_oversold	$0.003	1 時間足、4 時間足、1 日足の RSI(14) を加重 RSI に統合し、判定を返す
how_late_am_i	$0.003	4 時間足のスイング安値から値動きがどれだけ進んだかを、％と ATR 倍率で表示
get_pump_age	$0.003	15 分足のローソク足でアクティブな急騰を検出：開始時刻、継続時間、平均的な急騰に対する規模
is_price_extended	$0.003	4 時間足における 20 MA と 50 MA からの距離、ボリンジャーバンド上の位置、z スコア
get_green_candle_streak	$0.003	1 時間足、4 時間足、または 1 日足で現在続いている陽線の連続数と、次のローソク足も陽線だった頻度

対象外のコインの場合、たとえば次のような応答が返ります。

{"error": "not_covered", "charged": false,
 "message": "SEI is not covered yet. Covered: top 50 Hyperliquid perpetuals by 30-day volume. Nothing was paid. Retry with one of the covered coins.",
 "symbol": "SEI", "covered": ["AAVE", "ADA", "AERO", "...", "kPEPE"],
 "coverage_rule": "Top 50 Hyperliquid perpetuals by 30-day notional volume (stablecoins excluded), recomputed daily. ..."}

Fear & Greed の結果には attribution フィールドが含まれます。指数の提供元である Alternative.me は、データの横にこのテキストを表示するよう求めており、ツールの説明でもエージェントに含めるよう指示しています。

セットアップ

Base メインネットに数ドル分の USDC を入れた専用ウォレットを使用してください。メインウォレットは絶対に使用しないでください。

ウォレットキーを自分だけが読み取れるファイルに保存すれば、設定ファイルに置かれることはありません。

install -m 600 /dev/null ~/.swaphunt-wallet.key
nano ~/.swaphunt-wallet.key        # paste the private key, save

サーバーは uv の uvx で実行され、PyPI から専用の環境にダウンロードされます。自分でクローンしたり、手動でインストールしたりする必要はありません。まずはウォレットなしで試してください。設定がなければ、すべてのツールはドライランになります。

設定

変数	デフォルト	効果
X402_PAY	off	X402_PAY=1 を設定しない場合、すべてのツールはドライランとして実行され、価格を報告してデータは返しません。
PRIVATE_KEY_FILE		ウォレットの秘密鍵を含むファイルへのパス（推奨）。
PRIVATE_KEY		環境変数を使う場合に設定する秘密鍵そのもの。
MAX_SPEND_USD	0.10	セッション（サーバープロセス 1 つ）の支出上限。上限を超える呼び出しは拒否され、支払いは行われません。

各支払いは、その呼び出しについて API が提示した価格、資産（USDC）、ネットワーク（Base）、payTo アドレスにも固定されます。また、ツールは説明に記載された価格を超える支払いを拒否します。支払いの送信後に呼び出しが失敗した場合でも、上限にカウントされ、「支払い済みの可能性あり」と報告されます。

Claude Code

claude mcp add swaphunt \
  --env X402_PAY=1 \
  --env PRIVATE_KEY_FILE=$HOME/.swaphunt-wallet.key \
  --env MAX_SPEND_USD=0.25 \
  -- uvx swaphunt-mcp

次のように質問してみてください。

• 「今日の暗号資産市場のムードはどうですか。過去 1 か月でどのように変化しましたか。また、次の Bitcoin 半減期までどれくらいありますか？」
• 「BTC、ETH、SOL の現在の取引価格はいくらですか。また、今の BTC は強気相場ですか、それとも弱気相場ですか？」
• 「4 時間足チャートで ETH はレンジ相場ですか、それともトレンド相場ですか。また、ボラティリティは収縮していますか？」
• 「ファンディングレートでロングが最も混み合っているコインはどれですか。また、現在の BTC のファンディングレートは過去 90 日間と比べて異常ですか？」
• 「SOL は今日どれくらい動く可能性がありますか。また、今はアルトシーズンですか？」
• 「ETH が今日下落しました。本当の押し目ですか、それとも単なるノイズですか。売られ過ぎですか。また、反発を買うにはもう遅いですか？」
• 「SOL が急騰しています。この急騰はどれくらい続いていますか。すでに行き過ぎていますか。また、今週の SOL は BTC より強いですか？」

Claude Desktop

claude_desktop_config.json にこれを追加し（Settings → Developer → Edit Config）、Claude Desktop を再起動してください。

{
  "mcpServers": {
    "swaphunt": {
      "command": "uvx",
      "args": ["swaphunt-mcp"],
      "env": {
        "X402_PAY": "1",
        "PRIVATE_KEY_FILE": "/home/you/.swaphunt-wallet.key",
        "MAX_SPEND_USD": "0.25"
      }
    }
  }
}

Claude Desktop が uvx を見つけられない場合は、フルパスを使用してください（macOS/Linux では which uvx、Windows では where uvx）。

ツール呼び出しの戻り値

有料の場合：

{
  "data": {"value": 30, "label": "Fear", "timestamp": "2026-10-31T00:00:00", "source": "alternative.me", "...": "..."},
  "cost_usd": 0.001,
  "session_spent_usd": 0.001,
  "session_remaining_usd": 0.099,
  "tx": "https://basescan.org/tx/0x<transaction-hash>"
}

ドライラン（X402_PAY=1 を指定しない場合）：

{"dry_run": true, "would_cost_usd": 0.001, "network": "eip155:8453",
 "note": "Dry run, nothing paid and no data. The user can set X402_PAY=1 to enable payments."}

上限に達した場合：

{"error": "Session spending cap reached: $0.002 spent of MAX_SPEND_USD=$0.0025; this call costs $0.001. Restart the server or raise MAX_SPEND_USD."}

ソースから実行

git clone https://github.com/swaphunt/x402-examples.git
cd x402-examples/mcp-server
uv run swaphunt-mcp            # or: uv run swaphunt-mcp --check

メンテナー向け

uvx swaphunt-mcp --check は、すべてのツールで提示されている価格をライブ API と照合します。支払いは発生しません。

ソース、イシュー、その他の x402 のサンプル（クイックスタート、デイリーブリーフ、アラートボット）：github.com/swaphunt/x402-examples。

ここに記載されている内容は、投資助言ではありません。