MiningMadness API & Mining Monitoring

Returns your current balance, unsold earnings, and the amount paid in the last 24 hours.

Request

GET https://miningmadness.com/api/wallet?address=YOUR_WALLET

Response

{
  "currency":  "BTC",
  "unsold":    0.00050362,
  "balance":   0.00000000,
  "unpaid":    0.00050362,
  "paid24h":   0.00000000,
  "total":     0.00050362
}

Extended wallet endpoint. Returns the same balance fields as /api/wallet plus a full list of your active workers and their real-time hashrate, algorithm, difficulty, accepted/rejected shares, and recent payouts.

Request

GET https://miningmadness.com/api/walletEx?address=YOUR_WALLET

Response

{
  "currency": "BTC",
  "unsold":   0.00050362,
  "balance":  0.00000000,
  "unpaid":   0.00050362,
  "paid24h":  0.00000000,
  "total":    0.00050362,
  "miners": [
    {
      "version":    "t-rex/0.26.8",
      "password":   "d=8192",
      "ID":         "rig1",
      "algo":       "kawpow",
      "difficulty": 8192,
      "subscribe":  1,
      "accepted":   4829183.5,
      "average":    4829183.5,
      "rejected":   0
    }
  ],
  "payouts": [
    {
      "time":   1714500000,
      "amount": "0.00100000",
      "tx":     "abc123…"
    }
  ]
}

Returns real-time statistics for every algorithm active on the pool: stratum port, fee, total hashrate, worker count, current profitability estimate, and 24-hour averages.

Request

GET https://miningmadness.com/api/status

Response

{
  "kawpow": {
    "name":              "kawpow",
    "port":              3628,
    "coins":             3,
    "fees":              0.9,
    "hashrate":          45872345600,
    "workers":           82,
    "estimate_current":  "0.00004821",
    "estimate_last24h":  "0.00004615",
    "actual_last24h":    "0.00004598",
    "mbtc_mh_factor":    1,
    "hashrate_last24h":  44512000000
  },
  "autolykos2": { … },
  …
}

Returns detailed statistics for every individual coin currently active on the pool, including block height, network difficulty, pool hashrate, blocks found in 24 h, payout method, and minimum payout.

Request

GET https://miningmadness.com/api/currencies

Response

{
  "RVN": {
    "algo":             "kawpow",
    "port":             3628,
    "name":             "Ravencoin",
    "reward":           2500,
    "height":           3450000,
    "difficulty":       74821.5,
    "workers":          41,
    "shares":           1204,
    "hashrate":         18234567800,
    "network_hashrate": 9812345678900,
    "estimate":         "0.00004821",
    "24h_blocks":       127,
    "24h_btc":          0.00541295,
    "lastblock":        3449998,
    "timesincelast":    43,
    "fees":             0.9,
    "payout_method":    "PPS+",
    "min_payout":       10
  },
  …
}

Because all endpoints return standard JSON you can integrate MiningMadness data into any monitoring stack (Grafana, Home Assistant, Discord bots, Telegram bots, spreadsheets, etc.) with a few lines of code.

cURL (shell / bash)

# Check your balance
curl -s "https://miningmadness.com/api/wallet?address=YOUR_WALLET"

# Get full worker list
curl -s "https://miningmadness.com/api/walletEx?address=YOUR_WALLET" | python3 -m json.tool

# Pool status for all algorithms
curl -s "https://miningmadness.com/api/status" | python3 -m json.tool

Python 3 – balance alert script

import urllib.request, json

POOL = "https://miningmadness.com"
WALLET = "YOUR_WALLET"

with urllib.request.urlopen(f"{POOL}/api/walletEx?address={WALLET}") as r:
    data = json.loads(r.read())

print(f"Unpaid: {data['unpaid']} BTC")
for w in data.get("miners", []):
    status = "✅" if w["accepted"] > 0 else "⚠️ OFFLINE"
    print(f"  {w['ID']} [{w['algo']}] {w['accepted']:.0f} H/s {status}")

Sending Alerts to Discord (webhook)

You can combine the API with a Discord webhook to receive custom notifications without relying on any third-party bot. Create a webhook in your Discord server (Channel Settings → Integrations → Webhooks) and use it in a cron job or home-server script:

import urllib.request, json

POOL    = "https://miningmadness.com"
WALLET  = "YOUR_WALLET"
WEBHOOK = "https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_TOKEN"

with urllib.request.urlopen(f"{POOL}/api/walletEx?address={WALLET}") as r:
    data = json.loads(r.read())

offline = [w for w in data.get("miners", []) if w["accepted"] == 0]
if offline:
    names = ", ".join(w["ID"] for w in offline)
    msg   = {"content": f"⚠️ **MiningMadness**: workers offline: {names}"}
    req   = urllib.request.Request(WEBHOOK, data=json.dumps(msg).encode(),
                                   headers={"Content-Type": "application/json"})
    urllib.request.urlopen(req)

Run this script every 5 minutes with cron (*/5 * * * * python3 /path/alert.py) and you will get a Discord message whenever a worker goes offline.