Datos para desarrolladores

Endpoints

• GET https://claudereset.org/api/v1/forecast.json — p24/p48 actuales, confianza y todas las entradas.
• GET https://claudereset.org/api/v1/timeline.json — todos los eventos registrados.
• GET https://claudereset.org/api/v1/signals.json — la última instantánea de status + issues.
• GET https://claudereset.org/api/v1/banked.json — Banked Reset activos actualmente.
• POST https://claudereset.org/mcp — servidor MCP (JSON-RPC 2.0, Streamable HTTP).
• https://claudereset.org/feed.xml — feed Atom.
• https://claudereset.org/calendar.ics — feed iCalendar (reinicios pasados + recordatorios de vencimiento de Banked Reset).

Se agradece la atribución: "Data: claudereset.org". Gratis de usar, cacheado 5 minutos en el edge, CORS habilitado.

/api/v1/forecast.json — ejemplo

{
  "schema_version": 1,
  "generated_at": "2026-09-23T10:09:51Z",
  "source": "https://claudereset.org",
  "available": true,
  "reset_today": false,
  "p24": 13,
  "p48": 22,
  "confidence": "low",
  "confidence_reasons": [
    "the selected rhythm model (memoryless) doesn't yet beat the climatology baseline in backtesting"
  ],
  "inputs": {
    "avg_gap_hours": 337.0,
    "hours_since_last": 446.0,
    "B": 0.0712,
    "C": null,
    "cad24": 0.0687,
    "official_signal": 0.0,
    "status_signal": 0.2683,
    "issues_signal": 0.0528,
    "S": 0.0671,
    "global": true,
    "rhythm_model": "memoryless"
  },
  "formula_version": "1",
  "disclaimer": "Independent project, not affiliated with Anthropic. Anthropic has never published or promised a reset schedule \u2014 every reset recorded here was announced ad hoc. Percentages are estimates from past announcements, not a schedule.",
  "freshness": {
    "events_checked_at": "2026-09-23T10:03:55Z",
    "signals_fetched_at": "2026-09-23T10:00:44Z",
    "built_at": "2026-09-23T10:09:51Z"
  }
}

/api/v1/timeline.json — ejemplo (1 evento)

{
  "schema_version": 1,
  "source": "https://claudereset.org",
  "events": [
    {
      "id": "2102438800836489554",
      "date": "2026-09-22",
      "ts": "2026-09-22T16:44:06Z",
      "scope": "Pro+Max+Team",
      "kind": "banked",
      "source": "ClaudeDevs",
      "url": "https://x.com/ClaudeDevs/status/2102438800836489554",
      "summary": "Opus 5.5 performs at the level of Fable 5.1, ~30% faster and ~40% cheaper than Opus 5 per task. In Claude Code: 5-hour session limits increase 20% today; Pro, Max, and Team users get a reset to use anytime (available in Settings \u2192 Usage, apply any time until Oct 22).",
      "partial": false,
      "global": false,
      "origin": "official_post"
    }
  ]
}

Ejemplo: curl

curl -s https://claudereset.org/api/v1/forecast.json | jq .p24

Ejemplo: JavaScript fetch

const r = await fetch("https://claudereset.org/api/v1/forecast.json").then(r => r.json());
console.log(`Next 24h: ${r.p24}% (confidence: ${r.confidence})`);

Servidor MCP

Un servidor Model Context Protocol de solo lectura en https://claudereset.org/mcp: JSON-RPC 2.0 sin estado sobre HTTP POST, sin clave de API, sin operaciones de escritura.

claude mcp add --transport http claudereset https://claudereset.org/mcp

Herramientas

Frecuencia de actualización y versionado

El sitio comprueba sus señales de estado e issues según un calendario (no de forma continua) — fetched_at en /api/v1/signals.json te dice exactamente cuándo. Un cambio de esquema que rompa compatibilidad se publica como una nueva ruta /api/v2/; /api/v1/ nunca se modifica en el sitio.

Script de status line para Claude Code

Muestra 5h: X% · 7d: Y% · reset odds 24h: Z% en tu status line de Claude Code — lee rate_limits.five_hour.used_percentage/rate_limits.seven_day.used_percentage del propio Claude Code, más la API de predicción de este sitio para la tercera cifra (cacheada localmente 10 minutos en ~/.cache/claudereset-forecast.json, timeout de 2s). También disponible en /usage-check/, con un analizador para tu propio JSON de uso pegado.

#!/bin/bash
# claudereset.org example Claude Code status line script.
# Install: save this as ~/.claude/statusline.sh (chmod +x), then set it as your status line
# command per https://code.claude.com/docs/en/statusline — Claude Code pipes the status line's
# JSON into this script's stdin on every prompt render.
#
# Shows your own Claude Code usage (5-hour and 7-day windows, straight from the status line's own
# `rate_limits` object) plus this site's live 24h global-reset-odds forecast. The forecast fetch
# is cached locally for 10 minutes (by file mtime) and capped at a 2-second timeout, so a slow or
# unreachable network never blocks your prompt — it just falls back to showing only the usage
# figures.
set -u
input=$(cat)

# rate_limits is only present for Pro/Max subscribers (or a spend-limited gateway), and only
# after the session's first API response — `// empty` makes jq print nothing rather than "null"
# when it's absent, per code.claude.com/docs/en/statusline's own example.
FIVE_H=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
WEEK=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')

LINE=""
[ -n "$FIVE_H" ] && LINE="5h: $(printf '%.0f' "$FIVE_H")%"
[ -n "$WEEK" ] && LINE="${LINE}${LINE:+ · }7d: $(printf '%.0f' "$WEEK")%"

CACHE="$HOME/.cache/claudereset-forecast.json"
mkdir -p "$(dirname "$CACHE")" 2>/dev/null

# 10-minute local cache, judged by the cache file's own mtime (works with either BSD or GNU stat).
CACHE_AGE=999999
if [ -f "$CACHE" ]; then
  MTIME=$(stat -f %m "$CACHE" 2>/dev/null || stat -c %Y "$CACHE" 2>/dev/null || echo "")
  if [ -n "$MTIME" ]; then
    CACHE_AGE=$(( $(date +%s) - MTIME ))
  fi
fi

if [ "$CACHE_AGE" -ge 600 ]; then
  if curl -s -m 2 https://claudereset.org/api/v1/forecast.json -o "$CACHE.tmp" 2>/dev/null; then
    mv "$CACHE.tmp" "$CACHE" 2>/dev/null
  else
    rm -f "$CACHE.tmp" 2>/dev/null
  fi
fi

P24=$(jq -r '.p24 // empty' "$CACHE" 2>/dev/null)
if [ -n "$P24" ]; then
  LINE="${LINE}${LINE:+ · }reset odds 24h: ${P24}%"
fi

echo "$LINE"