V2 Pool Endpoint
https://api.grinmint.com
Returns json data about various pool statistics.
URL
/v2/poolStats
Method:
GET
URL Params
None
Data Params
None
Success Response:
-
Code: 200
-
Content:
Field Type Description status bool Response status mined_blocks []object Array of blocks recently mined by the pool - height number Height of the block mined - time number Mined on - block_hash string Hash of the mined block - elapsed string Duration of the round - round_hashrates []number Array ([gps29, gps31, gps32, gps33]) of hashrates for this round (during the time elapsed). - luck string Luck for this block - reward string Block reward (in nanogrins) - paid string Total paid for this block (in nanogrins) pool_stats []object General pool stats - hashrates number Array ([gps29, gps31, gps32, gps33]) of current pool PoW hashrate - average_hashrates number Array ([gps29, gps31, gps32, gps33]) of current pool PoW hashrate - users number Number of currently active users - workers number Number of currently active workers - blocks_found_last_hour number Number of blocks found last hour - blocks_found_last_24_hours number Number of blocks found in the last 24 hours top_user []object Top 10 users by hashrate - rank number Rank of the user - gps32 number C32 hashrate of this rank - gps33 number C33 hashrate of this rank
Error Response:
-
Code: 404 or 500
-
Content:
Field Type Description status bool Response status message string Reason for error
Sample Call:
$.ajax({
url: "/v2/poolStats",
dataType: "json",
type : "GET",
success : function(r) {
console.log(r);
}
});
Returns json data about the pool hashrate historical data.
URL
/v2/poolHistory
Method:
GET
URL Params
None
Data Params
None
Success Response:
-
Code: 200
-
Content:
Field Type Description status bool Response status data []object Array of PoW hashrates data - time number Time of the data - hashrates number Array ([gps29, gps31, gps32, gps33]) of PoW hashrates at that time - average_hashrates number Array ([gps29, gps31, gps32, gps33]) of average primary PoW hashrates at that time
Error Response:
-
Code: 404 or 500
-
Content:
Field Type Description status bool Response status message string Reason for error
Sample Call:
$.ajax({
url: "/v2/poolHistory",
dataType: "json",
type : "GET",
success : function(r) {
console.log(r);
}
});
Returns json data about various network statistics.
URL
/v2/networkStats
Method:
GET
URL Params
None
Data Params
None
Success Response:
-
Code: 200
-
Content:
Field Type Description status bool Response status height number Current block height last_block_pushed string Hash of the last block prev_block_to_last string Hash of the previous block target_difficulty number Network target difficulty secondary_scaling number Current secondary scaling factor percentage_secondary number Percentage of the secondary PoW total_difficulty number Network total difficulty hashrates object Current network hashrate. Key is a graph size string and value is an hashrate number
Error Response:
-
Code: 404 or 500
-
Content:
Field Type Description status bool Response status message string Reason for error
Sample Call:
$.ajax({
url: "/v2/networkStats",
dataType: "json",
type : "GET",
success : function(r) {
console.log(r);
}
});
Returns json data about the network historical data.
URL
/networkHistory
Method:
GET
URL Params
None
Data Params
None
Success Response:
-
Code: 200
-
Content:
Field Type Description status bool Response status data []object Array of network statistics - time number Time of the data - target_difficulty number Target difficulty - hashrates number Array ([gps29, gps31, gps32, gps33]) of PoW hashrate at that time
Error Response:
-
Code: 404 or 500
-
Content:
Field Type Description status bool Response status message string Reason for error
Sample Call:
$.ajax({
url: "/v2/networkHistory",
dataType: "json",
type : "GET",
success : function(r) {
console.log(r);
}
});