x402.swaphunt.dev

SwapHunt — a crypto market-context toolkit for trading agents: live prices, market regime, volatility, sentiment, funding, macro events, seasonality and anti-FOMO sanity checks, all pay-per-call. This route returns a single asset's live spot price with 24h context: price, 24h cha

Relative strength of a coin vs BTC over a period, returned as a category (very_strong → very_weak) plus a numeric score. Use to rank a coin's momentum against the benchmark before entering. A strength read, not a price target.

Aggregated market sentiment label (strong_bearish → strong_bullish) with a normalized score, computed from LLM-scored news over the window. One-number mood read for an agent that just needs the verdict, not the individual articles.

Recent crypto news headlines each scored 1-10 for trading impact by an LLM (qwen3:8b), with a bullish/bearish/neutral tag. Filter by category, minimum score and lookback hours. Use to surface market-moving stories; for the aggregate read use /sentiment/summary.

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.

How much of today's expected (ATR) range has already been used — low/moderate/high/extended — with the % consumed. Use to judge remaining room before chasing intraday. Tells you how 'full' the day is.

Current BTC market regime — BULLISH / BEARISH / NEUTRAL — derived from price vs its 20-period EMA on the 12h candle, with the EMA value and slope. The top-level risk filter: trade-with-trend context before any entry. BTC-based; pair with per-asset tools for alts.

Multi-timeframe RSI oversold check (1h/4h/1d, weighted) returning a boolean + the blended RSI. Use to confirm an oversold condition across timeframes rather than trusting a single chart. RSI-based, not a buy signal on its own.

Historical volatility by hour of day (UTC) plus a session comparison — which hours move most. Use to time entries to active hours and avoid dead zones. Intraday seasonality.

Historical performance by calendar month (e.g. 'Uptober') — avg return and win rate per month. Use for seasonal positioning. Pattern from history, not a prediction.

Historical performance by day of week (avg return + win rate per weekday) over the lookback. Use to time entries/exits around statistically stronger or weaker days. Seasonality, not a forecast.

Upcoming macro events (FOMC, CPI, NFP, etc.) with date, country and impact level, filterable to high-impact only. Use to avoid trading into scheduled volatility or to plan around it. Forward calendar; for past actuals use /macro/history.

Is price over-extended? Distance from MA20/MA50, Bollinger-band position and a z-score in one read. Use to avoid entering after price has stretched far from its mean. Mean-reversion context.

FOMO guard: how far has price already run from the recent swing low — in % and ATR multiples — versus the historical average move? Returns an early/mid/late read so an agent doesn't buy the top. Anti-chase context.

Active-pump detector: is the asset currently pumping, and for how long vs the historical average pump length? Use to judge whether a move is fresh or exhausted before joining it.

Alt-season detector: what % of the top-10 alts have outperformed BTC over the lookback window, with a 0-100 index and a boolean verdict. Use to time BTC↔alt rotation. Complements /dominance (capital location) with relative-performance signal.

Pearson correlation of a coin's returns vs BTC (-1 to +1) over the period. Use to judge diversification and whether an alt is moving independently or just tracking BTC. A correlation coefficient, not a beta or causation claim.

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.

Whole-market snapshot: total crypto market cap, total 24h volume, BTC dominance, and counts of active coins and markets. One call for the macro state of crypto — the top-of-funnel context before drilling into an asset.

ADX-based chop-vs-trend detector for an asset/timeframe: is price trending or stuck in a range? Returns a boolean + chop score. Use to avoid trend strategies in chop (and range strategies in trends).

Is this drop a statistically significant dip or just noise? Compares the move against the asset's ATR and returns a verdict + the drawdown size. Use before 'buy the dip' to check the dip is real.

Bollinger-Band squeeze detector: is volatility compressing toward a likely expansion? Returns extreme/strong/moderate/none plus bandwidth. Use to anticipate breakouts before they fire. Detects the setup, not the direction.

ATR-based expected price range for the period: the 68% and 95% probability bands around current price. Use to set realistic targets, stops and breakout thresholds. A statistical range, not a directional forecast.

Realized volatility for an asset: daily and annualized %, plus a low/normal/high/extreme bucket and the 24h high/low/range. Use to size positions and set expectations. Backward-looking (realized), not implied/option vol.