Docs/개발자

API / RPC 레퍼런스

모빅 메인넷 데이터는 공개 익스플로러의 REST API로 조회할 수 있습니다. 별도 인증 없이 사용 가능하며, 응답은 JSON입니다.

엔드포인트 호스트

익스플로러 베이스 URL 기반
Mempool https://blockchain.mobick.info mempool.space (esplora 호환)
Explorer https://explorer.mobick.info btc-rpc-explorer (/api/docs)

아래는 mempool 인스턴스(blockchain.mobick.info) 기준의 주요 엔드포인트입니다. 비트코인 계열이므로 esplora API 규격과 호환됩니다.

블록

GET /api/blocks/tip/height      # 현재 블록 높이
GET /api/blocks/tip/hash        # 최신 블록 해시
GET /api/blocks                 # 최근 블록 목록(최신순)
GET /api/block/:hash            # 특정 블록 정보
GET /api/block-height/:height   # 높이 → 블록 해시

예시

curl https://blockchain.mobick.info/api/blocks/tip/height
# 47514

주소 (잔액·거래)

GET /api/address/:address       # 주소 요약(funded/spent/tx_count)
GET /api/address/:address/txs   # 주소의 거래 목록

잔액 계산: chain_stats.funded_txo_sum − chain_stats.spent_txo_sum (단위: sat, ÷100,000,000 = BMB)

curl https://blockchain.mobick.info/api/address/bc1qyt8cfzhz2dmnglhu5uklm2fvfftg0kga3hl3hp
# { "chain_stats": { "funded_txo_sum": 100000000000000, "spent_txo_sum": 0, ... } }
# → 1,000,000 BMB

홈페이지의 공공재 패널이 바로 이 엔드포인트로 16개 지갑 잔액을 실시간 합산합니다.

트랜잭션

GET /api/tx/:txid               # 트랜잭션 상세
GET /api/tx/:txid/status        # 확정 상태

멤풀 · 네트워크 통계

GET /api/mempool                     # 대기 트랜잭션 요약
GET /api/mempool/recent              # 최근 유입 트랜잭션
GET /api/v1/statistics/24h           # 24시간 멤풀 통계
GET /api/v1/difficulty-adjustment    # 난이도 조정 정보
GET /api/v1/mining/hashrate/3d       # 해시레이트
GET /api/v1/fees/recommended         # 권장 수수료

WebSocket (실시간)

wss://blockchain.mobick.info/api/v1/ws

{"action":"want","data":["blocks","mempool-blocks"]} 를 전송해 신규 블록·멤풀 업데이트를 구독할 수 있습니다.

CORS 참고

브라우저에서 직접 호출 시 CORS 제약이 있을 수 있습니다. 프론트엔드에서는 서버(예: Next.js Route Handler)를 통해 프록시하는 것을 권장합니다.