garlicoin.org

API de datos de Garlicoin

Los números que hay detrás de este sitio se pueden usar gratis en tus propios bots, paneles y apps. Todo es JSON simple, se actualiza automáticamente y no hace falta ninguna clave.

Endpoints

/status/status.jsonCada minuto

El estado actual de la red tal como lo ve nuestro nodo.

  • height · altura de bloque
  • best_hash, best_time · hash del último bloque y su hora Unix
  • avg_block_seconds · tiempo medio por bloque en los últimos avg_window bloques
  • difficulty, hashrate · dificultad actual y hashrate estimado de la red en H/s
  • mempool_txs, mempool_bytes · transacciones sin confirmar en espera
  • connections, version · nuestro número de peers y versión del nodo
  • peers · nodos públicos que puedes usar con addnode=
  • health · si nuestra punta de cadena coincide con nuestros peers y con grlc.eu: ok más una lista de comprobaciones
  • generated · hora Unix en que se escribió el archivo
/supply/supply.jsonCada minuto

El suministro de monedas y el calendario de halvings, según las reglas de consenso.

  • issued, issued_pct, left_to_issue · monedas creadas hasta ahora por recompensas de bloque, de max_supply
  • block_reward, next_block_reward · GRLC por bloque ahora y tras el próximo halving
  • next_halving_height, blocks_to_next_halving, next_halving_estimated_time · cuándo se reduce a la mitad la recompensa la próxima vez (la hora usa el tiempo medio por bloque del último periodo de recompensa, estimate_block_seconds)
  • coins_per_day, annual_inflation_pct · ritmo de emisión actual
  • schedule · cada halving: altura, recompensa y la hora real o estimada
/status/nodes.jsonCada 10 minutos

Nodos públicos a los que se ha conectado nuestro nodo en los últimos 30 días, contados por país. Sin direcciones.

  • nodes, listening · nodos vistos y cuántos aceptan conexiones entrantes
  • countries[] · code, name, lat, lon (centro del país) y nodes
  • generated, window_days · cuándo se escribió y la ventana de recuento (30 días)
  • since · cuándo empezó el recuento (hasta entonces la ventana cubre menos de 30 días)
  • unknown_country · nodos cuyo país no se pudo averiguar
  • Un nodo IPv6 cuenta una vez por red /64, ya que su dirección cambia dentro de ella
  • geo_source · los países salen de la base de datos gratuita de DB-IP (CC BY 4.0)
/status/history.jsonCada 5 minutos

Las últimas 24 horas en tramos de una hora, como las usan los gráficos de estado.

  • buckets[] · start, end, blocks, avg_block_seconds, hashrate, last_height
  • target_seconds · el objetivo de 40 segundos por bloque
/status/history_long.jsonCada hora

Los últimos 7 días en tramos de 6 horas y los últimos 30 días en tramos diarios, alineados con UTC.

  • ranges.7d, ranges.30d · bucket_seconds y buckets[], mismos campos que history.json
/status/activity.jsonCada hora

Actividad de la red por día UTC durante el último año, contada desde cada bloque con 6 de profundidad.

  • days[] · day, blocks, txs (sin contar coinbases), sent (GRLC en salidas, cambio incluido), fees, bytes
  • all_time_txs · transacciones desde el lanzamiento, sin contar coinbases
  • counted_to_height · el último bloque contado
/mining/history.jsonCada hora

Bloques encontrados por pool y por día UTC durante el último año, según las etiquetas de coinbase.

  • days[] · day, blocks, pools (nombre: bloques)
  • pools[] · name y url cuando se conocen
/status/uptime.jsonCada 5 minutos

Disponibilidad de nuestro nodo, el nodo público (node.garlicoin.org), el faucet, el tipbot y los servidores de wallets ligeras (Electrum) de la comunidad.

  • generated, tracking_since, check_every_seconds · cuándo se escribió, cuándo empezó el seguimiento, cada cuánto se comprueban los servicios
  • services[] · id (node, public-node, faucet, tipbot, electrum), name, up, since (cuándo empezó el seguimiento de este servicio), uptime_7d, uptime_30d (ambos como mucho sobre el tiempo transcurrido desde entonces), planned_minutes_30d, days[] con day, down_minutes y planned_minutes (null antes de empezar el seguimiento)
  • maintenance · la ventana de mantenimiento programado en curso (until, services, note), o null
  • incidents[] · service, start, end (null mientras dura), minutes, planned (mantenimiento programado, no se cuenta en las cifras de disponibilidad)
/mining/mining.jsonCada hora

Qué pools encontraron bloques en las últimas 24 horas, según las etiquetas de cada bloque.

  • pools[] · name, url (cuando se conoce), blocks, share_pct, last_height
  • blocks · bloques en la ventana
  • window_seconds · duración de la ventana
/price/price.jsonCada 10 minutos

Precio de GRLC directo del exchange: la última operación GRLC/BTC en FreiExchange multiplicada por el precio BTC/USD de Coinbase. GRLC se negocia poco, así que mira source_updated para ver cuándo fue la última operación.

  • usd, btc, sats · precio de 1 GRLC
  • bid_sats, ask_sats · mejores ofertas de compra y venta en GRLC/BTC
  • usd_market_cap, usd_24h_volume, usd_24h_change_pct · cifras de mercado (null cuando no se conocen)
  • source_updated · hora Unix de la última operación GRLC/BTC
/market/market.jsonCada 10 minutos

Los dos mercados de GRLC (GRLC/BTC en FreiExchange, GRLC/LTC en FreiXLite), tal como aparecen en la página del mercado.

  • markets[].last, bid, ask, spread_pct · precios por GRLC en BTC o LTC
  • markets[].bids, asks · el libro de órdenes completo como [precio, GRLC], los mejores primero
  • markets[].recent_trades · las últimas 30 operaciones: t, side, price, grlc, quote
  • markets[].volume_24h_grlc, trades_24h, quote_usd · cifras de 24 horas y el precio en USD de la moneda de cotización
/market/history.jsonCada 10 minutos

Precios diarios a partir de cada operación que hemos visto. FreiExchange solo informa de las últimas 100 operaciones, así que esto llega hasta noviembre de 2025 para GRLC/LTC y hasta octubre de 2026 para GRLC/BTC, y crece a partir de ahora.

  • days[].day · fecha UTC
  • days[].BTC, days[].LTC · open, high, low, close (por GRLC), trades, grlc y quote negociados; los días sin operaciones arrastran el cierre anterior
/api/badge/<name>.svgCada minuto

Insignias SVG en directo para README, al estilo de shields.io. Se sirven con una caché de 5 minutos. Muestran "unknown" si nuestros datos se quedan desactualizados.

  • height, hashrate, blocktime · de status.json
  • halving, supply · días hasta el próximo halving, parte de los 69M minada
  • price · precio en USD (ver price.json)
/status/peers.txtCada minuto

Líneas addnode= listas para pegar en garlicoin.conf. Texto plano.

/tipbot/stats.jsonCada 10 minutos

Totales históricos del tipbot de Reddit. Sin usuarios ni saldos individuales.

  • tips, tipped · número de propinas y GRLC dados en propinas
  • tippers, recipients, accounts, withdrawals · recuentos

Cómo usarla

  • Todos los archivos son estáticos y se sirven desde https://garlicoin.org. Sin clave ni registro.
  • Se permiten las solicitudes entre orígenes, así que puedes usar fetch() con ellos desde cualquier página web.
  • Cada archivo indica cuándo se escribió en generated. Consultar más a menudo que el intervalo de actualización solo devuelve los mismos datos.
  • Las horas van en segundos Unix (UTC). Las cantidades, en GRLC.

Ejemplos

curl -s https://garlicoin.org/status/status.json | jq .height
fetch('https://garlicoin.org/supply/supply.json')
  .then(r => r.json())
  .then(s => console.log(s.blocks_to_next_halving))

¿Necesitas más?

Para transacciones, direcciones y bloques, usa la API del explorador grlc.eu. ¿Ideas de datos que deberíamos añadir? Pregunta en el Discord.