Multipool.us APIs

Posted by in Software

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 the following URL:

Information has he 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:

Authenticated Information

If you have a key, then you can get your own information as a JSON. The URL 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:

Annex

Public Information

URL: http://api.multipool.us/api3.php

User information

URL: http://api.multipool.us/api3.php?api_key=<key>

An example of full info is:


A little experiment: If you find this post and ad below useful, please check the ad out :-)