About

Learn About MobileMiner Apps and API

Apps

The MobileMiner apps allow you to remotely monitor and control your Bitcoin, Litecoin, and other crypto-currency mining rigs. Setup is simple and there are no firewall changes or port-forwarding required.

API

MobileMiner is powered by an openly available and documented REST API, allowing the authors of mining software to quickly and easily add support for remote monitoring and control.

Contact us about a White-Label product for your hardware controller or cloud mining service!

Getting Started

Getting Started with MobileMiner

To get started monitoring your mining with MobileMiner you can either install one of our mobile apps or visit our HTML5 browser app. The Apps section contains links to our mobile and browser apps.

Once you have launched one of the MobileMiner apps you will be greeted by a Sign Up screen. Simply enter your email address and click Sign Up. Your MobileMiner application key will be emailed to you. Once you have received your application key you can Sign In to the MobileMiner app.

The final step is to install and configure compatible mining software. Refer to the settings found in each application for entering both your MobileMiner email address and application key.

Apps

Links to Mobile Apps

HTML5

The HTML5 application for MobileMiner makes it simple and intuitive to monitor and control your mining machines right from any browser. It also features Charts, a Dashboard, the ability to Share Statistics, and API Access to Statistics.

login now

iOS

Our iOS application is available for download from the Apple App Store. It's a universal app supporting iPhones, iPods and iPads running iOS 5.0 and greater.

download

Android

The Android application is available on the Google Play store. It supports phones and both 7" and 10" tablets running Android 2.3 and up.

download

Windows Phone

Our native Windows Phone application is now available on the Windows Phone store. It supports Windows Phone 7.1, 7.8, 8.0 and 8.1 devices.

download

Miners

Compatible Mining Software

In order to use MobileMiner you will need to use a compatible miner on your PC, Mac or embedded device.

Each of the software packages found below includes build-in support for the MobileMiner API. Simply enter your MobileMiner email address and application key into the mining software below and we'll take care of the rest.

Asteroid

OS X

Asteroid aims to be an easy-to-use Bitcoin and Litecoin miner for the Mac. Utilizing a full complement of Mac OS X technologies alongside the built-in cgminer backend, you can be mining crypto currencies in no time at all.

download

BFGMobileAdapter

Windows ·  OS X ·  Linux

BFGMobileAdapter is a simple Python Script to take data from BFGMiner and send it to the MobileMiner REST API. Currently this script does not allow for remote Miner control. Settings such as time-interval are configurable from within the script.

download

CGMinerMobileAdapter

Windows ·  OS X ·  Linux

CGMinerMobileAdapter is a simple Python Script to take data from BFGMiner and/or CGMiner and send it to the MobileMiner REST API. The script includes remote commands support and has been tested on BAMT, CGMiner and its forks (VertMiner, SGMiner).

download

CoinTerra Monitor

Windows ·  OS X ·  Linux

CoinTerra Monitor is a Python script that monitors CoinTerra Bitcoin Miners for errors, sends emails with the CoinTerra log files attached, and will reboot the CoinTerra machine.

download

M's Miner Monitor

Windows

M's Miner Monitor lets you look at all your Bitmain Ants (S1/S2/S3/S4/S5/C1) and your Spondoolie units (SP10/SP20/SP30/SP31/SP35) in one spot, assuming you're using Windows (uses .NET 4.0) and your PC can reach them all via your network.

download

MacMiner

OS X

Simple like iOS, yet powerful like a Mac, MacMiner gives you all the options from setting up with nothing more than a BTC or LTC address to the ability to edit the raw config files for bfgminer and cgminer.

download

MinePeon

Linux

MinePeon is an excellent Linux distribution for the Raspberry Pi aimed at Bitcoin mining using USB ASICs. The MinePeon Addons repository provides additional, optional modules for MinePeon including support for the MobileMiner API.

download

Minera

Linux

Minera is a complete system to manage and monitor your GridSeed devices. It features device autodetection, device autotuning, on-the-fly pool switching and much more.

download

MultiMiner

Windows ·  OS X ·  Linux

MultiMiner is a graphical application for crypto-coin mining. MultiMiner simplifies switching individual devices (GPUs, ASICs, FPGAs) between crypto-currencies such as Bitcoin and Litecoin. It also has features such as re-launching crashed miners and automatically mining the most profitable coins.

download

SAntViewer

Windows

SAntViewer is an Open Source app for monitoring AntMiners – specifically S1s – using the CGMiner API. Features include AntMiner monitoring, rebooting, mass-rebooting, and more.

download

API Docs

Using the MobileMiner API

Miner authors can easily add support for the MobileMiner REST API. The minimal network call required is a simple HTTP POST to send mining statistics. If you choose to support remote commands, this takes only the combination of a single HTTP GET and HTTP DELETE. Documentation of these API calls are below, as well as a form to request an API key.

To get started you will need your API key. Next, you will need to add a series of UI controls in your mining software that allow the user to enter an email address, application key, and choose to enable remote monitoring and/or remote commands.

Finally, download and register one of the available MobileMiner apps. With your API key, along with the email address and application key used to register MobileMiner, you can begin making calls to the MobileMiner REST API.

Root URL

https://api.mobileminerapp.com

Statistics

Submitting statistics from your own miner or script requires a single HTTP POST to the URL specified below. The body of the request should be JSON formatted as shown below.

HTTP POST

URL
{Root URL}/MiningStatisticsInput?emailAddress={Email Address}&applicationKey={Application Key}&apiKey={API Key}
Request
[
    {
        "MachineName":"My-Mining-Rig",
        "MinerName":"MultiMiner",
        "CoinSymbol":"BTC",
        "CoinName":"Bitcoin",
        "Algorithm":"SHA-256",
        "Kind":"PGA",
        "Name":"HBR"
        "FullName":"HashBuster.micro",
        "PoolIndex":0,
        "PoolName":"mining.eligius"
        "Index":0,                                            
        "DeviceID":0,
        "Enabled":true,
        "Status":"Alive",
        "Temperature":43,
        "FanSpeed":0,
        "FanPercent":0,
        "GpuClock":0,
        "MemoryClock":0,
        "GpuVoltage":0,
        "GpuActivity":0,
        "PowerTune":0,
        "AverageHashrate":23477059,
        "CurrentHashrate":15666955,
        "AcceptedShares":3,
        "RejectedShares":0,
        "HardwareErrors":0,
        "Utility":2.063,
        "Intensity":null,
        "RejectedSharesPercent":1.8123,
        "HardwareErrorsPercent":0.7685
    }
]

Note

You should send a single HTTP POST for all machines on your network - not one POST per machine. You can use the MachineName property on the JSON request to specify the name of each machine.

Note

The MinerName property must be specified and should be the name of the mining software or script that is calling the MobileMiner API. It should not be the name of the machine, which is specified in the MachineName property.

Notifications

The MobileMiner API makes it easy for you to send notifications (both Push and Email) from your mining software to your users. By sending a simple HTTP POST request with a JSON payload you can start pushing notifications to your users without having to setup Email or Push notification gateways or servers.

HTTP POST

URL
{Root URL}/NotificationsInput?emailAddress={Email Address}&applicationKey={Application Key}&apiKey={API Key}
Request
[
"Version 2.0 of my Miner Software is available",
"Pool abcd.com is down"
]

Pools

Using the MobileMiner API you can easily post a simple list of pools that your mining software has configured. By providing MobileMiner with this list, the MobileMiner apps will allow your users to switch pools from their smart phones and browsers.

See the Commands section for more information on supporting pool switching.

HTTP POST

URL
{Root URL}/PoolsInput?emailAddress={Email Address}&applicationKey={Application Key}&machineName={Machine Name}&apiKey={API Key}
Request
[
"Bitcoin",
"Litecoin",
"Dogecoin",
"BBQCoin",
"Bottlecaps",
"CryptogenicBullion",
"Feathercoin",
"Megacoin",
"Novacoin",
"PPCoin",
"Worldcoin",
"Zetacoin"
]

Commands

If you would like to support remote commands in your software or scripts you will need to first submit an HTTP GET, then process the JSON response, and finally submit an HTTP DELETE to delete the remote command. Current CommandText values are limited to START, STOP, RESTART and SWITCH.

The SWITCH command is used to allow switching pools and requires you to also support the Pools API section documented above. The SWITCH command will be followed by a pipe character and then the pool name.

HTTP GET

URL
{Root URL}/RemoteCommands?emailAddress={Email Address}&applicationKey={Application Key}&machineName={Machine Name}&apiKey={API Key}
Response
[
    {
        "Id":76,
        "CommandText":"STOP",
        "CommandDate":"2013-08-03T06:24:08.203"
    }
]

HTTP DELETE

URL
{Root URL}/RemoteCommands?emailAddress={Email Address}&applicationKey={Application Key}&machineName={Machine Name}&commandId={Command Id}&apiKey={API Key}
Response
{
    "Id":76,
    "CommandText":"STOP",
    "CommandDate":"2013-08-03T06:24:08.203"
}

API Key

Request an API Key

Note

An API key is only required by developers who want to submit statistics from their own software or scripts to the MobileMiner API. An API key is not required to use the MobileMiner apps.

To get started with the MobileMiner REST API you will need an API key. Enter your email address below to have an API key generated and sent to you.

Once you have received your API key you can begin consuming the MobileMiner API.

Contact

Get in Touch, Stay in Touch