API BDL Pool

Statistiques du pool, des adresses Bitcoin et des workers.

Adresse de base

https://bdl-pool.duckdns.org/api/v1

Endpoints

URL	Réponse
`GET /online?limit=50&offset=0`	Connexions actives, adresses abrégées et appareils annoncés.
`GET /health`	État du service API
`GET /pool`	Statistiques globales et nœud Bitcoin
`GET /history`	Historique du hashrate
`GET /stratum`	Adresse, ports et clé publique V2
`GET /miners/{address}`	Statistiques d’une adresse Bitcoin
`GET /miners/{address}/workers?limit=50&offset=0`	Workers d’une adresse
`GET /miners/{address}/workers/{worker}`	Détail d’un worker
`GET /openapi.json`	Spécification OpenAPI 3.1

Exemples

cURL

curl https://bdl-pool.duckdns.org/api/v1/pool
curl "https://bdl-pool.duckdns.org/api/v1/miners/VOTRE_ADRESSE_BTC/workers?limit=50&offset=0"

JavaScript

const base = "https://bdl-pool.duckdns.org/api/v1";
const address = "VOTRE_ADRESSE_BTC";
const response = await fetch(`${base}/miners/${encodeURIComponent(address)}`);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const miner = await response.json();

Format des données

Présence: Relevé des connexions toutes les 15 secondes. available=false indique que leur état n’est pas confirmé.
Appareil: Modèle annoncé dans le user-agent Stratum, sinon nom du logiciel. Un modèle absent reste null.
Actualisation: Statistiques globales toutes les cinq minutes. Les données des workers suivent CKPool.
Dates: updatedAt indique la date de la mesure. stale signale une mesure ancienne.
Hashrate: Toutes les valeurs hashrateHps sont en H/s. Une valeur inconnue reste null.
Adresses: Utilisez une adresse Bitcoin mainnet sans suffixe de worker. CKPool crée ses statistiques après sa première share enregistrée.
Workers: limit vaut 50 par défaut, jusqu’à 200. offset permet de parcourir la liste. Le nom complet du worker évite les ambiguïtés.
Disponibilité: readyAtLastCheck concerne le dernier contrôle Stratum V1. Il ne confirme pas une connexion V2.
Accès: Lecture seule, sans authentification. GET, HEAD et OPTIONS ; CORS public. Aucun répertoire des adresses n’est exposé.

Codes HTTP

200: Données disponibles, parfois anciennes : vérifier stale.
304: Réponse inchangée pour cet ETag.
400: Adresse ou paramètres invalides.
404: Endpoint, adresse ou worker absent.
405: Méthode d’écriture refusée.
503: Source de statistiques indisponible.