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 minutoO estado atual da rede, como o nosso nó o vê.
height· altura do blocobest_hash, best_time· hash do bloco mais recente e seu horário Unixavg_block_seconds· tempo médio de bloco nos últimos avg_window blocosdifficulty, hashrate· dificuldade atual e hashrate estimado da rede em H/smempool_txs, mempool_bytes· transações não confirmadas aguardandoconnections, 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çõesgenerated· horário Unix em que o arquivo foi gravado
/supply/supply.jsonA cada minutoO 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_supplyblock_reward, next_block_reward· GRLC por bloco agora e depois do próximo halvingnext_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 atualschedule· cada halving: altura, recompensa e o horário real ou estimado
/status/nodes.jsonA cada 10 minutosNó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 entradacountries[]· code, name, lat, lon (centro do país) e nodesgenerated, 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 minutosAs últimas 24 horas em intervalos de uma hora, como usado nos gráficos de status.
buckets[]· start, end, blocks, avg_block_seconds, hashrate, last_heighttarget_seconds· a meta de 40 segundos por bloco
/status/history_long.jsonA cada horaOs ú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
/status/activity.jsonA cada horaAtividade 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, bytesall_time_txs· transações desde o lançamento, sem contar coinbasescounted_to_height· o último bloco contado
/mining/history.jsonA cada horaBlocos 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 minutosDisponibilidade 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 verificadosservices[]· 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 nullincidents[]· service, start, end (null enquanto em andamento), minutes, planned (manutenção planejada, não contada nos números de disponibilidade)
/mining/mining.jsonA cada horaQuais pools encontraram blocos nas últimas 24 horas, a partir das tags de cada bloco.
pools[]· name, url (quando conhecida), blocks, share_pct, last_heightblocks· blocos na janelawindow_seconds· duração da janela
/price/price.jsonA cada 10 minutosPreç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 GRLCbid_sats, ask_sats· melhores ofertas de compra e venda em GRLC/BTCusd_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 minutosOs 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 LTCmarkets[].bids, asks· o livro de ofertas completo como [preço, GRLC], os melhores primeiromarkets[].recent_trades· as últimas 30 negociações: t, side, price, grlc, quotemarkets[].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 minutosPreç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 UTCdays[].BTC, days[].LTC· open, high, low, close (por GRLC), trades, grlc e quote negociados; dias sem negociações repetem o fechamento anterior
/api/badge/<name>.svgA cada minutoBadges 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.jsonhalving, supply· dias até o próximo halving, parte dos 69M mineradaprice· preço em USD (veja price.json)
/status/peers.txtA cada minutoLinhas addnode= prontas para colar no garlicoin.conf. Texto puro.
/tipbot/stats.jsonA cada 10 minutosTotais históricos do tipbot do Reddit. Sem usuários ou saldos individuais.
tips, tipped· número de gorjetas e GRLC dados em gorjetastippers, 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.