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
liststring
List of coins you want to obtain the data for, for example: ?list=BTC,BCH,BSV
algostring
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
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
[
{
"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
idstring
Unique identifier of the coin.
coinstring
Coin's ticker.
namestring
Coin's name.
typestring
Coin's type. It can be coin or pool, where pool is multi pool, such as NiceHash, Zpool, etc.
algorithmstring
Coin's algorithm.
network_hashrateinteger
Coin's network hashrate in H/s. If coin has no data on network hashrate, the network hashrate is -1.
difficultyreal
Coin's difficulty. If coin has no data on difficulty, the difficulty is -1.
rewardreal
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_unitstring
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_blockreal
Coin's block reward. If coin has no data on the block's reward, the block's reward is -1.
pricereal
Coin's price in USD. If coin has no data on price, the price is -1.
volumereal
Coin's last 24h volume in USD. If coin has no data on volume, the volume is -1.
updatedinteger
The UNIX timestamp of the last time the coin was updated.