garlicoin.org

Garlicoin data API

The numbers behind this site as plain JSON, free for bots, dashboards and apps. No key needed.

Endpoints

/status/status.jsonEvery minute

Network state as seen by our node.

Fields
  • height · block height
  • best_hash, best_time · latest block hash and its Unix time
  • avg_block_seconds · average block time over the last avg_window blocks
  • difficulty, hashrate · current difficulty and estimated network hashrate in H/s
  • mempool_txs, mempool_bytes · unconfirmed transactions waiting
  • connections, version · our peer count and node version
  • peers · public nodes you can use with addnode=
  • health · whether our tip agrees with our peers and with grlc.eu: ok plus a list of checks
  • generated · Unix time the file was written
/supply/supply.jsonEvery minute

Coin supply and the halving schedule.

Fields
  • issued, issued_pct, left_to_issue · coins created by block rewards so far, of max_supply
  • block_reward, next_block_reward · GRLC per block now and after the next halving
  • next_halving_height, blocks_to_next_halving, next_halving_estimated_time · when the reward halves next (time uses the last reward period's average block time, estimate_block_seconds)
  • coins_per_day, annual_inflation_pct · current issuance rate
  • schedule · every halving: height, reward and the actual or estimated time
/status/nodes.jsonEvery 10 minutes

Public nodes we connected to in the last 30 days, by country. No addresses.

Fields
  • nodes, listening · nodes seen, and how many accept incoming connections
  • countries[] · code, name, lat, lon (country centre) and nodes
  • generated, window_days · when it was written, and the counting window (30 days)
  • since · when counting started (the window covers less than 30 days until then)
  • unknown_country · nodes whose country couldn't be looked up
  • An IPv6 node counts once per /64 network, since its address changes inside it
  • geo_source · countries are from DB-IP's free database (CC BY 4.0)
/status/history.jsonEvery 5 minutes

The last 24 hours in hourly buckets.

Fields
  • buckets[] · start, end, blocks, avg_block_seconds, hashrate, last_height
  • target_seconds · the 40-second block target
/status/history_long.jsonHourly

The last 7 days in 6-hour buckets and 30 days in daily buckets (UTC).

Fields
  • ranges.7d, ranges.30d · bucket_seconds and buckets[], same fields as history.json
/status/activity.jsonHourly

Network activity per UTC day for the last year, from blocks 6 deep.

Fields
  • days[] · day, blocks, txs (not counting coinbases), sent (GRLC in outputs, change included), fees, bytes
  • all_time_txs · transactions since launch, not counting coinbases
  • counted_to_height · the last block counted
/mining/history.jsonHourly

Blocks found per pool per UTC day for the last year, from coinbase tags.

Fields
  • days[] · day, blocks, pools (name: blocks)
  • pools[] · name and url when known
/rich/rich.jsonHourly

The rich list: the top 100 addresses, how coins are spread, and sleeping giants (unmoved for 2+ years).

Fields
  • height, supply, holders · the block it was counted at, GRLC in unspent coins, addresses holding any
  • top[] · address, balance, coins, first, last_in, last_out (unix times), label (only our own addresses and garlic names)
  • distribution[] · min (GRLC), addresses, amount; top10_share, top100_share
  • giants[] · address, balance, since (asleep since), spent_ever; asleep · GRLC not moved for 1, 2, 3 and 5 years
/rich/wakeups.jsonEvery minute

Recent spends of coins at least a year old, once 6 blocks deep.

Fields
  • events[] · h (block), t (block time), txid, address, amount, coins, since (time of the oldest coin), days (its age)
/status/uptime.jsonEvery 5 minutes

Uptime of our node, the public node (node.garlicoin.org), the faucet, the tipbot and the community Electrum servers.

Fields
  • generated, tracking_since, check_every_seconds · when it was written, when tracking began, how often services are checked
  • services[] · id (node, public-node, faucet, tipbot, electrum), name, up, since (when this service's tracking began), uptime_7d, uptime_30d (both over at most the time since then), planned_minutes_30d, days[] with day, down_minutes and planned_minutes (null before tracking began)
  • maintenance · the planned maintenance window right now (until, services, note), or null
  • incidents[] · service, start, end (null while ongoing), minutes, planned (planned maintenance, not counted in the uptime figures)
/mining/mining.jsonHourly

Blocks per pool in the last 24 hours, from coinbase tags.

Fields
  • pools[] · name, url (when known), blocks, share_pct, last_height
  • blocks · blocks in the window
  • window_seconds · length of the window
/price/price.jsonEvery 10 minutes

The last GRLC/BTC trade on FreiExchange times Coinbase's BTC/USD. GRLC trades rarely: see source_updated.

Fields
  • usd, btc, sats · price of 1 GRLC
  • bid_sats, ask_sats · best buy and sell offers on GRLC/BTC
  • usd_market_cap, usd_24h_volume, usd_24h_change_pct · market figures (null when unknown)
  • source_updated · Unix time of the last GRLC/BTC trade
/market/market.jsonEvery 10 minutes

Both GRLC markets (GRLC/BTC on FreiExchange, GRLC/LTC on FreiXLite), as shown on the market page.

Fields
  • markets[].last, bid, ask, spread_pct · prices per GRLC in BTC or LTC
  • markets[].bids, asks · the full order book as [price, GRLC], best first
  • markets[].recent_trades · the last 30 trades: t, side, price, grlc, quote
  • markets[].volume_24h_grlc, trades_24h, quote_usd · 24-hour figures and the quote coin's USD price
/market/history.jsonEvery 10 minutes

Daily prices from every trade we've seen, back to November 2025 (GRLC/LTC) and October 2026 (GRLC/BTC).

Fields
  • days[].day · UTC date
  • days[].BTC, days[].LTC · open, high, low, close (per GRLC), trades, grlc and quote traded; days with no trades carry the close forward
/api/badge/<name>.svgEvery minute

Live SVG badges for READMEs, cached for 5 minutes. Shows "unknown" if our data goes stale.

Fields
  • height, hashrate, blocktime · from status.json
  • halving, supply · days to the next halving, share of the 69M mined
  • price · USD price (see price.json)
/status/peers.txtEvery minute

Ready-to-paste addnode= lines for garlicoin.conf. Plain text.

/tipbot/stats.jsonEvery 10 minutes

All-time totals for the Reddit tipbot. No individual users or balances.

Fields
  • tips, tipped · number of tips and GRLC tipped
  • tippers, recipients, accounts, withdrawals · counts

Using it

  • Static files on https://garlicoin.org, open to cross-origin fetch().
  • Each file says when it was written in generated. Polling faster than the update interval returns the same data.
  • Times are Unix seconds (UTC). Amounts are in GRLC.

Examples

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

Need more?

For transactions, addresses and blocks, use the grlc.eu explorer API.