Hver HeroMiners-pool svarer på det samme sæt skrivebeskyttede HTTP-endpoints. Der er ingen nøgle, ingen konto og ingen tilmelding: anmod om en URL, og du får JSON tilbage, med Access-Control-Allow-Origin: * sat, så en side i en browser kan kalde den direkte. Brug den til at bygge en rig-overvågning, en udbetalingsnotifikation, din egen oversigt eller til at hente poolens data ind i et regneark.
Angiv din adresse, så er hvert eksempel nedenfor klar til at blive kørt mod denne pool. Intet af det, du skriver her, sendes andre steder hen end til selve poolen, og kun når du trykker på Kør.
Basis-URL
https://quantus.herominers.com
Endpoints
GET/api/stats
Alt, hvad poolen ved om sig selv lige nu: poolens og netværkets hashrate, forbundne minere og workers, den seneste blok, gebyrer, porte og udbetalingsindstillingerne.
Parametre
address
En udbetalingsadresse. Tilføjer den miner under miner, og under solo_miner, hvis vedkommende også miner solo. Udelades den, sendes ingen af nøglerne.
Det er det endpoint, du skal starte med. Poolsiden, minersiden og hvert diagram på dette websted er bygget ud fra det.
Forespørgsel
curl "https://quantus.herominers.com/api/stats"
Svar
Et objekt med pool, network, config, charts, lastblock, payments og visitors, det vil sige hvor mange personer der er på webstedet lige nu, som { windowMinutes, activeVisitors, activeLookups }. Beregnes igen én gang pr. statistikcyklus, så hyppigere forespørgsler giver de samme tal.
GET/api/live_stats
De samme data som /api/stats, men forespørgslen holdes åben, indtil den næste statistikcyklus er færdig, og besvares så. Én forespørgsel pr. opdatering i stedet for forespørgsler på en timer.
Parametre
address
Tag en miner med i svaret, som med /api/stats.
Åbn én forbindelse, og åbn den igen, når den svarer. Flere åbne på én gang fra samme IP afvises med 503, så spred ikke forespørgslerne ud parallelt.
Samme struktur som /api/stats, bortset fra at miner og solo_miner altid sendes, tomme når der ikke er angivet en adresse. Forespørgslen holdes åben i op til én statistikcyklus.
GET/api/stats_address
Én miner: aktuel og gennemsnitlig hashrate, gyldige shares og stale shares, saldo, udbetalt beløb og de samme tal pr. worker.
Angiv address ovenfor for at køre denne. Kommandoen viser værdien, fordi poolen svarer med en fejl uden den.
Svar
Et objekt med stats (minerens totaler), payments, charts, unlocked og workers, et array med én post pr. worker, navngivet efter sit name. En adresse, der aldrig har minet her, får en fejl i stedet for en tom miner.
GET/api/get_blocks
Blokke, som poolen har fundet, og som ikke længere venter: udbetalte eller forældreløse. status angiver hvilket.
Parametre
heightpåkrævet
Returnér blokke under denne højde. Angiv et tal langt over kædens spids for den nyeste side, og derefter den laveste højde, du fik, for at bladre tilbage.
Finderens adresse maskeres, før den forlader poolen, så dette endpoint kan ikke bruges til at indsamle adresser. time er i Unix-sekunder, reward i coinens mindste enhed, og en soloblok har en score på s0, når den blev udbetalt, eller s1, når den blev forældreløs.
Betalinger, som poolen har sendt, enten for hele poolen eller for én adresse.
Parametre
timepåkrævet
Returnér betalinger før dette Unix-tidsstempel i sekunder. Brug det aktuelle tidspunkt for den nyeste side, og derefter det ældste tidsstempel, du fik, for at bladre tilbage.
address
Begræns til én udbetalingsadresse. Udelad for alle betalinger, poolen har foretaget.
limit
Hvor mange der skal returneres. Begrænses til poolens egen sidestørrelse, så et større tal giver blot den.
format
Angiv parsed for at få { tx, amount, time }-objekter i stedet for det rå array.
conversions
Sammen med address angiver du 1 for også at få vekslingsposten for hver udbetaling på siden, der blev vekslet til en anden coin. Svaret bliver så { payments, conversions }. Ignoreres med format=parsed.
Uden format et fladt array, der skifter mellem værdi og tidsstempel, hvor hver værdi er txid:amount. Beløb er strenge i coinens mindste enhed og skal forblive strenge: fortolkes et som et tal, går der præcision tabt på en kæde med 18 decimaler.
GET/api/get_miners_stats
De ti største minere i poolen, plus fordelingen pr. mining-software og region bag minersiden.
Et objekt med miners, agents, regions, regionHistory og statsDisplay. Adresser er maskerede. Når et panel ikke er aktiveret, kommer dets array tomt tilbage, og statsDisplay angiver det.
GET/api/get_blocks_search
Søg i poolens blokke efter højde, blok-hash eller finderens adresse, blandt ventende og udbetalte blokke på én gang.
Parametre
qpåkrævet
En højde, en blok-hash eller en adresse.
offset
Spring så mange resultater over. Svaret indeholder hasMore, så du ved, om du skal spørge igen.
Søgningen er begrænset pr. IP, og den, der går over grænsen, får rateLimited med den nøjagtige ventetid i retryMs i stedet for en tom fejl. Kald /api/get_blocks_search_config først for at kende længdegrænserne, og om søgningen overhovedet er slået til.
Angiv q ovenfor for at køre denne. Kommandoen viser værdien, fordi poolen svarer med en fejl uden den.
Svar
Et objekt med pending og matured, begge skiftende mellem værdi og højde som /api/get_blocks, plus totalMatched, offset, limit og hasMore. En matured-blok har formatet fra /api/get_blocks; en pending-blok venter stadig på at modne og bruger det længere format for ventende blokke, så dens felter står i en anden rækkefølge.
GET/api/get_blocks_search_config
Om bloksøgningen er slået til, og hvilke grænser en søgning skal holde sig inden for, så et søgefelt kan sættes op før den første søgning.
{ enabled, minQueryLength, maxQueryLength, frontendCooldownMs }. Længderne er i tegn, og frontendCooldownMs er, hvor længe du skal vente mellem to søgninger.
GET/api/get_miner_payout_level
Den udbetalingsgrænse, der i øjeblikket er sat for en adresse, i hele coins.
Parametre
addresspåkrævet
Udbetalingsadressen.
Det tilsvarende /api/set_miner_payout_level skriver den, og det er ikke åbent for alle: forespørgslen skal komme fra adressens egen mining-IP. Den kontrol, og forespørgselsgrænsen foran den, er beskrevet på fanen Indstillinger i oversigten i stedet for her.
Angiv address ovenfor for at køre denne. Kommandoen viser værdien, fordi poolen svarer med en fejl uden den.
Svar
{ banned, minerMessage }, og ved en spærring også blockMining, blockPayments og reason. Det er den meddelelse, minersiden viser for denne adresse: spærret for mining, for udbetalinger eller ingen af delene. minerMessage er operatørens besked til denne adresse, som { message, type, createdAt, expiresAt }, eller null, når der ikke er nogen.
Brug den godt
Spørg i poolens eget tempo. Tallene beregnes igen én gang pr. statistikcyklus, og config.updateInterval i svaret fra /api/stats angiver, hvor lang den er i sekunder. At spørge oftere giver det samme svar og koster båndbredde for os begge.
Brug hellere /api/live_stats end en hurtig timer. Det svarer, så snart der er noget nyt, hvilket både er hurtigere for dig og lettere for poolen end gentagne forespørgsler.
Behold beløb som strenge. Belønninger og saldi kommer tilbage i coinens mindste enhed. På en kæde med 18 decimaler bliver disse heltal større, end et JavaScript-tal kan rumme præcist, så fortolkning af et af dem afrunder stille en udbetaling.
Regn med maskerede adresser. Offentlige lister skjuler midten af hver adresse. Din egen fulde adresse skal kun bruges af dig, og kun der, hvor du selv angiver den.
Håndter en forespørgselsgrænse som en ventetid, ikke en fejl. Hvor en grænse gælder, indeholder svaret retryMs. Vent så længe, og prøv igen i stedet for at bombardere poolen med forespørgsler.
Fortæl, hvem du er. En User-Agent, der navngiver dit værktøj, er ikke påkrævet, men så kan vi fortælle dig om en ændring i stedet for, at du skal gætte, hvad der gik i stykker.