API pública

Gratuita, sin clave, sin registro y con CORS abierto. Los datos de quema salen directamente de la cadena de bloques de Ethereum y son de dominio público.

Empezar

curl -s https://shibburn.live/api/v1/burn

const r = await fetch('https://shibburn.live/api/v1/burn');
const d = await r.json();

// Los importes vienen como cadena decimal, nunca como número: el saldo quemado
// tiene 18 decimales y no cabe en un double sin perder dígitos. Conviértelo
// sólo para mostrarlo, y usa BigInt si necesitas operar.
console.log(`Quemados: ${Number(d.burned_tokens).toLocaleString('es-ES')} SHIB`);
console.log(`Últimas 24 h: ${d.delta_24h}`);
console.log(`Verificado en dos RPC: ${d.verified}`);

if (d.stale) console.warn('El dato lleva sin actualizarse más de lo normal');

import requests
from decimal import Decimal

d = requests.get("https://shibburn.live/api/v1/burn", timeout=10).json()

# Decimal, no float: 49439783760.638623795389502569 pierde dígitos en un float.
quemado = Decimal(d["burned"])
print(f"Quemados: {quemado:,.0f} SHIB")
print(f"Porcentaje del suministro inicial: {d['percent_of_initial_supply']:.4f} %")

for s in d["sources"]:
    print(f"  {s['address']}: {s['burned']}")

Endpoints

GET /api/v1/burn

Total quemado, deltas, porcentaje del suministro, ritmo anualizado y el desglose por dirección. Es el endpoint principal.

{
  "burned": "49439783760.638623795389502569",
  "burned_tokens": 49439783760.63862,
  "percent_of_initial_supply": 0.004943978376063863,
  "delta_24h": "0",
  "delta_7d": "0",
  "delta_30d": "0",
  "annualized_rate": 0.0,
  "block": 25948508,
  "verified": true,
  "updated_at": 1789061591,
  "stale": false,
  "total_supply": "999982329055168.014311278372706779",
  "circulating": "999932889271407.375687482983204210",
  "sources": [
    { "address": "0x000...dead", "burned": "49439783760.63…", "explorer": "https://etherscan.io/…" }
  ]
}

GET /api/v1/burn/history?days=90

Serie histórica de quema acumulada. days entre 1 y 3650.

GET /api/v1/burn/top?limit=20

Mayores quemas individuales, con enlace al explorador. Devuelve también scanned_up_to_block: mientras el escaneo del histórico no termina, la lista es provisional, y conviene que tu integración lo diga igual que lo dice el panel.

GET /api/v1/price

Precio de SHIB en dólares y euros, con la variación de 24 h.

GET /api/v1/ecosystem

Cotizaciones de SHIB, BONE, LEASH y TREAT.

GET /api/v1/widget

Payload compacto con quema, precio y ecosistema en una sola respuesta. Es el que consume el widget, y no tiene cuota.

GET /api/v1/health

Estado del servicio, número de snapshots y cursor del escaneo.

Cuotas

Cada respuesta lleva X-RateLimit-Limit y X-RateLimit-Remaining. Al agotarse, devuelve 429.

Antes de subir el ritmo, comprueba si te hace falta: las respuestas se cachean 60 segundos y el dato de quema se actualiza cada cinco minutos. Pedirlo cada segundo devuelve la misma respuesta sesenta veces. Si tu caso necesita más, escríbenos: casi siempre hay una forma mejor de resolverlo que subir el número.

Cómo tratar los números

Los importes son cadenas decimales a propósito. El saldo quemado tiene 18 decimales y ronda 4,9 × 10²⁸ wei; en coma flotante de doble precisión se pierden dígitos, y en un DECIMAL(10,2) el precio de SHIB se guarda directamente como 0,00. Los campos que terminan en _tokens son float y existen sólo para pintar en pantalla: no los uses para contabilidad.

Fiabilidad

• verified: false significa que los dos proveedores de RPC no coincidieron. Muéstralo, no lo escondas.
• stale: true significa que el colector lleva sin actualizar más de tres intervalos. El dato sigue sirviéndose, con su marca de antigüedad.
• Un 503 significa que aún no hay ningún dato, no que el servicio esté roto.

Uso y atribución

Puedes usar la API en proyectos personales y comerciales. Se agradece —no se exige— un enlace a shibburn.live. El servicio se ofrece «tal cual», sin garantía de disponibilidad; los cambios que rompan compatibilidad se anunciarán con antelación. Condiciones completas en el aviso legal.