Public API

v1.0

Free REST API for mining pool statistics, coin prices, hashrate data, and exchange information.

BASE URL https://miningpoolstats.app/api/public

30 requests / minute

Quick Start

// Get all coins fetch('https://miningpoolstats.app/api/public/coins') // Get Bitcoin details fetch('https://miningpoolstats.app/api/public/coins/BTC') // Get mining pools for Monero fetch('https://miningpoolstats.app/api/public/coins/XMR/pools') // Get hashrate history (24h) fetch('https://miningpoolstats.app/api/public/coins/BTC/hashrate?range=24h')

Endpoints

GET /overview Global statistics overview

Returns total coins, pools, exchanges, and combined network hashrate.

Example Response

{ "success": true, "data": { "totalCoins": 366, "totalPools": 716, "totalExchanges": 10, "totalNetworkHashrate": "2184444955906551141" } }

GET /algorithms List mining algorithms with coin counts

Returns all mining algorithms and how many coins use each one.

GET /coins List all coins with price and hashrate

Paginated list of all approved coins with current price, hashrate, and pool count.

Parameter	Type	Description
algorithm	string	Filter by algorithm (e.g., SHA-256, Scrypt)
sort	string	Sort by: name, symbol, hashrate, price, pools
dir	string	Sort direction: asc (default) or desc
page	integer	Page number (default: 1)
limit	integer	Items per page (default: 20, max: 100)

GET /coins/:symbol Get coin details by symbol

Full coin details including price by exchange, exchanges listed, market data, social links, and supply info.

Parameter	Type	Description
:symbol	path	Coin symbol (e.g., BTC, XMR, ETH, MYDOGE)

GET /coins/:symbol/pools Get mining pools for a coin

Returns all active mining pools for a coin, sorted by hashrate. Includes pool fee, payout scheme, workers, and hashrate.

GET /coins/:symbol/price Get price data across exchanges

Returns current price and 24h volume for a coin across all exchanges where it trades.

GET /coins/:symbol/hashrate Get hashrate history

Returns historical hashrate and worker count aggregated by hour.

Parameter	Type	Description
range	string	Time range: 1h, 6h, 24h (default), 7d, 30d

GET /pools List all mining pools

Paginated list of all active mining pools sorted by hashrate.

Parameter	Type	Description
page	integer	Page number (default: 1)
limit	integer	Items per page (default: 20, max: 100)

GET /pools/:id Get pool details and latest stats

Returns pool details including coin, algorithm, fee, hashrate, and worker count.

GET /exchanges List all exchanges

Returns all approved exchanges with their coin count.

Response Format

All responses follow this structure:

{ "success": true, "data": { ... }, "meta": { // only for paginated endpoints "page": 1, "limit": 20, "total": 366, "pages": 19 } }

Error responses:

{ "success": false, "error": "Coin not found" }