Primi passi con l'API della pool
Legga da programma le statistiche in tempo reale della pool e di ogni miner: gli endpoint JSON pubblici, come interrogare il Suo indirizzo e le note sull'uso corretto.
A cosa serve l'API
Tutto ciò che la dashboard mostra è fornito da un'API JSON pubblica di sola lettura, quindi può creare il Suo sistema di monitoraggio, una dashboard per casa, un bot o un foglio di calcolo che segue il Suo mining. Espone le statistiche dell'intera pool (hashrate, difficoltà di rete, blocchi, pagamenti) e le statistiche per miner di qualsiasi indirizzo, senza chiave e senza account.
Statistiche dell'intera pool
L'endpoint delle statistiche della pool restituisce gli stessi dati che vede nell'intestazione e nella dashboard: l'hashrate della pool e della rete, i miner connessi, la difficoltà, gli ultimi blocchi e i pagamenti recenti. Lo richiami come qualsiasi URL JSON:
curl https://pearl.herominers.com/api/statsLe Sue statistiche da miner
Per leggere un singolo indirizzo, lo passi all'endpoint delle statistiche del miner. La risposta include l'hashrate, i worker, i saldi e i pagamenti recenti di quell'indirizzo, cioè i dati grezzi dietro la pagina della Sua dashboard:
curl https://pearl.herominers.com/api/stats_address?address=YOUR_PRL_ADDRESSUso corretto
L'API è fatta per essere usata, ma la interroghi con moderazione: i numeri sottostanti si aggiornano solo di tanto in tanto, quindi una richiesta ogni minuto o due è più che sufficiente, e bombardarla molto più spesso spreca solo la banda di entrambe le parti senza darLe dati più freschi. Metta in cache ciò che scarica e si regoli sulla stessa cadenza di aggiornamento che usa la dashboard.