Pierwsze kroki z API poola
Programowy odczyt bieżących statystyk poola i poszczególnych górników: publiczne endpointy JSON, zapytania o własny adres i zasady uczciwego korzystania.
Do czego służy API
Wszystko, co pokazuje panel, jest udostępniane przez publiczne API JSON tylko do odczytu, więc można zbudować własny monitoring, domowy panel, bota albo arkusz kalkulacyjny śledzący kopanie. API udostępnia statystyki całego poola (hashrate, trudność sieci, bloki, wypłaty) oraz statystyki górnika dla dowolnego adresu, bez klucza i bez konta.
Statystyki całego poola
Endpoint statystyk poola zwraca te same dane, które widać w nagłówku i w panelu: hashrate poola i sieci, podłączonych górników, trudność, ostatnie bloki i niedawne wypłaty. Pobiera się go jak każdy adres URL z JSON:
curl https://pearl.herominers.com/api/statsWłasne statystyki górnika
Aby odczytać pojedynczy adres, należy przekazać go do endpointu statystyk górnika. Odpowiedź zawiera hashrate tego adresu, workery, salda i niedawne wypłaty, czyli surowe dane, na których opiera się Państwa strona w panelu:
curl https://pearl.herominers.com/api/stats_address?address=YOUR_PRL_ADDRESSUczciwe korzystanie
API jest po to, aby z niego korzystać, ale należy odpytywać je kulturalnie: dane źródłowe aktualizują się tylko co jakiś czas, więc jedno zapytanie co minutę lub dwie w zupełności wystarcza, a odpytywanie go znacznie częściej tylko marnuje przepustowość obu stron i nie daje świeższych danych. Pobrane dane warto buforować i dopasować się do tego samego rytmu aktualizacji, którego używa panel.