Coins API documentation

This is a detailed documentation on how you can use minerstat coins API. By calling the main endpoint you can obtain data for all coins and multi pools that are available in the minerstat database. By including different GET parameters, you can limit the obtained data to specific list of coins or to specific list of algorithms.

https://api.minerstat.com/v2/coins

Parameters

Parameter
Type
Description
list
string
List of coins you want to obtain the data for, for example: ?list=BTC,BCH,BSV
algo
string
List of algorithms you want to obtain the data for, for example: ?algo=SHA-256,Scrypt

Example calls

https://api.minerstat.com/v2/coins
https://api.minerstat.com/v2/coins?list=BTC,BCH,BSV
https://api.minerstat.com/v2/coins?algo=SHA-256,Scrypt

Example response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
[
 {
  "id": "a195fd59ce0ebc3f9b2d99b3c396ff198bcb4a5e",
  "coin": "BTC",
  "name": "Bitcoin",
  "type": "coin",
  "algorithm": "SHA-256",
  "network_hashrate": 98375431254214117725,
  "difficulty": 14715214060656,
  "reward": 7.1200995930039e-19,
  "reward_unit": "BTC",
  "reward_block": 6.25,
  "price": 6735.0239848,
  "volume": 29276871265.114,
  "updated": 1586762742
 }, ...
]
Parameter
Type
Description
id
string
Unique identifier of the coin.
coin
string
Coin's ticker.
name
string
Coin's name.
type
string
Coin's type. It can be coin or pool, where pool is multi pool, such as NiceHash, Zpool, etc.
algorithm
string
Coin's algorithm.
network_hashrate
integer
Coin's network hashrate in H/s. If coin has no data on network hashrate, the network hashrate is -1.
difficulty
real
Coin's difficulty. If coin has no data on difficulty, the difficulty is -1.
reward
real
Coin's reward for 1 H/s for 1 hour of mining based on the most current difficulty. If coin has no data on reward, the reward is -1.
reward_unit
string
Coin's reward unit. If a coin is multi pool, the reward unit can be BTC or XMR or whichever reward is provided by the multi pool.
reward_block
real
Coin's block reward. If coin has no data on the block's reward, the block's reward is -1.
price
real
Coin's price in USD. If coin has no data on price, the price is -1.
volume
real
Coin's last 24h volume in USD. If coin has no data on volume, the volume is -1.
updated
integer
The UNIX timestamp of the last time the coin was updated.