Pool Endpoint

  • Access to the API is limited to 150 requests / minutes / ip.
  • All API Response are cached for 2 minutes.
  • All endpoints are CORS enabled.
  • Endpoint: https://api.grinmint.com
  • Pool Stats

    Returns json data about various pool statistics.

  • URL

    /v1/poolStats

  • Method:

    GET

  • URL Params

    None

  • Data Params

    None

  • Success Response:

    • Code: 200

    • Content:

      Field Type Description
      status bool Response Status
      mined_block []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
      pool_stats []object General pool stats
      - primary_hashrate number Current pool primary PoW hashrate
      - secondary_hashrate number Current pool secondary 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
      - hashrate number Hashrate of the user
  • Error Response:

    • Code: 404 or 500

    • Content:

      Field Type Description
      status bool Response Status
      message string Reason for error
  • Sample Call:

      $.ajax({
        url: "/v1/poolStats",
        dataType: "json",
        type : "GET",
        success : function(r) {
          console.log(r);
        }
      });
  • Pool History

    Returns json data about the pool hashrate historical data.

  • URL

    /v1/poolHistory

  • Method:

    GET

  • URL Params

    None

  • Data Params

    None

  • Success Response:

    • Code: 200

    • Content:

      Field Type Description
      status bool Response Status
      hashrates []object Array of primary PoW hashrate data
      - time number Time of the data
      - primary_hashrate number Primary PoW Hashrate at that time
      - average_primary_hashrate number Average primary PoW hashrate at that time
      - secondary_hashrate number Secondary PoW Hashrate at that time
      - average_secondary_hashrate number Average secondary 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: "/v1/poolHistory",
        dataType: "json",
        type : "GET",
        success : function(r) {
          console.log(r);
        }
      });
  • Network Stats

    Returns json data about various network statistics.

  • URL

    /v1/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
      primary_hashrate number Current network primary PoW hashrate
      secondary_hashrate number Current network secondary PoW hashrate
  • Error Response:

    • Code: 404 or 500

    • Content:

      Field Type Description
      status bool Response Status
      message string Reason for error
  • Sample Call:

      $.ajax({
        url: "/v1/networkStats",
        dataType: "json",
        type : "GET",
        success : function(r) {
          console.log(r);
        }
      });
  • Network History

    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
      network_stats []object Array of network statistics
      - time number Time of the data
      - target_difficulty number Target difficulty
      - primary_hashrate number Primary PoW hashrate at that time
      - secondary_hashrate number Secondary 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: "/v1/networkHistory",
        dataType: "json",
        type : "GET",
        success : function(r) {
          console.log(r);
        }
      });
  • What To Mine

    Compute whether to mine primary or secondary and the rewards associated.

  • URL

    /v1/pool/whatToMine

  • Method:

    POST

  • URL Params

    Required:

    None

  • Data Params

    Required:

    • gps31=[number]
    • gps29=[number]
    • pool_fee=[number]
  • Success Response:

    • Code: 200

    • Content:

      Field Type Description
      status bool Response Status
      secondary_scaling number Current secondary scaling factor
      target_difficulty number Network target difficulty
      primary_hashrate number Current network primary PoW hashrate
      secondary_hashrate number Current network secondary PoW hashrate
      primary_more_profitable bool Whether the primary PoW is more profitable to mine
      estimated_rewards []object Estimated rewards
      - graph_size number Graph size
      - minute number Grins per minute
      - hour number Grins per hour
      - day number Grins per day
  • Error Response:

    • Code: 404 or 500

    • Content:

      Field Type Description
      status bool Response Status
      message string Reason for error
  • Sample Call:

      var bodyParams = {
        gps29: 1.2,
        gps31: 5.3,
        pool_fee: 2.5
      }
      $.ajax({
        url: "/v1/pool/whatToMine",
        dataType: "json",
        type : "POST",
        contentType: 'application/json',
        success : function(r) {
          console.log(r);
        },
        data: JSON.stringify(bodyParams)
      });
  • Grin is an experimental coin: use at your own risk! Grinmint does not guarantee any return on mining time or hashpower. You are strongly encouraged to move your rewards off the pool as often as possible into a wallet that you control. Although Grinmint takes multiple precautions to keep our users' coins safe, we do not offer any guarantee against hacks or loss. Grinmint is not a wallet. You, the user, assume the risk for any coins left on Grinmint. 60 days after coin maturity, your coins are considered expired and you will no longer be able to request payouts for them.