API pública gratuita para o NHCI Score - NeverHodl Cycle Intelligence. Índice de ciclo Bitcoin em tempo real de 0 a 100, atualizado a cada hora. Sem API key necessária para o 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 são completamente públicos, com CORS aberto e limitados a 20 requisições por minuto por IP. Sem registro necessário.
Retorna o BTC NHCI Score atual, Crypto NHCI Score e dados de mercado ao vivo. Atualizado a cada hora.
| Campo | Tipo | Descrição |
|---|---|---|
| score | number | NHCI Score 0-100. 1 casa decimal. |
| phase | string | Fundo · Acumulação · Alta Ativa · Zona Quente · NeverHodl™ |
| phase_key | string | Fase legível por máquina: FONDO · ACUM · BULL · HOT · NEVERHODL |
| signal | string | ACCUMULATE · HOLD · CAUTION · REDUCE |
| context.descent_guard | string|null | Ativo se padrão de descida de mercado em baixa detectado. Null caso contrário. |
| context.top_risk | string|null | Ativo se distribuição de topo de ciclo detectada. Null caso contrário. |
| updated_at | ISO 8601 | Timestamp do último cálculo do motor. |
| stale | boolean | True se o score tem mais de 2 horas. |
Retorna os últimos 30 dias do BTC NHCI Score diário. Inclui score bruto, score suavizado EMA, fase e preço BTC no momento do cálculo. Atualizado diariamente às 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()
Coloque o widget NHCI em qualquer lugar - blog, Notion, portfolio tracker, dashboard crypto. Obtém dados automaticamente. Sem API key. Sem backend. Atribuição obrigatória incluída.
<script src="https://www.neverhodl.com/embed/nhci-chart.js"></script> <div id="nhci-widget" data-asset="btc"></div>
| Atributo | Padrão | Descrição |
|---|---|---|
| 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. |
Sem gráfico, sem dependência de Chart.js. Carrega instantaneamente em qualquer dispositivo. Perfeito para mini-apps do Telegram, blogs mobile ou barras laterais estreitas.
<script src="https://www.neverhodl.com/embed/nhci-badge.js"></script> <div data-nhci-badge data-asset="btc"></div>
| data-size | Largura máx. | Caso de uso |
|---|---|---|
| sm | 220px | Barra lateral estreita, card Telegram |
| (default) | 320px | Blog post mobile, coluna de widgets |
| lg | 400px | Barra lateral desktop, newsletter |
Sem JavaScript na sua página. Funciona no Notion, Substack, WordPress ou qualquer plataforma que suporte iframes. Autocontido, atualiza a cada 5 minutos.
<iframe src="https://www.neverhodl.com/embed/nhci" width="300" height="180" frameborder="0" style="border-radius:12px"></iframe>
Histórico NHCI completo desde 2017, API keys pessoais e limites mais altos. Entre na lista de espera.
| Tier | Limite | Headers |
|---|---|---|
| Público (sem auth) | 20 requisições / minuto por IP | - |
| API Pro (em breve) | Limites mais altos com key | X-NHCI-API-Key: nh_live_… |
When rate limited, you receive HTTP 429. Back off with exponential retry.
Se você exibir ou publicar dados do NHCI Score, a atribuição é obrigatória:
NHCI Score by NeverHodl™ - neverhodl.com
BTC price sourced from Kraken · Fear & Greed from Alternative.me · BTC Dominance from CoinGecko. See full attribution page.