GrossCrypto Pool — API Documentation

Everything here is free, public, and read-only. No API key required. CORS enabled on every custom endpoint below. This pool runs miningcoreV4, so the full native Miningcore API is also available alongside our own simplified feeds.

1. Our Public Feeds

Clean, stable, documented JSON — built for aggregator sites (like miningpoolstats.stream) and anyone building on top of this pool. Refreshes every 60 seconds.

GET /api/public/overview

Pool-level summary: name, URL, fee, totals.

{
  "pool_name": "MTBC Mining Pool",
  "pool_url": "https://pool.grosscrypto.com",
  "software": "miningcoreV4 (mateable/miningcoreV4)",
  "fee_percent": 1,
  "total_miners": 3,
  "total_hashrate": 904200.5,
  "coin_count": 7,
  "updated_at": 1794201558
}

GET /api/public/coins

Per-coin stats array — the schema most aggregator sites scrape.

{
  "coins": [
    {
      "symbol": "MTBC",
      "name": "MateableCoin (Balloon)",
      "algorithm": "Balloon",
      "hashrate": 322270.5,
      "miners": 1,
      "fee_percent": 1,
      "payout_scheme": "PPLNS",
      "minimum_payout": 0.5,
      "block_height": 4767417,
      "last_block_time": null,
      "stratum_url": "stratum+tcp://pool.grosscrypto.com:3258"
    }
  ],
  "updated_at": 1794201558
}

GET /api/public/network

Underlying blockchain network stats per coin — independent of our own pool's share of it.

{
  "networks": [
    {
      "symbol": "MTBC",
      "network_hashrate": 502863659.47,
      "network_difficulty": 0.000276009248,
      "block_height": 4767447,
      "connected_peers": 12
    }
  ],
  "updated_at": 1794202295
}

GET /api/public/history

Rolling 24-hour history of total pool miners/hashrate, one point per minute — enough for a simple chart without needing your own polling history.

{
  "points": [
    { "t": 1794202295, "miners": 3, "hashrate": 904200.5 }
  ]
}

2. Real-Time WebSocket Feed WS

Live push events — no polling needed. Connect with any standard WebSocket client:

wss://pool.grosscrypto.com/notifications

On connect you'll get a greeting, then a stream of JSON event objects as they happen pool-wide (new chain heights, blocks found, etc.):

{"message":"Connected to Miningcore notification relay","type":"greeting"}
{"poolId":"mtbc-balloon-v4-test","blockHeight":4767447,"symbol":"MTBC","name":"MateableCoin (Balloon)","type":"newchainheight"}

Example (JavaScript, works in any browser):

const ws = new WebSocket("wss://pool.grosscrypto.com/notifications");
ws.onmessage = (e) => console.log(JSON.parse(e.data));

3. Full Native Miningcore API

Every standard Miningcore endpoint is also available directly, for anything our simplified feeds above don't cover — detailed miner history, payments, blocks, balance changes, etc.

v2 variants of the miner/payment/block endpoints above (/api/v2/pools/...) are also available where you need a different pagination/response shape.