# SwapHunt Alt-Season Detector

> SwapHunt Alt-Season Detector is a paid API for AI agents from x402.swaphunt.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Returns a 0-100 alt-season index, percentage of top-10 altcoins outperforming BTC, and a boolean verdict over a configurable lookback window to signal BTC-to-alt rotation timing.

## Facts

- Endpoint: GET https://x402.swaphunt.dev/v1/market/alt-season
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/swaphunt-alt-season-detector-6ff9e284
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_24VqQRIiGXUhwr6ml1VCc

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability swaphunt-alt-season-detector-6ff9e284
```

Example prompt: Check the alt-season detector with a 14-day lookback — I want to know the current 0-100 index score, what percentage of the top-10 alts are beating BTC, and whether it's technically alt season right now so I can decide whether to rotate out of Bitcoin.

## When to prefer this

Use this endpoint when you need a single synthesized signal for BTC-vs-altcoin rotation timing based on relative performance of the top-10 alts. Prefer this over raw BTC dominance endpoints when you want a performance-relative (not capital-flow) verdict. Best combined with /dominance for a complete rotation picture.

## Known failure modes

- Invalid 'days' parameter outside 1-30 range returns validation error
- Market data unavailability for one or more top-10 alts may cause partial or error response
- Stale pricing data during exchange outages could skew the index
- Missing required method/type fields in input returns 400-level error

## How this service works

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.

## Output

Returns a 0-100 alt-season index score, the percentage of top-10 altcoins that have outperformed BTC over the lookback period, and a boolean true/false verdict indicating whether alt season conditions are currently met.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "days": {
       "type": "integer",
       "default": 7,
       "description": "Lookback period in days (1-30)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/swaphunt-alt-season-detector-6ff9e284/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.swaphunt.dev](https://www.zero.xyz/host/x402.swaphunt.dev/llms.txt)