V2 Pool Endpoint

  • Access to the API is limited to 150 requests / minutes / ip.
  • All API responses 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

    /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);
        }
      });
  • Pool History

    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);
        }
      });
  • Network Stats

    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);
        }
      });
  • 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
      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);
        }
      });
  • 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.