API REFERENCE v2.4

Programmatic Control of Your Mining Fleet

Integrate live hashrate telemetry, automated worker diagnostics, and instantaneous payout notifications directly into your ERP, monitoring grafana, or automated trading desks.

See Code Snippets Explore Client SDKs

Endpoint Protocol & Authentication

Public REST API Base

https://api.hashce.io/v2

Supports CORS for web dashboards and rate-limited to 60 requests/minute without an API key.

Real-Time WebSocket Stream

wss://stream.hashce.io/v2/shares

Low-latency event streaming for share submissions, difficulty retargets, and block finds.

Core REST Endpoints

GET /pool/stats Returns pool-wide hashrate, total active workers, and current round luck

{
  "pool_hashrate_ths": 241470000.5,
  "active_workers": 18452,
  "blocks_found_24h": 14,
  "current_network_difficulty": 88402123491201,
  "last_block_hash": "00000000000000000001a4e591bc38d011f0"
}

GET /miner/{address}/workers Fetch individual worker telemetry and 10-minute hashrates for a wallet address

{
  "address": "bc1q87x9p3c8e54u2nmf60ykv9qzw09m7dlaeq0042",
  "total_workers": 2,
  "workers": [
    {
      "worker_id": "farm1.rig-s21-01",
      "status": "online",
      "reported_hashrate_ths": 234.0,
      "effective_hashrate_ths": 241.8,
      "shares_valid": 14290,
      "shares_stale": 3,
      "shares_rejected": 0,
      "last_share_epoch": 1726651230
    }
  ]
}

GET /miner/{address}/payouts List historical automated FPPS payout transactions and on-chain txids

{
  "address": "bc1q87x9p3c8e54u2nmf60ykv9qzw09m7dlaeq0042",
  "payouts": [
    {
      "payout_id": "pay_9941a80e",
      "amount_sats": 28410000,
      "method": "onchain",
      "txid": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "settled_at": "2026-09-17T00:00:15Z"
    }
  ]
}

Stratum V2 Binary Channel Protocol

Stratum V2 connections use a compact 6-byte header followed by variable-length binary payloads:

Extension Type (u16)

Identifies the channel (0x0000 = Mining, 0x0001 = Job Negotiation)

Msg Type (u8)

Specifies message identity (e.g. 0x00 OpenStandardMiningChannel)

Payload Length (u24)

Little-endian 24-bit byte count of encrypted frame body