garlicoin.org

API de données Garlicoin

Les chiffres derrière ce site sont libres d'utilisation dans vos propres bots, tableaux de bord et applis. Tout est en JSON simple, mis à jour automatiquement, sans clé nécessaire.

Endpoints

/status/status.jsonChaque minute

L'état actuel du réseau tel que le voit notre nœud.

  • height · hauteur de bloc
  • best_hash, best_time · hash du dernier bloc et son heure Unix
  • avg_block_seconds · temps de bloc moyen sur les avg_window derniers blocs
  • difficulty, hashrate · difficulté actuelle et hashrate estimé du réseau en H/s
  • mempool_txs, mempool_bytes · transactions non confirmées en attente
  • connections, version · notre nombre de pairs et version du nœud
  • peers · nœuds publics utilisables avec addnode=
  • health · si notre sommet de chaîne concorde avec nos pairs et avec grlc.eu : ok plus une liste de vérifications
  • generated · heure Unix d'écriture du fichier
/supply/supply.jsonChaque minute

L'offre de coins et le calendrier des halvings, d'après les règles de consensus.

  • issued, issued_pct, left_to_issue · coins créés jusqu'ici par les récompenses de bloc, sur max_supply
  • block_reward, next_block_reward · GRLC par bloc maintenant et après le prochain halving
  • next_halving_height, blocks_to_next_halving, next_halving_estimated_time · quand la récompense sera divisée par deux la prochaine fois (l'heure utilise le temps de bloc moyen de la dernière période de récompense, estimate_block_seconds)
  • coins_per_day, annual_inflation_pct · rythme d'émission actuel
  • schedule · chaque halving : hauteur, récompense et heure réelle ou estimée
/status/nodes.jsonToutes les 10 minutes

Nœuds publics auxquels notre nœud s'est connecté ces 30 derniers jours, comptés par pays. Aucune adresse.

  • nodes, listening · nœuds vus, et combien acceptent les connexions entrantes
  • countries[] · code, name, lat, lon (centre du pays) et nodes
  • generated, window_days · quand il a été écrit, et la fenêtre de comptage (30 jours)
  • since · quand le comptage a commencé (d'ici là, la fenêtre couvre moins de 30 jours)
  • unknown_country · nœuds dont le pays n'a pas pu être déterminé
  • Un nœud IPv6 compte une fois par réseau /64, car son adresse change à l'intérieur
  • geo_source · les pays proviennent de la base de données gratuite de DB-IP (CC BY 4.0)
/status/history.jsonToutes les 5 minutes

Les dernières 24 heures par tranches d'une heure, comme dans les graphiques d'état.

  • buckets[] · start, end, blocks, avg_block_seconds, hashrate, last_height
  • target_seconds · l'objectif de 40 secondes par bloc
/status/history_long.jsonToutes les heures

Les 7 derniers jours par tranches de 6 heures et les 30 derniers jours par tranches quotidiennes, alignés sur l'UTC.

  • ranges.7d, ranges.30d · bucket_seconds et buckets[], mêmes champs que history.json
/status/activity.jsonToutes les heures

Activité du réseau par jour UTC sur la dernière année, comptée à partir de chaque bloc à 6 de profondeur.

  • days[] · day, blocks, txs (sans compter les coinbases), sent (GRLC en sorties, monnaie rendue comprise), fees, bytes
  • all_time_txs · transactions depuis le lancement, sans compter les coinbases
  • counted_to_height · le dernier bloc compté
/mining/history.jsonToutes les heures

Blocs trouvés par pool et par jour UTC sur la dernière année, d'après les tags coinbase.

  • days[] · day, blocks, pools (nom : blocs)
  • pools[] · name et url quand ils sont connus
/status/uptime.jsonToutes les 5 minutes

Disponibilité de notre nœud, du nœud public (node.garlicoin.org), du faucet, du tipbot et des serveurs de portefeuilles légers (Electrum) communautaires.

  • generated, tracking_since, check_every_seconds · quand il a été écrit, quand le suivi a commencé, à quelle fréquence les services sont vérifiés
  • services[] · id (node, public-node, faucet, tipbot, electrum), name, up, since (début du suivi de ce service), uptime_7d, uptime_30d (tous deux au plus sur la durée écoulée depuis), planned_minutes_30d, days[] avec day, down_minutes et planned_minutes (null avant le début du suivi)
  • maintenance · la fenêtre de maintenance planifiée en cours (until, services, note), ou null
  • incidents[] · service, start, end (null tant que c'est en cours), minutes, planned (maintenance planifiée, non comptée dans les chiffres de disponibilité)
/mining/mining.jsonToutes les heures

Quels pools ont trouvé des blocs ces dernières 24 heures, d'après les tags de chaque bloc.

  • pools[] · name, url (quand elle est connue), blocks, share_pct, last_height
  • blocks · blocs dans la fenêtre
  • window_seconds · durée de la fenêtre
/price/price.jsonToutes les 10 minutes

Prix du GRLC directement depuis la plateforme : la dernière transaction GRLC/BTC sur FreiExchange multipliée par le prix BTC/USD de Coinbase. Le GRLC s'échange rarement, donc vérifiez source_updated pour voir quand a eu lieu le dernier échange.

  • usd, btc, sats · prix de 1 GRLC
  • bid_sats, ask_sats · meilleures offres d'achat et de vente sur GRLC/BTC
  • usd_market_cap, usd_24h_volume, usd_24h_change_pct · chiffres du marché (null si inconnus)
  • source_updated · heure Unix de la dernière transaction GRLC/BTC
/market/market.jsonToutes les 10 minutes

Les deux marchés GRLC (GRLC/BTC sur FreiExchange, GRLC/LTC sur FreiXLite), tels qu'affichés sur la page du marché.

  • markets[].last, bid, ask, spread_pct · prix par GRLC en BTC ou LTC
  • markets[].bids, asks · le carnet d'ordres complet sous la forme [prix, GRLC], les meilleurs en premier
  • markets[].recent_trades · les 30 dernières transactions : t, side, price, grlc, quote
  • markets[].volume_24h_grlc, trades_24h, quote_usd · chiffres sur 24 heures et le prix en USD de la monnaie de cotation
/market/history.jsonToutes les 10 minutes

Prix quotidiens issus de chaque transaction que nous avons vue. FreiExchange ne fournit que les 100 dernières transactions, donc l'historique remonte à novembre 2025 pour GRLC/LTC et à octobre 2026 pour GRLC/BTC, et s'enrichit à partir de maintenant.

  • days[].day · date UTC
  • days[].BTC, days[].LTC · open, high, low, close (par GRLC), trades, grlc et quote échangés ; les jours sans transaction reprennent la clôture précédente
/api/badge/<name>.svgChaque minute

Badges SVG en direct pour les README, dans le style de shields.io. Servis avec un cache de 5 minutes. Affichent "unknown" si nos données ne sont plus à jour.

  • height, hashrate, blocktime · depuis status.json
  • halving, supply · jours avant le prochain halving, part des 69M minée
  • price · prix en USD (voir price.json)
/status/peers.txtChaque minute

Lignes addnode= prêtes à coller dans garlicoin.conf. Texte brut.

/tipbot/stats.jsonToutes les 10 minutes

Totaux depuis le début pour le tipbot Reddit. Aucun utilisateur ni solde individuel.

  • tips, tipped · nombre de pourboires et GRLC donnés en pourboires
  • tippers, recipients, accounts, withdrawals · décomptes

Utilisation

  • Tous les fichiers sont statiques et servis depuis https://garlicoin.org. Pas de clé ni d'inscription.
  • Les requêtes cross-origin sont autorisées, vous pouvez donc utiliser fetch() pour les récupérer depuis n'importe quelle page web.
  • Chaque fichier indique quand il a été écrit dans generated. Interroger plus souvent que l'intervalle de mise à jour renvoie simplement les mêmes données.
  • Les heures sont en secondes Unix (UTC). Les montants sont en GRLC.

Exemples

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

Besoin de plus ?

Pour les transactions, adresses et blocs, utilisez l'API de l'explorateur grlc.eu. Des idées de données à ajouter ? Demandez sur le Discord.