API Documentation

Public API.

JSON endpoints for pool stats, miner data, and block history across all supported coins. No authentication required.

Base URL: https://solopool.eu/api/v1
All endpoints are namespaced by coin — replace {coin} with one of: bch · btc · dgb · xec · ppc · nmc. All responses are JSON. Requests are rate-limited per IP — limits shown per endpoint below.

Supported coins

Coin	Slug	Address format	Fee	Notes
BCH	`bch`	`bitcoincash:q...`	0.5%	Primary coin
BTC	`btc`	`bc1q...` / `bc1p...`	1%	Merge-mines NMC
DGB	`dgb`	`dgb1q...` / `D...`	0%	SHA-256 algo only
XEC	`xec`	`ecash:q...`	1%	Always include `ecash:` prefix
PPC	`ppc`	`pc1q...` / `P...`	0.5%	PoW/PoS hybrid
NMC	`nmc`	`N...` / `nc1q...`	0%	Merge-mined via BTC stratum

Endpoints

GET

/api/v1/{coin}

60 req / min

Full coin overview in a single request — stats, network, recent blocks, and top miners bundled together. Useful for dashboards and integrations that need everything at once.

Query params: ?blocks=5 (max 20, default 5) · ?miners=10 (max 50, default 10)

Example response — /api/v1/bch

{
  "coin": "BCH",
  "stats": {
    "hashrate":     "1.2 TH/s",
    "miners":       4,
    "fee":          "0.5%",
    "blocks_found": 2,
    "pool_luck":    "143%"
  },
  "network": {
    "difficulty":   128305072953,
    "hashrate":     "894.2 GH/s",
    "height":       895142,
    "block_reward": 3.125
  },
  "blocks": [
    { "height": 895021, "found_at": "2026-03-18T11:42:00Z", "reward": "3.125", "luck": "87%" }
  ],
  "miners": [
    { "address": "bitcoincash:qr2m...", "hashrate": "780 GH/s", "workers": 2, "status": "active" }
  ]
}

GET

/api/v1/{coin}/stats

60 req / min

Current pool statistics for the given coin — hashrate, miner count, fee, blocks found, and current luck.

Example response — /api/v1/bch/stats

{
  "hashrate":     "1.2 TH/s",
  "miners":       4,
  "fee":          "0.5%",
  "blocks_found": 2,
  "pool_luck":    "143%"
}

GET

/api/v1/{coin}/network

60 req / min

Current network data for the given coin — difficulty, block height, network hashrate, and block reward.

Example response — /api/v1/bch/network

{
  "difficulty":   128305072953,
  "hashrate":     "894.2 GH/s",
  "height":       895142,
  "block_reward": 3.125
}

GET

/api/v1/{coin}/blocks

60 req / min

Blocks found by this pool for the given coin, newest first.

Query params: ?limit=10 (max 50, default 10)

Example response — /api/v1/bch/blocks

[
  {
    "height":   895021,
    "found_at": "2026-03-18T11:42:00Z",
    "reward":   "3.125",
    "luck":     "87%"
  }
]

GET

/api/v1/{coin}/miners

30 req / min

Active miners for the given coin, sorted by hashrate descending.

Query params: ?limit=20 (max 100, default 20)

Example response — /api/v1/bch/miners

[
  {
    "address":  "bitcoincash:qr2m...",
    "hashrate": "780 GH/s",
    "workers":  2,
    "status":   "active"
  }
]

GET

/api/v1/{coin}/miner/{address}

20 req / min

Stats for a specific miner address. Use the coin-native address format (see table above). Returns 404 if the address has never connected.

Example response — /api/v1/bch/miner/bitcoincash:qr2m...

{
  "address":         "bitcoincash:qr2m...",
  "hashrate":        "780 GH/s",
  "hashrate_24h":    "650 GH/s",
  "shares_valid":    1284033,
  "shares_invalid":  12,
  "blocks_found":    1,
  "luck":            "87%",
  "last_share":      1742123456,
  "connected_since": 1741000000,
  "est_time_block":  1744800000,
  "workers": [
    {
      "name":       "bitaxe1",
      "hashrate":   "500 GH/s",
      "last_share": 1742123456,
      "status":     "active"
    }
  ]
}

Error responses

429Rate limit exceeded — back off and retry 404Miner not found for that address 503Pool backend temporarily unavailable

Questions about the API? Ask on Discord.