Multipool.us APIs
10 min read

Multipool.us APIs

Multipool.us APIs

Multipool is a multi-coin mining pool, capable of dynamically switching between currencies, to maximise the profitability. They offer an API which allows nice access to their data. Unfortunately, I've found that it's quite difficult to find what's what, so I've decided to document it. Below you'll find some extra info on URLs and structure of the data.

Generic Information

Multipool offers status information to the public. at this URL. Information has rhe following structure:

  • hashrate - A dictionary of supported currencies and their mining hashrates in MHs
  • currency - This gets populated if the key is provided (see section below). Without key, the value is null
  • multiport - What the currency switching is mining now. It has an entry for each type of algorithms supported (currently scrypt and sha256). for each, the information presented is:
    • mining - currency mined
    • status - the status (I've only seen "chillin'")
  • connections - the number of connections for this currency
  • Message - a message (currently stating to get a key to access private information)

The sample below illustrates the structure better:

{
  "hashrate": {
    "arg": "287",
    "aur": "6171950",
    "btc": "112275557",
    "cap": "4919"
  },
  "currency": null,
  "multiport": {
    "scrypt": {
      "mining": "aur",
      "status": "chillin'",
      "connections": "7633"
    },
    "sha256": {
      "mining": "btc",
      "status": "chillin'",
      "connections": "1047"
    }
  },
  "message": "Add your api_key to URL to get user data"
}

Authenticated Information

If you have a key, then you can get your own information as a JSON. api3.php?api_key=<key> is almost identical. This variant contains significantly more detail than the "public" one:

  • currency - a dictionary of currencies, with user details for each. These details are presented as a dictionary with following fields:
    • confirmed rewards - your confirmed amount for that particular currency
    • hashrate - your mining hashrate
    • round_shares - your round shares ("false" if you're not mining that currency - and have not mined recently)
    • block_shares - your block shares
    • estimated_rewards - your estimated value of mining
    • payout_history - your payout history - I think is the total payout, not only the last one
    • pool_hashrate - the pool hashrate for the particular currency (in MHs)
  • workers - a per-currency status of the defined workers. For each worker, it contains a dict with a single field:
    • hashrate - the current hashrate of the miner for the specified currency
  • multiport - information regarding multiport mining:
    • mining - the currency mined
    • status - an information with e.g. potential move to another currency
    • connections - the number of connections for the currently multiport mined currency

As above, an example is worth 1000 words:

{
  "currency": {
    "aur": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "0",
      "pool_hashrate": "604560"
    },
    "dgc": {
      "confirmed_rewards": "0.1264841000000000",
      "hashrate": "0",
      "round_shares": "215872",
      "block_shares": "0",
      "estimated_rewards": "1.446177",
      "payout_history": "1140.526",
      "pool_hashrate": "17506"
    }
  },
  "workers": {
    "aur": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "dgc": {
      "user.worker_1": {
        "hashrate": "100"
      },
      "user.worker_2": {
        "hashrate": "800"
      }
    }
  },
  "multiport": {
    "mining": "doge",
    "status": "Potential move to moon at 2014-02-01T10:10:10Z</span>",
    "connections": "13969"
  }
}

Annex

Public Information

URL: multipool

{
  "hashrate": {
    "arg": "287",
    "aur": "6171950",
    "btc": "112275557",
    "cap": "4919",
    "cgb": "2268",
    "dgc": "14629",
    "dmd": "2386",
    "doge": "9023885",
    "dvc": 0,
    "eac": "1884",
    "frc": "1013854",
    "ftc": "62407",
    "gdc": "8147",
    "ixc": 0,
    "lky": "1333",
    "lot": "49099",
    "ltc": "485262",
    "mec": "16309",
    "mnc": "15798",
    "moon": "57919",
    "nmc": 0,
    "nvc": "8146",
    "ppc": "33728",
    "pxc": "308",
    "tips": "43083",
    "trc": "3273815",
    "wdc": "69133",
    "zet": "203517"
  },
  "currency": null,
  "multiport": {
    "scrypt": {
      "mining": "aur",
      "status": "chillin'",
      "connections": "7633"
    },
    "sha256": {
      "mining": "btc",
      "status": "chillin'",
      "connections": "1047"
    }
  },
  "message": "Add your api_key to URL to get user data"
}

User information

URL: api3.php?api_key=<key>

An example of full info is:

{
  "currency": {
    "aur": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "0",
      "pool_hashrate": "604560"
    },
    "btc": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": 0,
      "payout_history": "0",
      "pool_hashrate": "161439652"
    },
    "cap": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "0.488333",
      "pool_hashrate": "772"
    },
    "cgb": {
      "confirmed_rewards": "0.0022936018649489",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "0.116034",
      "pool_hashrate": "2659"
    },
    "dgc": {
      "confirmed_rewards": "0.1264841000000000",
      "hashrate": "300",
      "round_shares": "115872",
      "block_shares": "744",
      "estimated_rewards": "3.446177",
      "payout_history": "1140.526",
      "pool_hashrate": "17506"
    },
    "dmd": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "0",
      "pool_hashrate": "3947"
    },
    "doge": {
      "confirmed_rewards": "188.8638903000000400",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "89088.5",
      "pool_hashrate": "11872854"
    },
    "eac": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "0",
      "pool_hashrate": "2965"
    },
    "frc": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "0",
      "pool_hashrate": "625420"
    },
    "ftc": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "5.19965",
      "pool_hashrate": "69756"
    },
    "gdc": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "0",
      "pool_hashrate": "7791"
    },
    "lky": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "2.69647",
      "pool_hashrate": "1370"
    },
    "lot": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "0",
      "pool_hashrate": "63064"
    },
    "ltc": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "0.182037",
      "pool_hashrate": "476069"
    },
    "mec": {
      "confirmed_rewards": "0.4026777849999998",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "4.34964",
      "pool_hashrate": "16169"
    },
    "mnc": {
      "confirmed_rewards": "0.3673235630999999",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "32.1491",
      "pool_hashrate": "8391"
    },
    "moon": {
      "confirmed_rewards": "4944.1928999999890000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "136372",
      "pool_hashrate": "2187314"
    },
    "nvc": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "0",
      "pool_hashrate": "10741"
    },
    "ppc": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "0",
      "pool_hashrate": "33728"
    },
    "pxc": {
      "confirmed_rewards": "1.0706000140000010",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "0",
      "pool_hashrate": "832"
    },
    "tips": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "0",
      "pool_hashrate": "41803"
    },
    "trc": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "0",
      "pool_hashrate": "2365107"
    },
    "wdc": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "40.73",
      "pool_hashrate": "84330"
    },
    "zet": {
      "confirmed_rewards": "0.0000000000000000",
      "hashrate": "0",
      "round_shares": false,
      "block_shares": "0",
      "estimated_rewards": "0",
      "payout_history": "0",
      "pool_hashrate": "188151"
    }
  },
  "workers": {
    "arg": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "aur": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "btc": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "cap": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "cgb": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "dgc": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "744"
      }
    },
    "dmd": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "doge": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "eac": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "frc": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "ftc": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "gdc": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "lky": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "lot": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "ltc": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "mec": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "mnc": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "moon": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "nvc": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "ppc": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "pxc": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "tips": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "trc": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "wdc": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    },
    "zet": {
      "user.worker_1": {
        "hashrate": "0"
      },
      "user.worker_2": {
        "hashrate": "0"
      }
    }
  },
  "multiport": {
    "mining": "doge",
    "status": "Potential move to moon at 2014-02-01T10:10:10Z</span>",
    "connections": "13969"
  }
}

HTH,