US MIRROR (read-only) - main site: pyblock.xyz
--
iOS App 🤖 Android APK
be pybløck

🔌 PUBLIC API

Developer reference — every stratum, one base URL, no auth

Base URL
https://pyblock.xyz:8443/
Auth
none · public
Format
JSON
CORS
* (open)
Method
GET

Quick start

pick a stratum · same shape everywhere
# curl
curl -s "https://pyblock.xyz:8443/sv2_api.php?mode=pool"
// JavaScript
fetch('https://pyblock.xyz:8443/chirp_api.php?mode=pool')
  .then(r => r.json())
  .then(console.log)
# Python
import requests
requests.get('https://pyblock.xyz:8443/api.php?mode=pool').json()

Pools & stratums

6 endpoints
GET /api.php?mode=pool 🎰 LOTTO — solo pool (hashrate1m, Workers, bestshare, accepted/rejected)
GET /api.php?mode=datum 🌊 DATUM — OCEAN gateway (hashrate1m, Workers, earnings, unpaid)
GET /sv2_api.php?mode=pool 🔥 SV2 — Stratum V2 · anti-spam solo (hashrate, workers, blocks, bestdiff)
GET /chirp_api.php?mode=pool 🌌 CHIRP — weighted-lottery (hashrate, workers, candidates, bestdiff, floors)
GET /api.php?mode=tmpl 🎠 CAROUSEL — template-mining aggregate (hashrate, miners, suppliers, bestdiff)
GET /templates.php?carrousel=1 🎠 CAROUSEL live — miners, hashrate, recent supplier picks

Miners & workers

5 endpoints
GET /api.php?mode=workers 🎰 LOTTO active workers, keyed by address
GET /api/miner_stats.php?address={address} 🎰 LOTTO per-miner stats (workers, hashrate, bestshare)
GET /sv2_api.php?mode=workers 🔥 SV2 top miners (address, hashrate, workers, best_diff)
GET /sv2_api.php?mode=search&address={address} 🔥 SV2 miner by address (hashrate, workers)
GET /chirp_api.php?mode=dashboard 🌌 CHIRP miners — tenure, power, weight, eligibility

Blocks & network

3 endpoints
GET /api.php?mode=blocks Blocks found per stratum + the recent-blocks list
GET /api.php?mode=block_odds Block-finding odds per stratum (Poisson, from network difficulty)
GET /api/network_stats.php Bitcoin network — difficulty, height, network hashrate, mempool

History (for charts)

5 endpoints
GET /api.php?mode=history&range=1d 🎰 LOTTO hashrate history · range = 1d | 7d | 1m
GET /api.php?mode=datum_history&range=1d 🌊 DATUM hashrate history
GET /api.php?mode=sv2_history&range=1d 🔥 SV2 hashrate history
GET /api.php?mode=chirp_history&range=1d 🌌 CHIRP hashrate history
GET /api.php?mode=tmpl_history&range=1d 🎠 CAROUSEL hashrate history

Click any endpoint to open its live JSON · https://pyblock.xyz:8443/