SwapHunt crypto market context
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| X402_PAY | No | Set to 1 to enable actual payments. By default the server runs in dry-run mode and does not pay. | |
| PRIVATE_KEY | No | Your wallet private key (with USDC on Base mainnet) used to pay for API calls. Use a dedicated wallet with a few dollars of USDC; never your main wallet. | |
| MAX_SPEND_USD | No | Maximum amount in USD the MCP server will spend per run. Default is $0.10. | 0.10 |
| PAYTO_ALLOWLIST | No | Comma-separated list of allowed payTo addresses. When set, the MCP server pays only these addresses and refuses any other payTo before signing. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Crypto market context: the Fear & Greed Index (current, compared and history), the halving countdown, trading session and weekend liquidity, and tools computed from Hyperliquid perpetuals (USDC-margined): prices in USDC, BTC market regime, chop detection, volatility, expected move, hourly funding rates, the Alt Season Index, coin strength, momentum and correlation vs BTC, and sanity checks (is this a dip, breakout, support, oversold; how late am I, pump age, extension, green-candle streak). The coin-level analysis tools cover the top 50 Hyperliquid perpetuals by 30-day volume; other coins are rejected with not_covered and not charged. Every tool except get_spending costs real USDC per call (price in each description), with a per-session spending cap. Prefer one well-chosen call over many. When showing Fear & Greed values, include the attribution text from the result. Nothing returned is investment advice.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_spendingA | Free, runs locally (no API call, no payment). Use when the user asks how much this session has spent or what budget is left. Returns whether payments are enabled, USDC spent, paid calls, the MAX_SPEND_USD cap and the remaining budget. Ex: no parameters |
| pm_feesA | Free, runs locally (no API call, no payment). Use when the user asks the fee for an order on Kalshi, Polymarket US or polymarket.com. Returns fee_usd, fee %, break-even exit, rates as_of. contracts = USD / price; polymarket needs category; at = fill time (default now). Ex: platform=polymarket, price=0.4, contracts=250, category=Politics |
| get_fear_greedA | Use when the user asks how fearful or greedy the crypto market is today. Returns the Crypto Fear & Greed Index (0-100), its label (Extreme Fear to Extreme Greed) and the attribution to show with it; daily. For trend use get_fear_greed_compare. Show |
| get_fear_greed_compareA | Use when the user asks whether crypto sentiment is improving or worsening. Returns Fear & Greed now with its label, the values yesterday, 7 and 30 days ago, the changes (change_1d, change_7d, change_30d) and the attribution. Show |
| get_fear_greed_historyA | Use when the user wants the Fear & Greed time series to chart, backtest or compare with price. Returns daily value and classification for the last |
| get_halvingA | Use when the user asks when the next Bitcoin or Litecoin halving is. Returns current and halving block, blocks and days remaining, estimated date, progress % and block reward before and after. Estimated from block time, not an exact timestamp. Ex: symbol=LTC Costs $0.001 USDC per call. |
| get_priceA | Use when the user asks the current price of one coin. Returns the mark price (or order-book mid with price_type=mid) on Hyperliquid perpetuals in USDC, 24h change % and 24h notional volume; high/low are null. For several coins use get_prices. Ex: symbol=ETH Costs $0.005 USDC per call. |
| get_pricesA | Use when the user asks the prices of several coins or a portfolio. Returns, keyed by symbol (max 20), the mark or mid price on Hyperliquid perpetuals in USDC, 24h change % and 24h notional volume; unknown symbols are skipped. Works with one symbol too. Ex: symbols=BTC,ETH,SOL Costs $0.003 USDC per call. |
| get_supported_assetsA | Use when the user asks which coins are supported, or a symbol is uncertain (Hyperliquid names, e.g. kPEPE = 1,000 PEPE). Returns every active Hyperliquid perpetuals market, the count and |
| get_market_regimeA | Use when the user asks whether the crypto market (BTC) is bullish, bearish or neutral. Returns the regime from the BTC price on Hyperliquid perpetuals vs its 20-period EMA on 12h candles, with EMA, distance and slope; updates 00:00 and 12:00 UTC. BTC only. Ex: no parameters Costs $0.010 USDC per call. |
| get_chop_detectionA | Use when the user asks whether a coin is trending or stuck in a range. Returns is_chop, chop level, ADX, +DI/-DI, trend direction and a verdict on 1h, 4h or 1d candles of Hyperliquid perpetuals. Any active market. Ex: symbol=SOL, timeframe=4h Costs $0.003 USDC per call. |
| get_volatilityA | Use when the user asks how volatile a coin has been. Returns daily and annualized realized volatility % over 7d, 14d or 30d of daily candles on Hyperliquid perpetuals, a low/normal/high/extreme level and today's UTC range vs open. Not implied vol. Ex: symbol=BTC, period=30d Costs $0.010 USDC per call. |
| get_market_silenceA | Use when the user asks whether a coin is unusually quiet. Returns a 0-1 silence score, level and advice from today's volume vs the period average, volatility and 24h change on Hyperliquid perpetuals (7d, 14d, 30d). For a squeeze use get_compression_alert. Ex: symbol=ETH, period=14d Costs $0.002 USDC per call. |
| get_compression_alertA | Use when the user asks whether a coin is in a volatility squeeze before a breakout. Returns is_squeeze, level (extreme, strong, moderate, none), Bollinger width and its percentile on 1h, 4h or 1d candles of Hyperliquid perpetuals. Setup, not direction. Ex: symbol=BTC, timeframe=1d Costs $0.003 USDC per call. |
| get_expected_moveA | Use when the user asks how far a coin may move, or where to put targets and stops. Returns ATR(14)-based 68% and 95% price ranges in USDC around the current price on Hyperliquid perpetuals for the next 4h, 1d or 1w. A statistical range, not a forecast. Ex: symbol=BTC, period=1w Costs $0.003 USDC per call. |
| get_funding_ratesA | Use when the user asks the funding rate of specific coins or whether longs or shorts are crowded. Returns per coin (max 20) hourly funding % on Hyperliquid perpetuals, annualized (x 8760), 7d/30d averages, mark price and a crowding signal; positive = longs pay. Ex: symbols=BTC,ETH,SOL Costs $0.015 USDC per call. |
| get_top_funding_ratesA | Use when the user asks which coins have the most extreme funding right now. Returns the top |
| get_funding_historyA | Use when the user asks whether a coin's funding is unusual for it. Returns settled hourly funding on Hyperliquid perpetuals for the last |
| get_alt_seasonA | Use when the user asks if it is alt season. Returns the SwapHunt Alt Season Index (0-100, daily): share of the top 100 Hyperliquid perpetuals by 30-day volume beating BTC over 90 days; 75 or above is alt season, 25 or below is bitcoin season. Ex: no parameters Costs $0.003 USDC per call. |
| get_coin_strengthA | Use when the user asks if a coin is outperforming or lagging BTC. Returns its return minus BTC's over 24h, 7d or 30d, a rating (very_strong to very_weak) and the ratio. Top 50 Hyperliquid perpetuals by 30-day volume only (see get_supported_assets), others unpaid. Ex: symbol=SOL, period=7d Costs $0.015 USDC per call. |
| get_momentum_rankA | Use when the user asks which coins are the biggest gainers or losers. Returns coins ranked by 24h, 7d or 30d return: |
| get_correlationA | Use when the user asks if a coin just tracks BTC. Returns Pearson correlation (-1 to +1) of returns vs BTC over 7d (1h candles) or 30d (4h); no 24h. With strength label. Top 50 Hyperliquid perpetuals by 30-day volume only (see get_supported_assets), others unpaid. Ex: symbol=ETH, period=30d Costs $0.003 USDC per call. |
| is_this_a_dipA | Use when the user asks if a drop is a real dip or noise. Returns is_dip, drop % from the 14-day high, 14-day ATR %, drop/ATR and a verdict on daily candles. Top 50 Hyperliquid perpetuals by 30-day volume only (see get_supported_assets), others unpaid. Ex: symbol=SOL Costs $0.003 USDC per call. |
| is_this_a_breakoutA | Use when the user asks if a break of a price level is real or a fakeout. Returns is_confirmed, fakeout odds, verdict from volume and 1h closes past the level (USDC, required). Top 50 Hyperliquid perpetuals by 30-day volume only (see get_supported_assets), others unpaid. Ex: symbol=BTC, level=100000 Costs $0.003 USDC per call. |
| is_this_supportA | Use when the user asks if a price level is real support. Returns touches within 0.5% over 90 daily candles, recency, bounce quality, verdict. Level in USDC, required. Top 50 Hyperliquid perpetuals by 30-day volume only (see get_supported_assets), others unpaid. Ex: symbol=ETH, level=3000 Costs $0.003 USDC per call. |
| is_this_oversoldA | Use when the user asks if a coin is oversold. Returns is_oversold, RSI(14) on 1h, 4h and 1d, a weighted RSI (20/30/50%) and a verdict; not a buy signal alone. Top 50 Hyperliquid perpetuals by 30-day volume only (see get_supported_assets), others unpaid. Ex: symbol=BTC Costs $0.003 USDC per call. |
| how_late_am_iA | Use when the user asks if they are too late to buy after a run-up. Returns the move from the 4h swing low in % and ATR, its percentile vs past moves, early/middle/late verdict. Top 50 Hyperliquid perpetuals by 30-day volume only (see get_supported_assets), others unpaid. Ex: symbol=SOL Costs $0.003 USDC per call. |
| get_pump_ageA | Use when the user asks if a coin is pumping now and how old the move is. Returns is_pumping, start, duration and size vs the average pump in the last 24h of 15m candles. Top 50 Hyperliquid perpetuals by 30-day volume only (see get_supported_assets), others unpaid. Ex: symbol=SOL Costs $0.003 USDC per call. |
| is_price_extendedA | Use when the user asks if price is stretched far from its average. Returns distance from MA20 and MA50, Bollinger position, z-score on 4h candles, is_extended and a verdict. Top 50 Hyperliquid perpetuals by 30-day volume only (see get_supported_assets), others unpaid. Ex: symbol=ETH Costs $0.003 USDC per call. |
| get_green_candle_streakA | Use when the user asks how many green candles in a row a coin has. Returns the streak on 1h, 4h or 1d and how often the next candle was green after such streaks. Top 50 Hyperliquid perpetuals by 30-day volume only (see get_supported_assets), others unpaid. Ex: symbol=BTC, interval=1d Costs $0.003 USDC per call. |
| get_trading_sessionA | Use when the user asks which trading session is active or how volatile this time of day usually is. Returns the session (Asian, London, New York, Off-hours), overlap, minutes left, the next session and its typical volatility multiplier, from the UTC clock. Ex: no parameters Costs $0.005 USDC per call. |
| get_weekend_liquidityA | Use when the user asks whether crypto liquidity is thin right now, e.g. on a weekend or in off-hours. Returns is_weekend, is_low_liquidity, the session, a 0-100 liquidity score and a verdict, from the UTC clock (no market data). Ex: no parameters Costs $0.005 USDC per call. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 32 tools
Most tools have sharply distinct purposes and the descriptions explicitly cross-reference the near-neighbors (get_price vs get_prices, get_fear_greed vs _compare vs _history, get_market_silence vs get_compression_alert). The only real soft cluster is the price-stretch family (is_this_a_dip, how_late_am_i, get_pump_age, is_price_extended, is_this_oversold), which an agent could plausibly mix up, though each description adds a concrete distinguishing signal.
Several conventions coexist: get_/noun pairs (get_price, get_funding_history, pm_fees), question-form names (is_this_a_dip, is_this_a_breakout, how_late_am_i), and a bare noun (pm_fees). The grouping is semantically intentional (question-form = verdict tools, get_ = data fetches), which keeps it readable, but it does not meet a predictable verb_noun pattern.
At 32 tools the surface is heavy for a read-only market-context server, and several are narrow single-metric lookups (get_green_candle_streak, get_halving, get_trading_session) that could be consolidated or parameterized. Each earns a place, but an agent must triage 32 paid endpoints, which raises both cost and selection risk.
Coverage of Hyperliquid perp analytics is unusually thorough: spot prices, funding, volatility/squeeze, sentiment, regime, relative strength, correlation, level validation, session/liquidity, plus account-adjacent tools (get_spending, pm_fees). The main gap is no raw OHLCV/price-history series endpoint for charting or backtesting (only Fear & Greed history), and no open-interest or liquidation data, which agents will hit when asked to 'show the chart' or 'is leverage building'.