Altcoin-season index (0–100) — feed pending.

Share of top-50 altcoins that outperformed BTC over the lookback window, mapped to a 0–100 scale. Above 75 = altcoin season; below 25 = Bitcoin season. Blocked on a top-50 spot-price adapter; for now this stub returns `index: null` with `meta.unavailable = "not-yet-ingested"`.

Query parameters

All query parameters are optional unless marked required.

Response shape

Always wrapped in the standard envelope. Nullable fields are explicitly marked — treat missing numeric data as a real data-source gap, not as an error.

// Wrapped in the standard envelope:
// {
//   data: /* shape below */,
//   meta?: { total?: number; limit?: number; offset?: number; ... }
// }

{
  lookback: number;
  index: number | null;
  classification: string | null;
  asOf: number | null;
}

Example

Copy the curl, replace YOUR_KEY with a real key from your dashboard, and run.

curl -sS "http://localhost:3000/api/v1/indicators/altcoin-season?lookback=90"

{
  "data": { "lookback": 90, "index": null, "classification": null, "asOf": null },
  "meta": { "total": 0, "lookback": 90, "unavailable": "not-yet-ingested", "dataStatus": "not-yet-ingested" }
}