풀 18
채굴자 없음
워커 없음
개발자

풀 API

모든 HeroMiners 풀은 같은 읽기 전용 HTTP 엔드포인트를 제공합니다. 키도, 계정도, 가입도 필요 없습니다. URL을 요청하면 JSON이 돌아오며, Access-Control-Allow-Origin: *가 설정되어 있어 브라우저의 웹페이지에서 바로 호출할 수 있습니다. 채굴기 모니터, 지급 알림, 나만의 대시보드를 만들거나 풀 데이터를 스프레드시트로 가져올 때 활용하세요.

코인마다 풀, 수치, 주소 형식이 각각 다르므로 먼저 코인을 고른 뒤 그 코인의 주소를 입력하세요. 여기에 입력한 내용은 풀에만 전송되며, "실행"을 눌렀을 때만 전송됩니다.

기본 URL
https://alephium.herominers.com

엔드포인트

GET /api/stats

풀의 현재 상태 전체: 풀 및 네트워크 해시레이트, 접속한 채굴자와 워커, 마지막 블록, 수수료, 포트, 지급 설정.

쿼리
address
지급 주소입니다. 해당 채굴자를 miner 아래에 추가하고, 솔로 채굴도 한다면 solo_miner 아래에도 추가합니다. 생략하면 두 키 모두 전송되지 않습니다.

이 엔드포인트부터 시작하세요. 이 사이트의 풀 페이지, 채굴자 페이지, 모든 차트가 이 엔드포인트를 바탕으로 만들어집니다.

요청 
curl "https://alephium.herominers.com/api/stats"
응답

pool, network, config, charts, lastblock, payments, visitors를 담은 객체이며, visitors는 현재 사이트에 있는 사람 수를 { windowMinutes, activeVisitors, activeLookups } 형식으로 나타냅니다. 통계 주기마다 한 번 다시 계산되므로 그보다 자주 폴링해도 같은 수치가 돌아옵니다.

GET /api/live_stats

/api/stats와 같은 데이터이지만, 다음 통계 주기가 끝날 때까지 요청을 열어 두었다가 응답합니다. 타이머로 폴링하는 대신 업데이트마다 요청 하나면 됩니다.

쿼리
address
/api/stats와 마찬가지로 데이터에 채굴자를 포함합니다.

연결을 하나 열고, 응답이 오면 다시 여세요. 같은 IP에서 여러 연결을 동시에 열면 503으로 거부되므로 요청을 여러 개로 나누지 마세요.

요청 
curl "https://alephium.herominers.com/api/live_stats"
응답

/api/stats와 같은 구조이지만 miner와 solo_miner가 항상 전송되며, 주소를 주지 않으면 비어 있습니다. 요청은 최대 통계 주기 한 번 동안 열려 있습니다.

GET /api/stats_address

채굴자 한 명: 현재 및 평균 해시레이트, 유효 셰어와 스테일 셰어, 잔액, 지급된 금액, 그리고 워커별 같은 수치.

쿼리
address필수
조회할 지급 주소입니다.
요청 
curl "https://alephium.herominers.com/api/stats_address"

이 요청을 실행하려면 위에서 address 값을 입력하세요. 이 값이 없으면 풀이 오류로 응답하므로 명령어에 포함되어 있습니다.

응답

stats(채굴자 합계), payments, charts, unlocked, workers를 담은 객체이며, workers는 워커마다 항목 하나가 있고 각 항목의 이름이 name인 배열입니다. 이 풀에서 채굴한 적이 없는 주소는 빈 채굴자 데이터가 아니라 오류로 응답합니다.

GET /api/get_blocks

풀이 찾았고 더 이상 대기 중이 아닌 블록: 지급되었거나 고아 블록이 된 블록입니다. status가 어느 쪽인지 알려 줍니다.

쿼리
height필수
이 높이보다 낮은 블록을 반환합니다. 최신 페이지는 체인 끝보다 훨씬 큰 숫자를 넣어 받고, 이전 페이지는 받은 가장 낮은 높이를 넣어 받으세요.

발견자 주소는 풀 밖으로 나가기 전에 가려지므로 이 엔드포인트로 주소를 수집할 수 없습니다. time은 Unix 초, reward는 코인의 최소 단위이며, 솔로 블록은 지급되었을 때 score가 s0, 고아 블록이 되었을 때 s1입니다.

요청 
curl "https://alephium.herominers.com/api/get_blocks?height=9999999999"
응답

값과 높이가 번갈아 나오는 평면 배열: [block, height, block, height, ...]. 각 블록은 콜론으로 구분됩니다:

0hash1time2difficulty3shares4score5nonce6status7reward8finder9region10rewardScheme
GET /api/get_payments

풀이 보낸 지급 내역으로, 풀 전체 또는 주소 하나를 대상으로 합니다.

쿼리
time필수
이 Unix 타임스탬프(초) 이전의 지급을 반환합니다. 최신 페이지는 현재 시각으로 받고, 이전 페이지는 받은 가장 오래된 타임스탬프로 받으세요.
address
지급 주소 하나로 제한합니다. 생략하면 풀의 모든 지급을 반환합니다.
limit
반환할 개수입니다. 풀의 페이지 크기로 제한되므로 더 큰 숫자를 넣어도 그만큼만 반환됩니다.
format
parsed를 넣으면 원시 배열 대신 { tx, amount, time } 객체를 받습니다.
conversions
address와 함께 1을 넣으면 이 페이지에서 다른 코인으로 환전된 모든 지급의 환전 기록도 함께 받습니다. 이때 응답은 { payments, conversions }가 됩니다. format=parsed와 함께 쓰면 무시됩니다.
요청 
curl "https://alephium.herominers.com/api/get_payments?time=1792758504"
응답

format이 없으면 값과 타임스탬프가 번갈아 나오는 평면 배열이며, 각 값은 txid:amount입니다. 금액은 코인의 최소 단위로 된 문자열이며 문자열로 유지해야 합니다. 소수점 18자리 체인에서 숫자로 변환하면 정밀도가 손실됩니다.

GET /api/get_miners_stats

풀에서 가장 큰 채굴자 10명과 채굴자 페이지에 쓰이는 채굴 프로그램별, 지역별 분포.

요청 
curl "https://alephium.herominers.com/api/get_miners_stats"
응답

miners, agents, regions, regionHistory, statsDisplay를 담은 객체입니다. 주소는 가려져 있습니다. 패널이 활성화되지 않은 경우 해당 배열은 비어 있고 statsDisplay가 이를 알려 줍니다.

GET /api/get_blocks_search_config

블록 검색 활성화 여부와 쿼리가 지켜야 할 제한으로, 첫 검색 전에 검색창을 설정할 수 있게 해 줍니다.

요청 
curl "https://alephium.herominers.com/api/get_blocks_search_config"
응답

{ enabled, minQueryLength, maxQueryLength, frontendCooldownMs }. 길이는 글자 수 기준이며, frontendCooldownMs는 두 검색 사이에 기다려야 하는 시간입니다.

GET /api/get_miner_payout_level

주소에 현재 설정된 지급 기준액으로, 코인 단위입니다.

쿼리
address필수
지급 주소입니다.

이 값은 짝이 되는 /api/set_miner_payout_level로 기록하며, 아무나 쓸 수는 없습니다: 요청은 해당 주소의 채굴 IP에서 와야 합니다. 이 확인 절차와 그 앞의 속도 제한은 여기가 아닌 대시보드의 설정 탭에서 설명합니다.

요청 
curl "https://alephium.herominers.com/api/get_miner_payout_level"

이 요청을 실행하려면 위에서 address 값을 입력하세요. 이 값이 없으면 풀이 오류로 응답하므로 명령어에 포함되어 있습니다.

응답

{ status: "done", level }. 한 번도 설정하지 않은 주소는 풀의 최소값을 받습니다.

GET /api/miner_ban_status

채굴자 페이지가 주소에 대해 보여 주는 차단 알림과 운영자가 그 주소에 남긴 메시지.

쿼리
address필수
지급 주소입니다.
요청 
curl "https://alephium.herominers.com/api/miner_ban_status"

이 요청을 실행하려면 위에서 address 값을 입력하세요. 이 값이 없으면 풀이 오류로 응답하므로 명령어에 포함되어 있습니다.

응답

{ banned, minerMessage }이며, 차단된 경우 blockMining, blockPayments, reason도 포함합니다. 채굴자 페이지가 이 주소에 대해 보여 주는 알림, 즉 채굴 차단, 지급 차단 또는 둘 다 아님을 나타냅니다. minerMessage는 운영자가 이 주소에 남긴 메시지로 { message, type, createdAt, expiresAt } 형식이며, 없으면 null입니다.

활용 팁

  • 풀의 주기에 맞춰 폴링하세요. 수치는 통계 주기마다 한 번 다시 계산되며, /api/stats 응답의 config.updateInterval이 그 길이를 초 단위로 알려 줍니다. 그보다 자주 요청해도 같은 답이 돌아오고 양쪽 모두 대역폭만 낭비합니다.
  • 빠른 타이머보다 /api/live_stats를 쓰세요. 새 데이터가 생기는 즉시 응답하므로 더 빠르고, 폴링보다 풀의 부담도 적습니다.
  • 금액은 문자열로 유지하세요. 보상과 잔액은 코인의 최소 단위로 돌아옵니다. 소수점 18자리 체인에서는 이 정수가 JavaScript 숫자로 정확히 표현할 수 있는 범위를 넘으므로, 숫자로 변환하면 지급액이 소리 없이 반올림됩니다.
  • 주소는 가려져 있습니다. 공개 목록은 모든 주소의 가운데 부분을 숨깁니다. 전체 주소는 본인만 필요하며, 직접 입력하는 곳에서만 쓰입니다.
  • 속도 제한은 실패가 아니라 대기로 처리하세요. 제한이 적용되면 응답에 retryMs가 포함됩니다. 요청을 반복해서 보내지 말고 그 시간만큼 기다린 뒤 다시 시도하세요.
  • 누구인지 밝혀 주세요. 도구 이름을 담은 User-Agent는 필수는 아니지만, 있으면 무언가 바뀔 때 무엇이 고장 났는지 추측하게 두지 않고 미리 알려 드릴 수 있습니다.