Mining Pool Directory & API Integration Guide
Authoritative technical specification and telemetry endpoints for mining aggregators, ranking directories, and monitoring engines (Hashrate.no, MiningBoard, MiningPoolStats, ASIC Miner Value, Minerstat, WhatToMine).
Truth-in-Advertising & Capability Demarcation
Our primary brand is Sentinel BTCB2 Pool. Our custom Stratum gateway speaks stock Sia-Stratum V1 protocol, allowing wire-compatible mining for Sia-class hardware while mining the Bitcoin BLAKE2b PoW chain.
Bitcoin BLAKE2b PoW chain mined with adaptive dynamic fee (0.00% baseline) and PPLNS-8D accounting. Immediate coinbase payouts upon 100-block maturity.
Hardware is protocol wire-compatible. Native Siacoin blockchain consensus daemon and payout pipeline are in active development ("Coming Soon").
📋 Quick Submission Cheat Sheet
⚡ Authoritative Canonical V1 API
Single unauthenticated source of truth for pool hashrate, miners, and network telemetry.
// Click "Fetch Live Response" to query the live API...V1 Schema Field Dictionary
| Field | Type | Unit / Format | Description |
|---|---|---|---|
| api_version | string | "1.0" | Semantic API version contract. |
| coin | string | "BTCB2" | Official ticker symbol. |
| algorithm | string | "BLAKE2b" | PoW hashing algorithm. |
| pool_hashrate_hs | number | H/s (raw) | Total aggregate pool hashrate derived from accepted window work (Stratum + DATUM). |
| pool_hashrate_formatted | string | e.g. "28.63 MH/s" | Human-readable scaled total pool hashrate. |
| stratum_hashrate_hs | number | H/s (raw) | Disaggregated Stratum SV1 pool hashrate from Easy Gateway. |
| stratum_hashrate_formatted | string | e.g. "1.72 MH/s" | Human-readable Stratum SV1 hashrate. |
| datum_hashrate_hs | number | H/s (raw) | Disaggregated DATUM V3 sovereign pool hashrate. |
| datum_hashrate_formatted | string | e.g. "0.00 H/s" | Human-readable DATUM V3 hashrate. |
| double_counting_prevented | boolean | true | Strict invariant: pool_hashrate_hs == stratum_hashrate_hs + datum_hashrate_hs. |
| network_difficulty | number | float | Live Bitcoin Knots consensus target difficulty from 30s canonical hub. |
| network_hashrate_hs | number | H/s (raw) | Global network hashrate derived from Knots 30-block statistical window. |
| timing | object | { expected_mean_block_interval_sec, semantic_type, ... } | Poisson inter-block mean arrival interval ($E[\Delta t] = \text{work}/\text{hashrate}$); explicitly not a countdown. |
| retarget | object | { projected_diff_change_pct, projected_next_difficulty, ... } | Consensus-clamped difficulty retarget projection derived from epoch start to tip timespan. |
| retarget_horizon | object | { remaining_blocks, estimated_retarget_hours, ... } | Blocks and estimated hours remaining in the current 2,016-block difficulty epoch. |
| economics | object | { btcb2_usd, btc_usd, daily_issuance_btcb2, ... } | NonKYC dual-market price oracle telemetry and issuance metrics. |
| calculator | object | { endpoint, method, docs } | Link to deterministic mining calculator API (/api/v1/calculator/mining). |
| hashrate_window_seconds | integer | seconds (600) | Rolling duration over which accepted shares are calculated. |
| active_miners | integer | count | Unique payout identities with accepted shares in current window. |
| active_workers | integer | count | Total active Stratum and DATUM worker connections across all gateways. |
| fee_percent | number | percent (0.00 - 16.00) | Active dynamic pool fee scaled continuously against network share. |
| pool_share_percent | number | percent (0.00 - 100.00) | Current pool share of total global network hashrate. |
| fee_info | object | { fee_percent, pool_share_percent, concentration_level, ... } | Detailed fee policy telemetry, concentration alert tier, and governance thresholds. |
| payout_scheme | string | "PPLNS-8D" | Accounting reward distribution model. |
| stratum | object | { host, port, url } | Primary public mining endpoint connection parameters. |
| network_height | integer | block height | Current blockchain consensus tip height. |
| last_updated | string | ISO-8601 UTC | Timestamp of telemetry generation (e.g. 2026-09-20T22:30:00Z). |
🔌 Directory Compatibility Adapters
Pre-formatted feeds tailored for specific directory scrapers. All adapters derive from the exact same live consensus state with zero delay.
⛏️ MiningBoard Feed
5-Min Scraper Spec
Conforms strictly to MiningBoard's schema: raw H/s in pool.hashrate, integer pool.miners, fee, payout scheme, min payout, and Stratum parameters.
📊 Hashrate.no Feed
CORS Unauthenticated
Conforms to Hashrate.no listing requirements: raw H/s hashrate, hashrate_formatted, unit, miners, fee, and full Stratum URL.
🩺 Health & Uptime Probe
Uptime Robot / Monitor
Ultra-fast HTTP 200 health check returning {"status": "ok", "coin": "BTCB2"} for directory pingers and automated uptime monitors.
🏷️ Directory Source Attribution
Privacy-Preserving
Append ?src=hashrate or ?src=miningpoolstats to dashboard links. Increments an aggregate counter with zero IP logging or tracking cookies.
🧮 Mining Revenue Calculator & Canonical Hub APIs
POST & GET /api/v1/calculator/mining⚡ Deterministic Mining Yield & Profit API
POST & GET
Pass {"hashrate_hs": 100e12, "power_watts": 1200, "electricity_cost_kwh": 0.05}. Returns deterministic daily/monthly BTCB2 yield, power cost, gross/net USD profits, and profitability status.
🌐 Canonical Telemetry Snapshot Mirror
GET (30s Cache)Immutable 30-second snapshot containing Bitcoin Knots consensus primitives, Poisson block timing, retarget horizon, and NonKYC dual price oracle state.
⚡ Hardware Support & Miner Self-Service APIs
v1.0 Specifications🖥️ Hardware Support Matrix
GETAuthoritative device compatibility statuses: CPU (Verified), GPU (Verified), FPGA (Compatible/Unverified), ASIC (Qualification in Progress).
📊 Miner Authoritative Summary
GETSegregated economic states: Historical Paid, Pending Payable, and Estimated PPLNS Window Share.
🧾 Paginated Share History
GETFull cursor-paginated work submissions with timestamps, assigned difficulty, state (accepted/rejected/stale), and block candidate flags.
🛡️ Worker Telemetry & Privacy Shield
GET / POST
Pseudonymized by default (Worker 1). Unmasked when passing header X-Privacy-Token: msec_... obtained via Stratum nonce challenge proof.
🧱 Recent Pool Blocks
GETList on-chain blocks discovered by Sentinel Pool with height, confirmations, maturity status, template source (Easy / Sentinel Template vs Sovereign / Farm DATUM Template), and payout output splits.
🏆 Pool Contributors & Hashrate Leaderboard
GET
Privacy-preserving contributor rankings weighted by difficulty work over windows 1h, 3h, 24h, and 8d. All contributor addresses are pseudonymized unless explicitly unlocked.
📡 Sovereign DATUM Protocol & Remote Farm Integration
Decentralized block template construction via local Bitcoin Knots RPC with PPLNS-8D pooled accounting.
Farm operators may build and propose their own custom block templates using an on-premise Bitcoin Knots node, bypassing pool-side transaction selection while pooling reward variance under our canonical PPLNS-8D window with dynamic anti-concentration fee governance.
{
"bitcoind": { "rpcurl": "http://127.0.0.1:8332", "rpcuser": "", "rpcpassword": "" },
"stratum": { "listen_addr": "0.0.0.0", "listen_port": 3333, "max_clients": 128 },
"mining": { "pool_address": "bc1qda26af22xs04dee33peyyszf4phqkgaf956nfh" },
"datum": {
"pool_host": "datum.sentineldefensetechnologies.co.za",
"pool_port": 28915,
"pool_pubkey": "08e75fe68a39ae7a6abe0af009d6d09591709ce6f1c531965a7685de52741b620e2441b7f9b5678ba4326873eae821f5b0c1c0365d855d6c2716c07d1a698b43",
"protocol_v3": true,
"pooled_mining_only": true
}
} 🔒 Privacy & Data Security Policy
Per our operational charter, the public telemetry endpoints enforce strict data sanitization:
bc1q...) are never broadcast in public API feeds.
🤝 Directory Reviewer Fast-Track & Custom Adapters
Are you a directory admin, indexer maintainer, or crawler engineer needing a custom JSON schema, endpoint format, or dedicated poll frequency? We build, test, and deploy directory-tailored adapters within 24 hours at zero cost.