Coins API documentation
This documentation explains how to call the authenticated Coins API. You must supply your API key with every request; unauthenticated calls return HTTP 401. Use the main endpoint to retrieve the full dataset or narrow the response with the optional query parameters below.
https://api.minerstat.com/v2/coins
Headers
Header
Value
Description
X-API-Keystring
Required. API key generated in the Developer Portal. Calls without this header (or with an invalid key) are rejected with HTTP 401.
Parameters
Parameter
Type
Description
liststring
Comma-separated tickers to limit the response (e.g. ?list=BTC,BCH,BSV).
algostring
Comma-separated algorithms to filter the response (e.g. ?algo=SHA-256,Scrypt).
keystring
Optional query alternative to the header. For browser tests only; use
X-API-Key in production.Example calls
curl "https://api.minerstat.com/v2/coins" -H "X-API-Key: YOUR_KEY"
curl "https://api.minerstat.com/v2/coins?list=BTC,BCH,BSV" -H "X-API-Key: YOUR_KEY"
curl "https://api.minerstat.com/v2/coins?algo=SHA-256,Scrypt" -H "X-API-Key: YOUR_KEY"
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
}, ...
]
Quota — Each successful request consumes one unit from your monthly subscription allotment. When the quota is reached the API responds with HTTP 402 and no data. Monitor remaining quota in the Developer Portal dashboard.
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.