나
소프트웨어와 문제 해결

풀 API 시작하기

최종 업데이트: 2026년 11월 5일

공개 JSON API에서 풀과 채굴자별 실시간 통계를 읽는 방법: 두 엔드포인트, 내 주소를 조회하는 방법, 얼마나 자주 조회할지를 알아봅니다.

풀 API로 무엇을 할 수 있나요?

풀에는 대시보드에 보이는 모든 것을 제공하는 공개 읽기 전용 JSON API가 있습니다. 키도 계정도 필요 없습니다.

이것으로 나만의 모니터링, 집에서 보는 대시보드, 봇, 또는 채굴을 기록하는 스프레드시트를 만들 수 있습니다. 두 가지 데이터를 얻을 수 있습니다.

  • 풀 전체 통계: 해시레이트, 네트워크 난이도, 블록, 지급.
  • 어떤 주소든 그 주소의 채굴자별 통계.
풀 통계 주소로 보내는 curl 요청이며, 풀 호스트와 엔드포인트가 색으로 표시되어 있습니다. 그 아래에 JSON 응답이 있습니다. 풀 부분에는 해시레이트, 채굴자 수, 워커 수가 있고, 네트워크 부분에는 난이도와 블록 높이가 있습니다.
주소는 풀과 원하는 수치를 지정합니다. 응답은 풀과 네트워크로 나뉜 단순한 JSON입니다.

풀 전체 통계는 어떻게 가져오나요?

풀 통계 엔드포인트는 헤더와 대시보드에서 보는 것과 같은 수치를 돌려줍니다.

  • 풀과 네트워크 해시레이트.
  • 연결된 채굴자.
  • 난이도.
  • 최근 블록.
  • 최근 지급.

다른 JSON URL처럼 가져오면 됩니다.

풀 통계
curl https://qubitcoin.herominers.com/api/stats

내 주소의 통계는 어떻게 가져오나요?

주소 하나를 읽으려면 그 주소를 채굴자 통계 엔드포인트에 넘기세요. YOUR_QTC_ADDRESS를 내 지갑 주소로 바꾸세요.

응답에는 그 주소의 해시레이트, 워커, 잔액, 최근 지급이 들어 있습니다. 대시보드 페이지 뒤에 있는 원본 데이터입니다.

채굴자 통계
curl https://qubitcoin.herominers.com/api/stats_address?address=YOUR_QTC_ADDRESS

API는 얼마나 자주 조회해야 하나요?

1~2분에 한 번이면 충분합니다. API는 쓰라고 있는 것이지만, 예의 있게 조회하세요.

시계에 맞춰 새로 고쳐지는 API 응답 카드입니다. 위쪽에서는 촘촘하게 몰아친 요청들이 빨간색 X로 지워져 있습니다. 응답이 모두 같기 때문입니다. 아래쪽에서는 시계가 한 번 째깍일 때마다 요청을 하나씩 간격을 두고 보내며, 초록색 체크 표시를 받습니다.
수치는 일정 간격으로 새로 고쳐지므로 1~2분에 한 번 요청하면 충분합니다.

그 뒤에 있는 숫자는 일정 간격으로만 갱신됩니다. 훨씬 더 자주 조회하면 양쪽 대역폭만 낭비하고, 더 새로운 데이터는 얻지 못합니다.

가져온 것은 캐시하세요. 대시보드가 쓰는 것과 같은 갱신 주기에 맞춰 만드세요.

직접 해 볼 준비가 되셨나요?
채굴 방법 가이드가 가장 가까운 서버를 골라 바로 쓸 수 있는 채굴 프로그램 명령어를 만들어 줍니다.
Qubitcoin 채굴 시작