garlicoin.org

API de dados do Garlicoin

Os números por trás deste site podem ser usados de graça nos seus próprios bots, painéis e apps. Tudo é JSON simples, atualizado automaticamente, sem precisar de chave.

Endpoints

/status/status.jsonA cada minuto

O estado atual da rede, como o nosso nó o vê.

  • height · altura do bloco
  • best_hash, best_time · hash do bloco mais recente e seu horário Unix
  • avg_block_seconds · tempo médio de bloco nos últimos avg_window blocos
  • difficulty, hashrate · dificuldade atual e hashrate estimado da rede em H/s
  • mempool_txs, mempool_bytes · transações não confirmadas aguardando
  • connections, version · nosso número de peers e versão do nó
  • peers · nós públicos que você pode usar com addnode=
  • health · se a nossa ponta da cadeia concorda com os nossos peers e com o grlc.eu: ok mais uma lista de verificações
  • generated · horário Unix em que o arquivo foi gravado
/supply/supply.jsonA cada minuto

O suprimento de moedas e o calendário de halvings, a partir das regras de consenso.

  • issued, issued_pct, left_to_issue · moedas criadas até agora por recompensas de bloco, de max_supply
  • block_reward, next_block_reward · GRLC por bloco agora e depois do próximo halving
  • next_halving_height, blocks_to_next_halving, next_halving_estimated_time · quando a recompensa cai pela metade da próxima vez (o horário usa o tempo médio de bloco do último período de recompensa, estimate_block_seconds)
  • coins_per_day, annual_inflation_pct · taxa de emissão atual
  • schedule · cada halving: altura, recompensa e o horário real ou estimado
/status/nodes.jsonA cada 10 minutos

Nós públicos aos quais o nosso nó se conectou nos últimos 30 dias, contados por país. Sem endereços.

  • nodes, listening · nós vistos e quantos aceitam conexões de entrada
  • countries[] · code, name, lat, lon (centro do país) e nodes
  • generated, window_days · quando foi gravado e a janela de contagem (30 dias)
  • since · quando a contagem começou (até lá a janela cobre menos de 30 dias)
  • unknown_country · nós cujo país não pôde ser identificado
  • Um nó IPv6 conta uma vez por rede /64, já que o endereço dele muda dentro dela
  • geo_source · os países vêm do banco de dados gratuito da DB-IP (CC BY 4.0)
/status/history.jsonA cada 5 minutos

As últimas 24 horas em intervalos de uma hora, como usado nos gráficos de status.

  • buckets[] · start, end, blocks, avg_block_seconds, hashrate, last_height
  • target_seconds · a meta de 40 segundos por bloco

Os últimos 7 dias em intervalos de 6 horas e os últimos 30 dias em intervalos diários, alinhados ao UTC.

  • ranges.7d, ranges.30d · bucket_seconds e buckets[], mesmos campos que history.json

Atividade da rede por dia UTC no último ano, contada a partir de cada bloco com 6 de profundidade.

  • days[] · day, blocks, txs (sem contar coinbases), sent (GRLC em saídas, troco incluído), fees, bytes
  • all_time_txs · transações desde o lançamento, sem contar coinbases
  • counted_to_height · o último bloco contado

Blocos encontrados por pool por dia UTC no último ano, a partir das tags da coinbase.

  • days[] · day, blocks, pools (nome: blocos)
  • pools[] · name e url quando conhecidos
/status/uptime.jsonA cada 5 minutos

Disponibilidade do nosso nó, do nó público (node.garlicoin.org), do faucet, do tipbot e dos servidores de carteiras leves (Electrum) da comunidade.

  • generated, tracking_since, check_every_seconds · quando foi gravado, quando o monitoramento começou, com que frequência os serviços são verificados
  • services[] · id (node, public-node, faucet, tipbot, electrum), name, up, since (quando o monitoramento deste serviço começou), uptime_7d, uptime_30d (ambos no máximo sobre o tempo desde então), planned_minutes_30d, days[] com day, down_minutes e planned_minutes (null antes do início do monitoramento)
  • maintenance · a janela de manutenção planejada em andamento (until, services, note), ou null
  • incidents[] · service, start, end (null enquanto em andamento), minutes, planned (manutenção planejada, não contada nos números de disponibilidade)

Quais pools encontraram blocos nas últimas 24 horas, a partir das tags de cada bloco.

  • pools[] · name, url (quando conhecida), blocks, share_pct, last_height
  • blocks · blocos na janela
  • window_seconds · duração da janela
/price/price.jsonA cada 10 minutos

Preço do GRLC direto da exchange: a última negociação GRLC/BTC na FreiExchange vezes o preço BTC/USD da Coinbase. O GRLC é pouco negociado, então confira source_updated para ver quando foi a última negociação.

  • usd, btc, sats · preço de 1 GRLC
  • bid_sats, ask_sats · melhores ofertas de compra e venda em GRLC/BTC
  • usd_market_cap, usd_24h_volume, usd_24h_change_pct · números de mercado (null quando desconhecidos)
  • source_updated · horário Unix da última negociação GRLC/BTC
/market/market.jsonA cada 10 minutos

Os dois mercados de GRLC (GRLC/BTC na FreiExchange, GRLC/LTC na FreiXLite), como mostrado na página do mercado.

  • markets[].last, bid, ask, spread_pct · preços por GRLC em BTC ou LTC
  • markets[].bids, asks · o livro de ofertas completo como [preço, GRLC], os melhores primeiro
  • markets[].recent_trades · as últimas 30 negociações: t, side, price, grlc, quote
  • markets[].volume_24h_grlc, trades_24h, quote_usd · números de 24 horas e o preço em USD da moeda de cotação
/market/history.jsonA cada 10 minutos

Preços diários de todas as negociações que vimos. A FreiExchange só informa as últimas 100 negociações, então isto vai até novembro de 2025 para GRLC/LTC e até outubro de 2026 para GRLC/BTC, e cresce daqui em diante.

  • days[].day · data UTC
  • days[].BTC, days[].LTC · open, high, low, close (por GRLC), trades, grlc e quote negociados; dias sem negociações repetem o fechamento anterior

Badges SVG ao vivo para READMEs, no estilo do shields.io. Servidos com cache de 5 minutos. Mostram "unknown" se os nossos dados ficarem desatualizados.

  • height, hashrate, blocktime · de status.json
  • halving, supply · dias até o próximo halving, parte dos 69M minerada
  • price · preço em USD (veja price.json)
/status/peers.txtA cada minuto

Linhas addnode= prontas para colar no garlicoin.conf. Texto puro.

/tipbot/stats.jsonA cada 10 minutos

Totais históricos do tipbot do Reddit. Sem usuários ou saldos individuais.

  • tips, tipped · número de gorjetas e GRLC dados em gorjetas
  • tippers, recipients, accounts, withdrawals · contagens

Como usar

  • Todos os arquivos são estáticos e servidos a partir de https://garlicoin.org. Sem chave nem cadastro.
  • Requisições cross-origin são permitidas, então você pode usar fetch() com eles em qualquer página web.
  • Cada arquivo informa quando foi gravado em generated. Consultar com mais frequência que o intervalo de atualização só retorna os mesmos dados.
  • Os horários estão em segundos Unix (UTC). Os valores estão em GRLC.

Exemplos

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))

Precisa de mais?

Para transações, endereços e blocos, use a API do explorador grlc.eu. Ideias de dados que deveríamos adicionar? Fale no Discord.