Agent-payable crypto data API (x402)

AI agents and developers can call SwapHunt directly: 30 endpoints for prices, hourly funding rates, volatility, market regime, sanity and anti-FOMO checks, coin strength and momentum, the SwapHunt Alt Season Index, the Crypto Fear & Greed Index, the next halving, and trading session context. Paid per call in USDC, with no account or API key.

Pricing per call

Each call costs $0.001 to $0.005 in USDC, depending on the endpoint, and you only pay for successful calls. Pay on Base, Polygon, Arbitrum or Solana; the price is the same on every network. No account, no API key, no subscription. The server answers an unpaid request with 402 Payment Required and the price; an x402 client pays and retries automatically.

Endpoints

Prices in USDC per successful call. Base URL https://x402.swaphunt.dev. Last updated .

Prices

EndpointWhat you getPrice
/v1/tools/price Get asset price (Hyperliquid perpetuals, USDC)asset, currency, price_type
Details and example

SwapHunt is a crypto market-context API for trading agents, with live prices, funding, volatility and market regime from Hyperliquid perpetuals, the SwapHunt Alt Season Index, Fear & Greed, the halving and session context, all pay-per-call (docs and pricing at https://swaphunt.dev/api). This route returns one asset's live price from Hyperliquid perpetuals (USDC-margined), quoted in USDC: the perp mark price (or the order-book mid with price_type=mid), 24h mark change % and 24h notional volume in USDC. high_24h/low_24h are null. Any active Hyperliquid perp such as BTC, ETH or SOL; see /v1/tools/price/supported. For many assets at once use /v1/tools/price/multi.

  • asset, default BTC
  • currency, default USDC
  • price_type, default mark
GET https://x402.swaphunt.dev/v1/tools/price

Example response (real data, 2026-11-03; long lists shortened):

{
  "asset": "BTC",
  "price": 77711.9,
  "currency": "USDC",
  "price_type": "mark",
  "change_24h": 1.06,
  "high_24h": null,
  "low_24h": null,
  "volume_24h": 2213766142.913264,
  "updated_at": "2026-11-03T20:19:21.622646",
  "source": "Hyperliquid perpetuals"
}
$0.001
/v1/tools/price/multi Get multiple asset prices (Hyperliquid perpetuals, USDC)assets, currency, price_type
Details and example

Batch prices for up to 20 assets in one call from Hyperliquid perpetuals (USDC-margined), quoted in USDC, each with the perp mark price (or order-book mid with price_type=mid), 24h mark change % and 24h notional volume, keyed by symbol. Unknown symbols are skipped. The cost-efficient way to price a basket or portfolio in a single request instead of N calls.

  • assets, default BTC,ETH
  • currency, default USDC
  • price_type, default mark
GET https://x402.swaphunt.dev/v1/tools/price/multi

Example response (real data, 2026-11-03; long lists shortened):

{
  "prices": {
    "BTC": {
      "asset": "BTC",
      "price": 77711.9,
      "currency": "USDC",
      "price_type": "mark",
      "change_24h": 1.06,
      "high_24h": null,
      "low_24h": null,
      "volume_24h": 2213766142.913264,
      "updated_at": "2026-11-03T20:19:21.622646",
      "source": "Hyperliquid perpetuals"
    },
    "ETH": {
      "asset": "ETH",
      "price": 2284.4,
      "currency": "USDC",
      "price_type": "mark",
      "change_24h": 1.53,
      "high_24h": null,
      "low_24h": null,
      "volume_24h": 614747645.623131,
      "updated_at": "2026-11-03T20:19:21.622646",
      "source": "Hyperliquid perpetuals"
    }
  },
  "currency": "USDC",
  "price_type": "mark",
  "updated_at": "2026-11-03T20:19:21.687895",
  "source": "Hyperliquid perpetuals"
}
$0.003
/v1/tools/price/supported Get supported assets (active Hyperliquid perpetuals)
Details and example

Every asset /v1/tools/price and /v1/tools/price/multi can quote: all active Hyperliquid perpetuals (USDC-margined), by Hyperliquid name (e.g. kPEPE = 1,000 PEPE). Call this once to discover valid `asset` symbols before pricing. Returns an object with the asset list, count, quote currency (USDC) and source, plus `covered`: the coins the analysis endpoints accept (top 50 Hyperliquid perpetuals by 30-day volume, recomputed daily) and the `coverage_rule`.

GET https://x402.swaphunt.dev/v1/tools/price/supported

Example response (real data, 2026-11-03; long lists shortened):

{
  "assets": [
    "0G",
    "2Z"
  ],
  "count": 179,
  "currency": "USDC",
  "source": "Hyperliquid perpetuals",
  "covered": [
    "AAVE",
    "ADA"
  ],
  "coverage_rule": "Top 50 Hyperliquid perpetuals by 30-day notional volume (stablecoins excluded), recomputed daily. A …"
}
$0.001

Market

EndpointWhat you getPrice
/v1/market/alt-season SwapHunt Alt Season Index (Hyperliquid perpetuals)
Details and example

SwapHunt Alt Season Index (0-100), computed daily from Hyperliquid perpetuals (USDC-margined): share of the top 100 Hyperliquid perpetuals by 30-day volume (excl. BTC and stablecoins, delisted perps included while traded) outperforming BTC over 90 days. 75 or above is alt season, 25 or below is bitcoin season, otherwise neutral. Returns the index, label, is_alt_season, universe size, number outperforming and BTC's 90-day return. Use to time rotation between BTC and alts.

GET https://x402.swaphunt.dev/v1/market/alt-season

Example response (real data, 2026-11-03; long lists shortened):

{
  "alt_season_index": 51.0,
  "label": "Neutral",
  "is_alt_season": false,
  "date": "2026-11-02",
  "universe": 100,
  "outperforming": 51,
  "btc_return_90d_pct": 19.88,
  "method": "SwapHunt Alt Season Index: share of the top 100 Hyperliquid perpetuals by 30-day volume (excl. BTC a…",
  "source": "Hyperliquid perpetuals",
  "updated_at": "2026-11-03T20:15:29.706930+00:00"
}
$0.003
/v1/market/coin-strength Coin strength vs BTC (Hyperliquid perpetuals)coin, period, quote
Details and example

Relative strength of a coin vs BTC on Hyperliquid perpetuals (USDC-margined): the coin's return minus BTC's over 24h, 7d or 30d, as a category (very_strong to very_weak) plus the strength ratio. Use to see whether an alt is leading or lagging BTC before entering. A strength read, not a price target. Coverage: top 50 Hyperliquid perpetuals by 30-day volume; see /v1/tools/price/supported (other coins get 422 not_covered, no charge).

  • coin, default ETH
  • period, default 24h
  • quote, default USDC
GET https://x402.swaphunt.dev/v1/market/coin-strength

Example response (real data, 2026-11-03; long lists shortened):

{
  "coin": "ETH",
  "quote": "USDC",
  "pair": "ETH-USDC",
  "period": "24h",
  "coin_return_pct": 1.61,
  "btc_return_pct": 0.82,
  "vs_btc_pct": 0.79,
  "strength_ratio": 1.008,
  "strength": "neutral",
  "is_outperforming": true,
  "verdict": "ETH tracking BTC (within 3%)",
  "source": "Hyperliquid perpetuals",
  "updated_at": "2026-11-03T20:19:22.687894+00:00"
}
$0.003
/v1/market/correlation Coin correlation with BTC (Hyperliquid perpetuals)coin, period, quote
Details and example

Pearson correlation (-1 to +1) of a coin's returns vs BTC on Hyperliquid perpetuals (USDC-margined): 7d on 1h candles or 30d on 4h candles, with a strength label and data point count. Use to judge diversification and whether an alt moves on its own or just tracks BTC. A correlation coefficient, not a beta. Coverage: top 50 Hyperliquid perpetuals by 30-day volume; see /v1/tools/price/supported (other coins get 422 not_covered, no charge).

  • coin, default ETH
  • period, default 7d
  • quote, default USDC
GET https://x402.swaphunt.dev/v1/market/correlation

Example response (real data, 2026-11-03; long lists shortened):

{
  "coin": "ETH",
  "base": "BTC",
  "quote": "USDC",
  "period": "7d",
  "correlation": 0.881,
  "correlation_strength": "very_high",
  "interpretation": "ETH moves almost identically with BTC",
  "data_points": 167,
  "source": "Hyperliquid perpetuals",
  "updated_at": "2026-11-03T20:19:22.884822+00:00"
}
$0.003
/v1/market/fear-greed Get Fear & Greed Index
Details and example

Current Crypto Fear & Greed Index (0-100) with its label (Extreme Fear to Extreme Greed), updated daily. A single market-mood gauge for risk-on/risk-off context. For trend over time use /v1/market/fear-greed/compare or /v1/market/fear-greed/history.

GET https://x402.swaphunt.dev/v1/market/fear-greed

Example response (real data, 2026-11-03; long lists shortened):

{
  "value": 26,
  "label": "Fear",
  "timestamp": "2026-11-03T00:00:00",
  "source": "alternative.me",
  "attribution": "Data provided by Alternative.me Crypto Fear & Greed Index"
}
$0.001
/v1/market/fear-greed/compare Get Fear & Greed with historical comparison
Details and example

Fear & Greed now vs yesterday, 7 days and 30 days ago, with the deltas, so an agent can see whether market sentiment is improving or deteriorating, not just today's number. Use for momentum-of-mood.

GET https://x402.swaphunt.dev/v1/market/fear-greed/compare

Example response (real data, 2026-11-03; long lists shortened):

{
  "value": 26,
  "label": "Fear",
  "timestamp": "2026-11-03T00:00:00",
  "source": "alternative.me",
  "attribution": "Data provided by Alternative.me Crypto Fear & Greed Index",
  "yesterday": 37,
  "week_ago": 48,
  "month_ago": 65,
  "change_1d": -11,
  "change_7d": -22,
  "change_30d": -39
}
$0.002
/v1/market/fear-greed/history Get Fear & Greed historydays, start_date, end_date
Details and example

Historical Fear & Greed time series (up to 365 days), each day with value + classification. Use to backtest sentiment, chart mood cycles or correlate fear/greed with price. The raw series, not a summary.

  • days, default 30
  • start_date
  • end_date
GET https://x402.swaphunt.dev/v1/market/fear-greed/history

Example response (real data, 2026-11-03; long lists shortened):

{
  "history": [
    {
      "date": "2026-11-03",
      "value": 26,
      "classification": "Fear"
    },
    {
      "date": "2026-11-02",
      "value": 37,
      "classification": "Fear"
    }
  ],
  "start_date": "2026-10-05",
  "end_date": "2026-11-03",
  "count": 30,
  "source": "alternative.me",
  "attribution": "Data provided by Alternative.me Crypto Fear & Greed Index",
  "data_available_from": "2018-02-01"
}
$0.005
/v1/market/halving Get halving countdowncoin
Details and example

BTC or LTC halving countdown: blocks remaining and the estimated date of the next halving. Use for cycle-timing narratives and supply-shock context. Estimate (block-time based), not an exact timestamp.

  • coin, default BTC
GET https://x402.swaphunt.dev/v1/market/halving

Example response (real data, 2026-11-03; long lists shortened):

{
  "coin": "BTC",
  "coin_name": "Bitcoin",
  "current_block": 974435,
  "next_halving_block": 1050000,
  "blocks_remaining": 75565,
  "estimated_date": "2028-04-11T14:29:22.567210",
  "days_remaining": 524,
  "progress_pct": 64.02,
  "current_block_reward": 3.125,
  "next_block_reward": 1.5625,
  "halving_number": 5,
  "updated_at": "2026-11-03T20:19:22.567218"
}
$0.001
/v1/market/momentum-rank Top momentum coins (Hyperliquid perpetuals)period, limit, quote
Details and example

Momentum leaderboard of the covered Hyperliquid perpetuals (USDC-margined): every covered coin ranked by return over 24h, 7d or 30d, with top and bottom performers, notional volume in USDC and the average return. Use to surface rotation candidates and what is bleeding. Ranked movers, not fundamentals. Coverage: top 50 Hyperliquid perpetuals by 30-day volume; see /v1/tools/price/supported (other coins get 422 not_covered, no charge).

  • period, default 24h
  • limit, default 10
  • quote, default USDC
GET https://x402.swaphunt.dev/v1/market/momentum-rank

Example response (real data, 2026-11-03; long lists shortened):

{
  "period": "24h",
  "quote": "USDC",
  "total_coins_analyzed": 50,
  "avg_return_pct": 1.67,
  "top_performers": [
    {
      "coin": "ZRO",
      "return_pct": 9.12,
      "volume_usd": 10904427.0,
      "current_price": 1.8644,
      "rank": 1
    },
    {
      "coin": "PUMP",
      "return_pct": 9.08,
      "volume_usd": 34108910.0,
      "current_price": 0.004278,
      "rank": 2
    }
  ],
  "bottom_performers": [
    {
      "coin": "XPL",
      "return_pct": -5.83,
      "volume_usd": 27580199.0,
      "current_price": 0.063288,
      "rank": 50
    },
    {
      "coin": "PONS",
      "return_pct": -3.5,
      "volume_usd": 8831500.0,
      "current_price": 0.20108,
      "rank": 49
    }
  ],
  "all_ranked": [
    {
      "coin": "ZRO",
      "return_pct": 9.12,
      "volume_usd": 10904427.0,
      "current_price": 1.8644,
      "rank": 1
    },
    {
      "coin": "PUMP",
      "return_pct": 9.08,
      "volume_usd": 34108910.0,
      "current_price": 0.004278,
      "rank": 2
    }
  ],
  "source": "Hyperliquid perpetuals",
  "updated_at": "2026-11-03T20:19:22.814006+00:00"
}
$0.003

Derivatives

EndpointWhat you getPrice
/v1/derivatives/funding-rates Get funding rates (Hyperliquid perpetuals, hourly)symbols
Details and example

Current funding rates for up to 20 Hyperliquid perpetuals (USDC-margined). Funding is settled hourly: funding_rate_pct is the hourly rate and annualized_rate_pct = hourly rate times 8760, plus 7d/30d averages, mark price in USDC and a crowding signal. Positive = longs pay shorts (crowded longs). Use to read positioning before entering. Funding, not open interest.

  • symbols, default BTC,ETH,SOL
GET https://x402.swaphunt.dev/v1/derivatives/funding-rates

Example response (real data, 2026-11-03; long lists shortened):

{
  "rates": [
    {
      "symbol": "BTC",
      "funding_rate": 1.3e-05,
      "funding_rate_pct": 0.00125,
      "annualized_rate_pct": 10.95,
      "mark_price": 77711.9,
      "next_funding_time": "2026-11-03T21:00:00",
      "signal": "neutral",
      "avg_7d": 0.001221,
      "avg_30d": 0.001021,
      "avg_7d_annualized_pct": 10.7,
      "avg_30d_annualized_pct": 8.94,
      "funding_interval_hours": 1,
      "updated_at": "2026-11-03T20:19:21.622646",
      "source": "Hyperliquid perpetuals"
    },
    {
      "symbol": "ETH",
      "funding_rate": 1.3e-05,
      "funding_rate_pct": 0.00125,
      "annualized_rate_pct": 10.95,
      "mark_price": 2284.4,
      "next_funding_time": "2026-11-03T21:00:00",
      "signal": "neutral",
      "avg_7d": 0.000632,
      "avg_30d": 0.000754,
      "avg_7d_annualized_pct": 5.53,
      "avg_30d_annualized_pct": 6.61,
      "funding_interval_hours": 1,
      "updated_at": "2026-11-03T20:19:21.622646",
      "source": "Hyperliquid perpetuals"
    }
  ],
  "count": 3,
  "updated_at": "2026-11-03T20:19:21.622646",
  "source": "Hyperliquid perpetuals"
}
$0.003
/v1/derivatives/funding-rates/history Get funding rate history (Hyperliquid perpetuals, hourly)symbol, days
Details and example

Settled hourly funding rates for one coin on Hyperliquid perpetuals (USDC-margined), with average, range, share of positive periods and the percentile of the latest rate. Up to 365 days; history_days shows coverage per coin. Annualized = hourly rate times 8760. Use to judge whether today's funding is unusual for that coin.

  • symbol, default BTC
  • days, default 90
GET https://x402.swaphunt.dev/v1/derivatives/funding-rates/history

Example response (real data, 2026-11-03; long lists shortened):

{
  "symbol": "BTC",
  "days": 90,
  "interval_hours": 1.0,
  "count": 2160,
  "history_days": 90.0,
  "current_pct": 0.00125,
  "avg_pct": 0.001008,
  "min_pct": -0.001595,
  "max_pct": 0.008977,
  "avg_annualized_pct": 8.83,
  "positive_share_pct": 92.5,
  "current_percentile": 97.5,
  "points": [
    {
      "time": "2026-08-05T21:00:00",
      "rate_pct": 0.000171,
      "annualized_pct": 1.5
    },
    {
      "time": "2026-08-05T22:00:00",
      "rate_pct": -1.2e-05,
      "annualized_pct": -0.11
    }
  ],
  "source": "Hyperliquid perpetuals"
}
$0.004
/v1/derivatives/funding-rates/top Get top funding rates (Hyperliquid perpetuals, hourly)limit, sort
Details and example

Top N current funding rates, highest or lowest, across all active Hyperliquid perpetuals (USDC-margined; funding settled hourly, annualized = hourly rate times 8760): a leaderboard of the most crowded longs (highest) or shorts (lowest). Use to spot squeeze and crowding extremes fast.

  • limit, default 10
  • sort, default highest
GET https://x402.swaphunt.dev/v1/derivatives/funding-rates/top

Example response (real data, 2026-11-03; long lists shortened):

{
  "entries": [
    {
      "symbol": "GOAT",
      "funding_rate": 0.000145,
      "funding_rate_pct": 0.014509,
      "annualized_rate_pct": 127.1,
      "mark_price": 0.013856,
      "signal": "extreme_positive",
      "rank": 1
    },
    {
      "symbol": "RUNE",
      "funding_rate": 6.4e-05,
      "funding_rate_pct": 0.006398,
      "annualized_rate_pct": 56.05,
      "mark_price": 0.63969,
      "signal": "elevated",
      "rank": 2
    }
  ],
  "count": 10,
  "total_symbols": 179,
  "sort": "highest",
  "updated_at": "2026-11-03T20:19:21.622646",
  "source": "Hyperliquid perpetuals"
}
$0.003

Volatility

EndpointWhat you getPrice
/v1/vol/compression-alert Detect volatility squeeze (Hyperliquid perpetuals)asset, timeframe, quote
Details and example

Bollinger-Band squeeze detector on candles from Hyperliquid perpetuals (USDC-margined): is volatility compressing toward a likely expansion? Returns extreme/strong/moderate/none, band width and its percentile; quote is USDC and pair like BTC-USDC. Use to anticipate breakouts before they fire. Detects the setup, not the direction.

  • asset, default BTC
  • timeframe, default 4h
  • quote, default USDC
GET https://x402.swaphunt.dev/v1/vol/compression-alert

Example response (real data, 2026-11-03; long lists shortened):

{
  "asset": "BTC",
  "quote": "USDC",
  "pair": "BTC-USDC",
  "timeframe": "4h",
  "is_squeeze": true,
  "squeeze_level": "strong",
  "bollinger_width_pct": 2.51,
  "avg_width_pct": 4.27,
  "width_percentile": 22.5,
  "width_ratio": 0.59,
  "bollinger": {
    "upper": 78598.25,
    "middle": 77622.95,
    "lower": 76647.65,
    "price_position_pct": 53.75
  },
  "verdict": "Strong squeeze detected. Volatility expansion expected soon.",
  "note": "Low percentile = tighter than usual = squeeze",
  "updated_at": "2026-11-03T20:15:29.706899+00:00",
  "source": "Hyperliquid perpetuals"
}
$0.003
/v1/vol/expected-move Expected price range (Hyperliquid perpetuals)asset, period, quote
Details and example

ATR-based expected price range from candles of Hyperliquid perpetuals (USDC-margined): the 68% and 95% bands around the current price, in USDC; quote is USDC and pair like BTC-USDC. Use to set realistic targets, stops and breakout thresholds. A statistical range, not a directional forecast.

  • asset, default BTC
  • period, default 1d
  • quote, default USDC
GET https://x402.swaphunt.dev/v1/vol/expected-move

Example response (real data, 2026-11-03; long lists shortened):

{
  "asset": "BTC",
  "quote": "USDC",
  "pair": "BTC-USDC",
  "period": "daily",
  "current_price": 77695.0,
  "atr_14": 1937.79,
  "expected_move_usd": 1937.79,
  "expected_move_pct": 2.49,
  "expected_range": {
    "high": 79632.79,
    "low": 75757.21
  },
  "probability_ranges": {
    "68_pct": {
      "high": 79632.79,
      "low": 75757.21,
      "description": "68% of moves stay within this range"
    },
    "95_pct": {
      "high": 81570.57,
      "low": 73819.43,
      "description": "95% of moves stay within this range"
    }
  },
  "volatility_state": "normal",
  "volatility_note": "Volatility at typical levels.",
  "updated_at": "2026-11-03T20:15:29.710298+00:00",
  "source": "Hyperliquid perpetuals"
}
$0.003
/v1/vol/realized Get realized volatility (Hyperliquid perpetuals)asset, period
Details and example

Realized volatility for an asset from daily candles of Hyperliquid perpetuals (USDC-margined): daily and annualized %, a low/normal/high/extreme bucket and the current UTC day's high/low/range vs open. Use to size positions and set expectations. Backward-looking (realized), not implied/option vol.

  • asset, default BTC
  • period, default 7d
GET https://x402.swaphunt.dev/v1/vol/realized

Example response (real data, 2026-11-03; long lists shortened):

{
  "asset": "BTC",
  "realized_volatility_pct": 1.92,
  "annualized_volatility_pct": 36.7,
  "level": "normal",
  "high_24h_pct": 1.39,
  "low_24h_pct": -0.6,
  "range_24h_pct": 1.99,
  "period": "7d",
  "updated_at": "2026-11-03T20:15:29.703159",
  "source": "Hyperliquid perpetuals"
}
$0.002
/v1/vol/silence Get market silence score (Hyperliquid perpetuals)asset, lookback
Details and example

Market-silence score 0-1 from daily candles of Hyperliquid perpetuals (USDC-margined): a composite of low notional volume, low volatility and small price change. High silence often precedes expansion. Use to spot the calm-before-the-move. Pairs with /v1/vol/compression-alert.

  • asset, default BTC
  • lookback, default 7d
GET https://x402.swaphunt.dev/v1/vol/silence

Example response (real data, 2026-11-03; long lists shortened):

{
  "asset": "BTC",
  "silence_score": 0.45,
  "level": "medium",
  "recommendation": "be_cautious",
  "factors": {
    "volume_ratio": 0.7,
    "volume_today_usd": 1766352090.0,
    "volume_avg_usd": 2508802713.0,
    "volatility_pct": 1.96,
    "price_change_24h_pct": 1.16
  },
  "lookback": "7d",
  "updated_at": "2026-11-03T20:19:23.127003",
  "source": "Hyperliquid perpetuals"
}
$0.002

Market regime

EndpointWhat you getPrice
/v1/regime/chop-detection Is market choppy or trending? (Hyperliquid perpetuals)asset, timeframe, quote
Details and example

ADX-based chop-vs-trend detector on candles from Hyperliquid perpetuals (USDC-margined) for an asset/timeframe: is price trending or stuck in a range? Returns is_chop, a chop level, ADX, +DI/-DI and trend direction; quote is USDC and pair like BTC-USDC. Use to avoid trend strategies in chop (and range strategies in trends).

  • asset, default BTC
  • timeframe, default 4h
  • quote, default USDC
GET https://x402.swaphunt.dev/v1/regime/chop-detection

Example response (real data, 2026-11-03; long lists shortened):

{
  "asset": "BTC",
  "quote": "USDC",
  "pair": "BTC-USDC",
  "timeframe": "4h",
  "is_chop": true,
  "chop_level": "high",
  "adx": 19.88,
  "adx_interpretation": {
    "below_20": "Choppy/ranging",
    "20_25": "Trend emerging",
    "25_50": "Strong trend",
    "above_50": "Very strong trend"
  },
  "plus_di": 16.5,
  "minus_di": 20.44,
  "trend_direction": "none",
  "verdict": "Market is choppy. No clear trend. Avoid trend-following strategies.",
  "updated_at": "2026-11-03T20:15:29.985935+00:00",
  "source": "Hyperliquid perpetuals"
}
$0.003
/v1/regime/current Get current market regime (BTC, Hyperliquid perpetuals)
Details and example

Current BTC market regime (BULLISH / BEARISH / NEUTRAL) from Hyperliquid perpetuals (USDC-margined): the BTC perp price vs its 20-period EMA on 12h candles, with the EMA value and slope (prices in USDC). Updates at each 12h close (00:00 and 12:00 UTC). The top-level risk filter: trade-with-trend context before any entry. BTC-based; pair with per-asset tools for alts.

GET https://x402.swaphunt.dev/v1/regime/current

Example response (real data, 2026-11-03; long lists shortened):

{
  "regime": "BEARISH",
  "price": 77681.0,
  "ema20": 78888.67,
  "price_vs_ema_pct": -2.28,
  "ema_slope_pct": -1.098,
  "interval": "12h",
  "candle_close": "2026-11-03T11:59:59.999000Z",
  "next_update": "2026-11-03T23:59:59.999000Z",
  "updated_at": "2026-11-03T20:18:40.402653Z",
  "source": "Hyperliquid perpetuals"
}
$0.002

Trading context

EndpointWhat you getPrice
/v1/context/session What trading session is it?
Details and example

Current trading session (Asia / London / NY / Off) plus historical volatility for that session. Use to time entries around the most active hours and set session-aware expectations.

GET https://x402.swaphunt.dev/v1/context/session

Example response (real data, 2026-11-03; long lists shortened):

{
  "current_session": "new_york",
  "session_name": "New York",
  "markets_active": "New York, Chicago",
  "is_overlap": false,
  "session_start_utc": "2026-11-03T13:00:00+00:00",
  "session_end_utc": "2026-11-03T21:00:00+00:00",
  "minutes_remaining": 40,
  "next_session": "off_hours",
  "expected_volatility": "high",
  "volatility_multiplier": 1.2,
  "historical_session_volatility": {
    "asian": "low (0.7x)",
    "london": "normal (1.0x)",
    "new_york": "high (1.2x)",
    "london_ny_overlap": "highest (1.4x)",
    "off_hours": "lowest (0.5x)"
  },
  "updated_at": "2026-11-03T20:19:23.873057+00:00"
}
$0.001
/v1/context/weekend-liquidity Is it weekend/low liquidity time?
Details and example

Is it a weekend / low-liquidity window right now? Returns the current session and a 0-100 liquidity score. Use to widen stops and discount thin-market moves. Lightweight market-condition context.

GET https://x402.swaphunt.dev/v1/context/weekend-liquidity

Example response (real data, 2026-11-03; long lists shortened):

{
  "is_weekend": false,
  "is_low_liquidity": false,
  "day_of_week": "Tuesday",
  "weekday_number": 1,
  "current_hour_utc": 20,
  "session": "new_york",
  "is_overlap": false,
  "liquidity_score": 100,
  "verdict": "New York session. High liquidity. Good conditions.",
  "updated_at": "2026-11-03T20:19:23.818269+00:00"
}
$0.001

Sanity checks

EndpointWhat you getPrice
/v1/sanity/is-this-a-breakout Is this breakout confirmed? (Hyperliquid perpetuals)symbol, level*, direction, quote
Details and example

Is a breakout from a given level real or a fakeout? Checks volume vs the 20-candle average and how many 1h closes held beyond the level, on Hyperliquid perpetuals (USDC-margined), and returns is_confirmed, a fakeout probability and a verdict. Use to validate a breakout before chasing it. Requires the level in USDC. Coverage: top 50 Hyperliquid perpetuals by 30-day volume; see /v1/tools/price/supported (other coins get 422 not_covered, no charge).

  • symbol, default BTC
  • level (required)
  • direction, default up
  • quote, default USDC
GET https://x402.swaphunt.dev/v1/sanity/is-this-a-breakout?symbol=BTC&level=79146&direction=down

Example response (real data, 2026-11-03; long lists shortened):

{
  "symbol": "BTC",
  "quote": "USDC",
  "pair": "BTC-USDC",
  "level": 79146.0,
  "direction": "down",
  "current_price": 77712.0,
  "is_beyond_level": true,
  "is_confirmed": false,
  "volume_ratio": 0.62,
  "time_beyond_mins": 360,
  "candles_beyond": 6,
  "fake_probability": 70,
  "verdict": "Holding in time (6h), but volume (0.6x) is low.",
  "source": "Hyperliquid perpetuals",
  "updated_at": "2026-11-03T20:19:23.391258+00:00"
}
$0.003
/v1/sanity/is-this-a-dip Is this actually a dip? (Hyperliquid perpetuals)symbol, quote
Details and example

Is this drop a real dip or just noise? Compares the fall from the 14-day high with the 14-day ATR on daily candles of Hyperliquid perpetuals (USDC-margined) and returns is_dip, drop %, ATR %, drop/ATR and a verdict; prices in USDC. Use before buying the dip to check the dip is real. Coverage: top 50 Hyperliquid perpetuals by 30-day volume; see /v1/tools/price/supported (other coins get 422 not_covered, no charge).

  • symbol, default BTC
  • quote, default USDC
GET https://x402.swaphunt.dev/v1/sanity/is-this-a-dip

Example response (real data, 2026-11-03; long lists shortened):

{
  "symbol": "BTC",
  "quote": "USDC",
  "pair": "BTC-USDC",
  "is_dip": true,
  "current_price": 77695.0,
  "recent_high": 84850.0,
  "drop_pct": 8.43,
  "atr_pct": 2.49,
  "drop_vs_atr": 3.38,
  "verdict": "Definitely. 8.4% is 3.4x normal volatility. Actual dip.",
  "source": "Hyperliquid perpetuals",
  "updated_at": "2026-11-03T20:19:23.328382+00:00"
}
$0.003
/v1/sanity/is-this-oversold Is this actually oversold? (Hyperliquid perpetuals)symbol, quote
Details and example

Multi-timeframe RSI oversold check on Hyperliquid perpetuals (USDC-margined): RSI 14 on 1h, 4h and 1d candles, weighted 20/30/50, returning is_oversold, each RSI and the weighted RSI. Use to confirm an oversold condition across timeframes rather than trusting a single chart. RSI-based, not a buy signal on its own. Coverage: top 50 Hyperliquid perpetuals by 30-day volume; see /v1/tools/price/supported (other coins get 422 not_covered, no charge).

  • symbol, default BTC
  • quote, default USDC
GET https://x402.swaphunt.dev/v1/sanity/is-this-oversold

Example response (real data, 2026-11-03; long lists shortened):

{
  "symbol": "BTC",
  "quote": "USDC",
  "pair": "BTC-USDC",
  "current_price": 77712.0,
  "is_oversold": false,
  "rsi_1h": 79.6,
  "rsi_4h": 46.9,
  "rsi_1d": 30.5,
  "weighted_rsi": 45.2,
  "oversold_timeframes": 0,
  "verdict": "No. No timeframe is oversold (RSI < 30). Weighted RSI: 45.",
  "source": "Hyperliquid perpetuals",
  "updated_at": "2026-11-03T20:19:23.510335+00:00"
}
$0.003
/v1/sanity/is-this-support Is this actually support? (Hyperliquid perpetuals)symbol, level*, quote
Details and example

Is a price level valid support? Counts touches within 0.5% over 90 daily candles of Hyperliquid perpetuals (USDC-margined), with recency and bounce quality, so an agent can judge whether the level is likely to hold. Use before leaning on a support for entries or stops. Requires the level in USDC. Coverage: top 50 Hyperliquid perpetuals by 30-day volume; see /v1/tools/price/supported (other coins get 422 not_covered, no charge).

  • symbol, default BTC
  • level (required)
  • quote, default USDC
GET https://x402.swaphunt.dev/v1/sanity/is-this-support?symbol=BTC&level=76000

Example response (real data, 2026-11-03; long lists shortened):

{
  "symbol": "BTC",
  "quote": "USDC",
  "pair": "BTC-USDC",
  "level": 76000.0,
  "current_price": 77695.0,
  "is_valid_support": true,
  "touch_count": 7,
  "days_since_last_touch": 0.8,
  "bounce_quality": "strong",
  "avg_bounce_pct": 2.16,
  "verdict": "Yes. 7 touches, last 1 days ago. Valid support.",
  "source": "Hyperliquid perpetuals",
  "updated_at": "2026-11-03T20:19:23.454389+00:00"
}
$0.003

Anti-FOMO

EndpointWhat you getPrice
/v1/fomo/already-extended Is price already extended? (Hyperliquid perpetuals)symbol, quote
Details and example

Is price over-extended? Distance from MA20 and MA50, Bollinger Band position and a z-score on 4h candles of Hyperliquid perpetuals (USDC-margined), in one read. Use to avoid entering after price has stretched far from its mean. Mean-reversion context. Coverage: top 50 Hyperliquid perpetuals by 30-day volume; see /v1/tools/price/supported (other coins get 422 not_covered, no charge).

  • symbol, default BTC
  • quote, default USDC
GET https://x402.swaphunt.dev/v1/fomo/already-extended

Example response (real data, 2026-11-03; long lists shortened):

{
  "symbol": "BTC",
  "quote": "USDC",
  "pair": "BTC-USDC",
  "current_price": 77712.0,
  "is_extended": false,
  "direction": "up",
  "ma20": 77623.75,
  "ma50": 78731.94,
  "distance_from_ma20_pct": 0.11,
  "distance_from_ma50_pct": -1.3,
  "bb_position": 0.546,
  "z_score": 0.19,
  "verdict": "Not extended. Price is within 1 std dev of MA20.",
  "source": "Hyperliquid perpetuals",
  "updated_at": "2026-11-03T20:19:23.703484+00:00"
}
$0.003
/v1/fomo/green-candles-streak How many green candles in a row? (Hyperliquid perpetuals)symbol, interval, quote
Details and example

Counts consecutive green candles on 1h, 4h or 1d candles of Hyperliquid perpetuals (USDC-margined) and how often the next candle was green after streaks that long in the last 100 candles. Use to gauge exhaustion risk before buying a long green run. Coverage: top 50 Hyperliquid perpetuals by 30-day volume; see /v1/tools/price/supported (other coins get 422 not_covered, no charge).

  • symbol, default BTC
  • interval, default 4h
  • quote, default USDC
GET https://x402.swaphunt.dev/v1/fomo/green-candles-streak

Example response (real data, 2026-11-03; long lists shortened):

{
  "symbol": "BTC",
  "quote": "USDC",
  "pair": "BTC-USDC",
  "interval": "4h",
  "streak": 1,
  "streak_gain_pct": 0.16,
  "historical_avg_streak": 1.8,
  "historical_max_streak": 5,
  "next_green_probability": 45.8,
  "verdict": "1 green candles. Below avg (1.8). Streak could continue.",
  "source": "Hyperliquid perpetuals",
  "updated_at": "2026-11-03T20:19:23.756165+00:00"
}
$0.003
/v1/fomo/how-late-am-i How late am I to this move? (Hyperliquid perpetuals)symbol, quote
Details and example

FOMO guard on 4h candles of Hyperliquid perpetuals (USDC-margined): how far price has already run from the recent swing low, in % and ATR multiples, and where that move ranks against past 20-candle moves, with an early/middle/late verdict. Use so an agent does not buy the top. Coverage: top 50 Hyperliquid perpetuals by 30-day volume; see /v1/tools/price/supported (other coins get 422 not_covered, no charge).

  • symbol, default BTC
  • quote, default USDC
GET https://x402.swaphunt.dev/v1/fomo/how-late-am-i

Example response (real data, 2026-11-03; long lists shortened):

{
  "symbol": "BTC",
  "quote": "USDC",
  "pair": "BTC-USDC",
  "current_price": 77712.0,
  "swing_low": 76342.0,
  "move_pct": 1.79,
  "move_in_atr": 1.92,
  "candles_since_low": 4,
  "historical_avg_move": 5.92,
  "move_percentile": 0.0,
  "verdict": "Early. Move just started, you're not late.",
  "source": "Hyperliquid perpetuals",
  "updated_at": "2026-11-03T20:19:23.574602+00:00"
}
$0.003
/v1/fomo/pump-age How old is this pump? (Hyperliquid perpetuals)symbol, quote
Details and example

Active pump detector on the last 24 hours of 15m candles of Hyperliquid perpetuals (USDC-margined): is the coin pumping now, since when, how far, and how that compares with the average pump length in the window. Use to judge whether a move is fresh or exhausted before joining it. Coverage: top 50 Hyperliquid perpetuals by 30-day volume; see /v1/tools/price/supported (other coins get 422 not_covered, no charge).

  • symbol, default BTC
  • quote, default USDC
GET https://x402.swaphunt.dev/v1/fomo/pump-age

Example response (real data, 2026-11-03; long lists shortened):

{
  "symbol": "BTC",
  "quote": "USDC",
  "pair": "BTC-USDC",
  "current_price": 77660.0,
  "is_pumping": false,
  "pump_start": null,
  "pump_start_price": null,
  "pump_duration_mins": 0,
  "pump_pct": 0,
  "avg_pump_duration_mins": 75.0,
  "current_momentum": 0.09,
  "avg_momentum": 0.21,
  "verdict": "No active pump detected. Safe to wait.",
  "source": "Hyperliquid perpetuals",
  "updated_at": "2026-11-03T20:19:23.635071+00:00"
}
$0.003

Where the data comes from

Prices, funding, volatility, market regime and the Alt Season Index are calculated by SwapHunt from Hyperliquid perpetuals (USDC-margined). Prices are quoted in USDC as mark or mid price, funding is settled hourly, and every response carries a source field.

The sanity, anti-FOMO, coin strength, momentum and correlation endpoints cover the top 50 Hyperliquid perpetuals by 30-day volume, recomputed daily. A covered coin is dropped only after it ranks below 60th place on three daily recomputes in a row, so the list stays stable. Other coins get 422 not_covered before any payment is requested, so you are never charged for them. The current list is in the covered field of /v1/tools/price/supported.

The Fear & Greed Index comes from Alternative.me, and each response includes an attribution field to show next to the number. The halving countdown is calculated from the current block height of each chain. Session and weekend liquidity context is calculated by SwapHunt from the clock and needs no outside data.

Code examples

An unpaid request returns 402 Payment Required. The price and payment details are in the payment-required header, base64-encoded:

curl -i https://x402.swaphunt.dev/v1/tools/price?asset=BTC

HTTP/2 402
payment-required: eyJ4NDAyVmVyc2lvbiI6Mi...

# decoded:
{"x402Version": 2,
 "accepts": [{"scheme": "exact",
              "network": "eip155:8453",        # Base
              "asset": "0x8335...2913",        # USDC
              "amount": "1000",                # 0.001 USDC (6 decimals)
              "payTo": "0xD6b5...23a8"},
             {"network": "eip155:137", ...},       # Polygon
             {"network": "eip155:42161", ...},     # Arbitrum
             {"network": "solana:5eykt4Us...", ...}]}  # Solana

The client picks the network your wallet holds USDC on. The price is the same on every network.

An x402 client library reads that header, signs a USDC payment from your wallet and repeats the request with the payment attached. The response is the JSON you asked for. Clients exist for JavaScript, Python and Go.

Runnable examples in Python and TypeScript are in swaphunt/x402-examples on GitHub: a single paid call, a daily market brief and an alert bot. Every example does a dry run first and only pays when you ask it to.

See the x402 documentation for client setup.

Use it from Claude

The SwapHunt MCP server gives Claude and other MCP agents SwapHunt's endpoints as tools. Each tool description states its price, so the agent sees what a call costs before it makes it.

  • Dry run by default. Without X402_PAY=1 a tool reports its price and returns no data.
  • Spending cap. MAX_SPEND_USD (default $0.10) limits what one session can spend. Calls beyond it are refused, not paid.
  • Locked payments. Each payment is tied to the quoted price, USDC on Base and SwapHunt's receiving address.

The server is on PyPI as swaphunt-mcp. Use a dedicated wallet with a few dollars of USDC on Base. Adding it to Claude Code is one command, and uvx fetches the package on first run:

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

Leave out X402_PAY=1 to try it first: every tool then reports its price without paying. Then ask, for example: "Is this BTC drop a real dip, and is ETH already extended?" Setup for Claude Desktop and the full tool list with prices are in the MCP server README.

FAQ

What is x402?
x402 is an open payment protocol built on HTTP 402 Payment Required. The server answers an unpaid request with the price, and an x402 client pays in USDC and repeats the request with the payment attached.
Do I need an account or API key?
No. There is no sign-up, API key or subscription. Each request is paid on its own.
Which chains can I pay on?
USDC on Base, Polygon, Arbitrum or Solana. The price is the same on every network.
What does it cost?
From $0.001 to $0.005 in USDC per successful call, depending on the endpoint. The table on this page lists the price of each one.
Where are code examples?
Runnable Python and TypeScript examples and an MCP server for Claude are in swaphunt/x402-examples on GitHub: https://github.com/swaphunt/x402-examples