SwapHunt crypto market context

SwapHunt MCP 服务

一个 MCP 服务，为 Claude 和其他 AI Agent 提供 30 种付费 SwapHunt 工具：价格、BTC 市场状态、震荡检测、波动率、预期走势、资金费率、Alt Season 指数、币种强度、动量以及与 BTC 的相关性，还有防 FOMO 检查（当前是回调、突破、支撑位还是超卖；入场是否太晚、拉升持续时间、涨幅偏离程度、连续收阳线数）。所有数据均根据 Hyperliquid 永续合约（USDC 保证金）计算；此外还提供加密货币恐惧与贪婪指数（当前值、与此前日期的对比以及每日历史数据）、减半倒计时、当前交易时段和周末流动性。Agent 通过 x402 使用你控制的钱包，以 USDC 在 Base 上按次付费，并可为每个会话设置支出上限。

每个工具的说明都标明了价格，因此 Agent 可以在调用前了解费用。

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

工具

工具	价格	返回内容
get_spending	免费	本次会话已支出的金额和剩余预算
get_fear_greed	$0.001	加密货币恐惧与贪婪指数（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 作为别名）。资金费率按小时结算；年化费率为小时费率 x 8760。

工具	价格	返回内容
get_price	$0.001	单个资产以 USDC 计价的价格（price_type 为 mark 或 mid）、24 小时涨跌幅和成交量
get_prices	$0.003	单次调用获取最多 20 种资产的价格
get_supported_assets	$0.001	价格工具可报价的所有资产（所有活跃的 Hyperliquid 永续合约）
get_market_regime	$0.002	根据价格与 12h EMA20 的对比判断 BTC 市场状态（BULLISH/BEARISH/NEUTRAL）
get_chop_detection	$0.003	在 1h、4h 或 1d 周期上判断趋势或震荡（ADX、+DI/-DI）
get_volatility	$0.002	计算 7d、14d 或 30d 的已实现波动率，并标记为低/正常/高/极高
get_market_silence	$0.002	市场静默评分 0-1（低成交量、低波动率、小幅波动）
get_compression_alert	$0.003	在 1h、4h 或 1d 周期上检测波动率收缩（布林带宽度百分位）
get_expected_move	$0.003	基于 ATR 计算 4h、1d 或 1w 的 68% 和 95% 价格区间
get_funding_rates	$0.003	最多 20 种币的当前小时资金费率、年化费率及 7d/30d 平均值
get_top_funding_rates	$0.003	所有永续合约中最高或最低的资金费率
get_funding_history	$0.004	单种币最长 365 天的小时资金费率历史，以及最新费率的百分位
get_alt_season	$0.003	SwapHunt Alt Season 指数（0-100）：过去 90 天表现优于 BTC 的头部永续合约占比

币种分析与合理性检查（Hyperliquid 永续合约，前 50 个币种）

这些工具也基于 Hyperliquid 永续合约（USDC 保证金）计算，价格和价位均以 USDC 计。它们涵盖按 30 天成交量排名的 Hyperliquid 永续合约前 50 个币种（即 get_supported_assets 返回的 covered 列表）。对于其他币种，API 会在请求付款前返回 422 not_covered：不会扣款，不会计入会话上限，工具还会返回覆盖列表，供 Agent 选择其他币种。

工具	价格	返回内容
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	某个币种与 BTC 在 7 天或 30 天内回报率的 Pearson 相关系数
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 分钟 K 线检测当前是否处于拉升行情：开始时间、持续时间和涨幅（与平均拉升幅度对比）
is_price_extended	$0.003	4 小时周期下价格与 20 和 50 MA 的距离、布林带位置及 z-score
get_green_candle_streak	$0.003	当前 1 小时、4 小时或 1 天周期的连续绿 K 线数，以及下一根 K 线收绿的频率

未覆盖的币种会返回如下结果：

{"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 要求在其数据旁显示这段文字，工具说明也会指示 Agent 将其包含在结果中。

设置

在 Base 主网上使用一个专用钱包，并存入少量 USDC。切勿使用主钱包。

将钱包密钥保存在只有你能读取的文件中，这样它就不会出现在配置文件里：

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

服务通过 uv 的 uvx 运行，它会从 PyPI 下载服务并安装到自己的环境中。无需克隆或手动安装。先在不配置钱包的情况下试用：没有任何设置时，所有工具都会进行模拟运行。

设置项

变量	默认值	作用
X402_PAY	关闭	未设置 X402_PAY=1 时，所有工具都会进行模拟运行：报告价格但不返回数据。
PRIVATE_KEY_FILE		存有钱包私钥的文件路径（推荐）。
PRIVATE_KEY		如果你更愿意使用环境变量，也可以直接填写密钥。
MAX_SPEND_USD	0.10	会话（单个服务进程）的支出上限。超出上限的调用会被拒绝，不会扣款。

每笔付款也会锁定为 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

然后可以这样提问：

• “今天的加密货币市场情绪如何？过去一个月有什么变化？距离下一次 Bitcoin 减半还有多久？”
• “BTC、ETH 和 SOL 的交易价格是多少？BTC 当前处于看涨还是看跌状态？”
• “ETH 在 4 小时图上是横盘震荡还是趋势行情？波动率是否正在收缩？”
• “哪些币种的资金费率显示多头最拥挤？与过去 90 天相比，BTC 当前的资金费率是否异常？”
• “SOL 今天可能会波动多大？我们现在处于山寨币季吗？”
• “ETH 今天下跌了。这是真正的回调还是只是噪声？它是否超卖？如果现在买入反弹，我会不会进场太晚？”
• “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。

此处内容不构成投资建议。