garlicoin.org

Garlicoin data API

The numbers behind this site are free to use in your own bots, dashboards and apps. Everything is plain JSON, updated automatically, with no key needed.

Endpoints

/status/status.jsonEvery minute

The current state of the network as seen by our node.

  • 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, from the consensus rules.

  • 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 assumes 40-second blocks)
  • coins_per_day, annual_inflation_pct · current issuance rate
  • schedule · every halving: height, reward and the actual or estimated time
/status/history.jsonEvery 5 minutes

The last 24 hours in hourly buckets, as used by the status charts.

  • 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 the last 30 days in daily buckets, aligned to UTC.

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

Which pools found blocks in the last 24 hours, from the tags in each block.

  • 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

GRLC price from CoinGecko. GRLC trades rarely, so check source_updated before relying on it.

  • usd, btc · price of 1 GRLC
  • usd_market_cap, usd_24h_volume, usd_24h_change_pct · market figures (null when unknown)
  • source_updated · Unix time CoinGecko last updated the price
/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.

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

Using it

  • All files are static and served from https://garlicoin.org. No key or sign-up.
  • Cross-origin requests are allowed, so you can fetch() them from any web page.
  • Each file says when it was written in generated. Polling more often than the update interval just 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, the grlc.eu explorer API has you covered. Ideas for data we should add? Ask in the Discord.