API pública gratuita para el NHCI Score - NeverHodl Cycle Intelligence. Índice de ciclo Bitcoin en tiempo real de 0 a 100, actualizado cada hora. Sin API key necesaria para el tier público.
curl https://www.neverhodl.com/api/public/nhci
{
"ok": true,
"btc": {
"score": 56.4, // 0-100 cycle index
"phase": "Bull Active",
"signal": "HOLD", // ACCUMULATE | HOLD | CAUTION | REDUCE
"updated_at":"2026-05-13T06:00:00Z"
},
"crypto": { "score": 52.1, "phase": "Bull Active" },
"market": {
"btc_price_usd": 98420,
"btc_dominance_pct":57.3,
"fear_greed": { "value": 62, "classification": "Greed" }
}
}Ambos endpoints son completamente públicos, con CORS abierto y limitados a 20 peticiones por minuto por IP. Sin registro necesario.
Devuelve el BTC NHCI Score actual, Crypto NHCI Score y datos de mercado en vivo. Actualizado cada hora.
| Campo | Tipo | Descripción |
|---|---|---|
| score | number | NHCI Score 0-100. 1 decimal. |
| phase | string | Fondo · Acumulación · Alcista Activo · Zona Caliente · NeverHodl™ |
| phase_key | string | Fase legible por máquina: FONDO · ACUM · BULL · HOT · NEVERHODL |
| signal | string | ACCUMULATE · HOLD · CAUTION · REDUCE |
| context.descent_guard | string|null | Activo si se detecta patrón de descenso de mercado bajista. Null en caso contrario. |
| context.top_risk | string|null | Activo si se detecta distribución de techo de ciclo. Null en caso contrario. |
| updated_at | ISO 8601 | Marca temporal del último cálculo del motor. |
| stale | boolean | True si el score tiene más de 2 horas. |
Devuelve los últimos 30 días del BTC NHCI Score diario. Incluye score bruto, score suavizado EMA, fase y precio BTC al momento del cálculo. Actualizado diariamente a las 06:00 UTC.
curl https://www.neverhodl.com/api/public/nhci/history
{
"ok": true,
"asset": "BTC",
"days": 30,
"data": [
{
"date": "2026-04-13",
"score": 48.2, // raw daily NHCI score
"score_smoothed": 49.1, // EMA-smoothed (reduces noise)
"phase": "Bull Active",
"phase_key": "BULL",
"btc_price_usd": 84200
},
// ... 29 more rows, oldest → newest
]
}// Live score - no API key needed const res = await fetch('https://www.neverhodl.com/api/public/nhci'); const { btc, market } = await res.json(); console.log(`Score: ${btc.score} | Phase: ${btc.phase} | BTC: $${market.btc_price_usd}`); // → "Score: 56.4 | Phase: Bull Active | BTC: $98420" // Alert example if (btc.signal === 'REDUCE') { sendAlert('⚠️ NeverHodl™ zone - reduce exposure'); }
import requests r = requests.get('https://www.neverhodl.com/api/public/nhci') data = r.json() print(f"NHCI: {data['btc']['score']} - {data['btc']['phase']}") print(f"BTC: ${data['market']['btc_price_usd']:,}")
import requests import matplotlib.pyplot as plt r = requests.get('https://www.neverhodl.com/api/public/nhci/history') hist = r.json()['data'] dates = [d['date'] for d in hist] scores = [d['score'] for d in hist] plt.plot(dates, scores) plt.title('BTC NHCI Score - last 30 days') plt.axhline(75, color='red', linestyle='--', label='NeverHodl zone') plt.axhline(35, color='blue', linestyle='--', label='Bottom zone') plt.legend() plt.show()
Coloca el widget NHCI en cualquier lugar - blog, Notion, portfolio tracker, dashboard crypto. Obtiene datos automáticamente. Sin API key. Sin backend. Atribución obligatoria incluida.
<script src="https://www.neverhodl.com/embed/nhci-chart.js"></script> <div id="nhci-widget" data-asset="btc"></div>
| Atributo | Predeterminado | Descripción |
|---|---|---|
| data-asset | "btc" | Asset to display. Use "btc" for Bitcoin NHCI Score. Crypto NHCI coming soon. |
| id / data-nhci-widget | - | Use id="nhci-widget" for a single widget, or data-nhci-widget on multiple elements. |
Sin gráfico, sin dependencia de Chart.js. Carga al instante en cualquier dispositivo. Perfecto para mini-apps de Telegram, blogs móviles o barras laterales angostas.
<script src="https://www.neverhodl.com/embed/nhci-badge.js"></script> <div data-nhci-badge data-asset="btc"></div>
| data-size | Ancho máx. | Caso de uso |
|---|---|---|
| sm | 220px | Barra lateral angosta, tarjeta Telegram |
| (default) | 320px | Blog post móvil, columna de widgets |
| lg | 400px | Barra lateral desktop, newsletter |
Sin JavaScript en tu página. Funciona en Notion, Substack, WordPress o cualquier plataforma que soporte iframes. Autocontenido, se actualiza cada 5 minutos.
<iframe src="https://www.neverhodl.com/embed/nhci" width="300" height="180" frameborder="0" style="border-radius:12px"></iframe>
Historial NHCI completo desde 2017, API keys personales y límites más altos. Únete a la lista de espera.
| Tier | Límite | Headers |
|---|---|---|
| Público (sin auth) | 20 peticiones / minuto por IP | - |
| API Pro (próximamente) | Límites más altos con key | X-NHCI-API-Key: nh_live_… |
When rate limited, you receive HTTP 429. Back off with exponential retry.
Si muestras o publicas datos del NHCI Score, la atribución es obligatoria:
NHCI Score by NeverHodl™ - neverhodl.com
BTC price sourced from Kraken · Fear & Greed from Alternative.me · BTC Dominance from CoinGecko. See full attribution page.