The MintPond Public API can be used to retrieve pool information for use in 3rd party applications and scripts.

API Address

The API Address is of the following format:

https://api.mintpond.com/v1/<coin>/<resource>

If you want to access the zcoin pool API, the address would be:

https://api.mintpond.com/v1/zcoin/<resource>

Limits

Rate limiting is subject to change and occurs on a per IP address basis. All API data is cached for at least 60 seconds. Calling the API faster than 60 second intervals will not yield faster data updates.

Cross-origin requests are disabled to prevent abuse. If you need to use the API in a website, you will need to call it from your server, cache the results, then allow your web clients to request the data from you.

Value Types

This API implements uniform value types in its results. These value types will always be represented in the same units of measure no matter which resource they are from. The following are the main value types that require explanation but are not all possible value types:

  • Percents - Percents are represented as a number from 0 to 1. They may be larger than 1 for percents greater than 100%.
  • Hashrates - Hashrates are represented as the number of hashes per second.
  • Timestamp - Timestamps are represented as a unix timestamp in seconds.
  • Duration - Durations are represented in seconds.

Numbers will always be represented using the number type and will never be represented as string except if the number needs to be represented in hexadecimal (i.e. hash). None of the above value types will be represented in hexadecimal.

Resources

Resource urls allow retrieving data from a pool by using the GET method to access api urls. All resources return JSON results.

Resource Jump List

Recommended resources:

All resources:

version top

Get the full version of the API.

GET Request:

https://api.mintpond.com/v1/zcoin/version

Result Example:

{
    "version": "1.0.0"
}

network hashrate top

Get the current network hashrate in hashes per second.

GET Request:

https://api.mintpond.com/v1/zcoin/network/hashrate

Result Example:

{
    "network": {
        "hashrate": 453710
    }
}

network height top

Get the current network block height.

GET Request:

https://api.mintpond.com/v1/zcoin/network/height

Result Example:

{
    "network": {
        "height": 38437
    }
}

network difficulty top

Get the current network difficulty.

GET Request:

https://api.mintpond.com/v1/zcoin/network/difficulty

Result Example:

{
    "network": {
        "difficulty": 0.002114219946235227
    }
}

network estimatedtime top

Get the current estimated time to find the next network block in seconds.

GET Request:

https://api.mintpond.com/v1/zcoin/network/estimatedtime

Result Example:

{
    "network": {
        "estTime": 14   /* duration */
    }
}

network lastblocktime top

Get the timestamp in seconds that the last block was found on the network.

GET Request:

https://api.mintpond.com/v1/zcoin/network/estimatedtime

Result Example:

{
    "network": {
        "lastBlockTime": 1519958757   /* timestamp */
    }
}

network status top

Get network status in a single request.

GET Request:

https://api.mintpond.com/v1/zcoin/network/status

Result Example:

{
    "network": {
        "hashrate": 42568,
        "height": 39206,
        "difficulty": 0.000144,
        "estTime": 14,   /* duration */
        "lastBlockTime": 1519958757   /* timestamp */
    }
}

pool hashrate top

Get the current pool hashrate in hashes per second.

GET Request:

https://api.mintpond.com/v1/zcoin/pool/hashrate

Result Example:

{
    "pool": {
        "hashrate": 27962
    }
}

pool efficiency top

Get the current pool efficiency as a 0-1 percent.

GET Request:

https://api.mintpond.com/v1/zcoin/pool/efficiency

Result Example:

{
    "pool": {
        "efficiency": 1  /* percent */
    }
}

pool roundshares top

Get the total value of shares submitted during the current round.

GET Request:

https://api.mintpond.com/v1/zcoin/pool/roundshares

Result Example:

{
    "pool": {
        "roundShares": {
            "valid": 0,
            "invalid": 0
        }
    }
}

pool workercount top

Get the total number of workers connected to the pool.

GET Request:

https://api.mintpond.com/v1/zcoin/pool/workercount

Result Example:

{
    "pool": {
        "workerCount": 1237
    }
}

pool minercount top

Get the total number of miners (unique wallet addresses) connected to the pool.

GET Request:

https://api.mintpond.com/v1/zcoin/pool/minercount

Result Example:

{
    "pool": {
        "minerCount": 347
    }
}

pool fees top

Get pool fees.

GET Request:

https://api.mintpond.com/v1/zcoin/pool/fees

Result Example:

{
    "pool": {
        "fees": {
            "percent": 0,
            "txAmount": 0.001
        }
    }
}

pool estimatedtime top

Get the estimated average time in seconds for the pool to find the next block.

GET Request:

https://api.mintpond.com/v1/zcoin/pool/estimatedtime

Result Example:

{
    "pool": {
        "estTime": 123   /* duration */
    }
}

pool lastblocktime top

Get the timestamp in seconds that the last block was found by the pool.

GET Request:

https://api.mintpond.com/v1/zcoin/pool/estimatedtime

Result Example:

{
    "pool": {
        "lastBlockTime": 1520019   /* timestamp */
    }
}

pool getrecentblocks top

Get the last blocks found by the pool.

GET Request:

https://api.mintpond.com/v1/zcoin/pool/recentblocks

Result Example:

{
    "pool": {
        "recentBlocks": [
            {
                "hash": "461fee6b7ec875d03986e0baa912a6284d02c72ff4b25b9188791ceae878d312",
                "height": 39026,
                "time": 1519944003,   /* timestamp */
                "reward": 28,
                "finder": "TUbC7KzQB1VyFzBv83p37VCEQiq2PUUAFy.miner111",
                "roundShares": 8.15,
                "category": "confirmed",
                "luck": 0.514609375000014,   /* percent */
                "difficulty": 0.00001138286558009035
            },
            {
                "hash": "df846a98e186e9883b268c60502c32eefe66bc70e1733586d60b6fc8416a1a54",
                "height": 39027,
                "time": 1519944010,   /* timestamp */
                "reward": 28,
                "finder": "TUbC7KzQB1VyFzBv83p37VCEQiq2PUUAFy.miner111",
                "roundShares": 8.15,
                "category": "pending",
                "luck": 0.514609375000014,   /* percent */
                "difficulty": 0.00001138286558009035
            },

        ]
    }
}

pool blockstats top

Get the pool block statistics.

Request:

https://api.mintpond.com/v1/zcoin/pool/blockstats

Result Example:

{
    "pool": {
        "blockStats": {
            "total": 189,     // number of blocks found (confirmed + pending)
            "confirmed": 117, // number of confirmed blocks found 
            "pending": 72,    // number of pending blocks found
            "orphan": 0,      // number of orphan blocks found
            "reward": 5292.018984,  // total block rewards earned by pool

            "avgLuck3Blk": 0.75561419140622,   /* percent - Avg variance (last 3 blocks) */
            "avgLuck7Blk": 1.291918484793524,   /* percent - Avg variance (last 7 blocks) */
            "avgLuck25Blk": 2.427090300742187,   /* percent - Avg variance (last 25 blocks) */
            "avgLuckLifetime": 0.1854469592284,   /* percent - Avg variance */

            "total1h": 72,    // total blocks found, past 1 hour (confirmed + pending + orphan)
            "valid1h": 72,    // total valid blocks found, past 1 hour (confirmed + pending)
            "orphan1h": 0,    // total orphans found, past 1 hour
            "reward1h": 2016.018758, // block rewards earned, past 1 hour

            "total24h": 189,  // total blocks found, past 24 hours (confirmed + pending + orphan)
            "valid24h": 189,  // total blocks found, past 24 hours (confirmed + pending)
            "orphan24h": 0,   // total orphans found, past 24 hours
            "reward24h": 5292.018984, // block rewards earned, past 24 hours

            "total7d": 189,   // total blocks found, past 7 days (confirmed + pending + orphan)
            "valid7d": 189,   // total blocks found, past 7 days (confirmed + pending)
            "orphan7d": 0,    // total orphans found, past 7 days
            "reward7d": 5292.018984, // block rewards earned, past 7 days

            "total4w": 189,   // total blocks found, past 4 weeks (confirmed + pending + orphan)
            "valid4w": 189,   // total blocks found, past 4 weeks (confirmed + pending)
            "orphan4w": 0,    // total orphans found, past 4 weeks
            "reward4w": 5292.018984, // block rewards earned, past 4 weeks

            "total12m": 189,  // total blocks found, past 12 months (confirmed + pending + orphan)
            "valid12m": 189,  // total blocks found, past 12 months (confirmed + pending)
            "orphan12m": 0,   // total orphans found, past 12 months
            "reward12m": 5292.018984 // block rewards earned, past 12 months
        }
    }
}

pool topcontributors top

Get the top contributors to pool from the last 10 minutes.

GET Request:

https://api.mintpond.com/v1/zcoin/pool/topcontributors

Result Example:

{
    "pool": {
        "topContributors": [
            {
                "account": "TUbC7KzQB1VyFzBv83p37VCEQiq2PUUAFy",
                "hashrate": 246757
            },
            {
                "account": "TMG2xE698wyGXzUmeM22hk27nwk1VjciCn",
                "hashrate": 335544
            }
        ]
    }
}

pool status top

Get the current pool status in a single request.

GET Request:

https://api.mintpond.com/v1/zcoin/pool/status

Result Example:

{
    "pool": {
        "hashrate": 269077,
        "efficiency": 1, /* percent */
        "roundShares": {
            "valid": 0,
            "invalid": 0
        },
        "workerCount": 1,  // the total workers in the pool
        "minerCount": 1,   // the number of miners (wallet addresses) that are mining
        "estTime": 0,   /* duration - est. avg. time to find next block */
        "lastBlockTime": 1520019   /* timestamp - time when last block was found */
    }
}

pool info top

Get the pool settings.

GET Request:

https://api.mintpond.com/v1/zcoin/pool/info

Result Example:

{
    "pool": {
        "coin": {
            "name": "zcoin",
            "symbol": "XZC",
            "confirmations": 100,
            "algorithm": "lyra2z",
            "multiplier": 256
        },
        "payments": {
            "enabled": true,
            "smallestPayout": 0.01,  // The lowest user defined minimum payout allowed
            "fees": {
                "percent": 0,
                "txAmount": 0.001
            },
            "schedule": [
                {
                    "cron": "0-59 * * * *",
                    "allowCustomMin": true,
                    "minBalance": 1
                },
                {
                    "cron": "30 12 * * 5",
                    "allowCustomMin": false,
                    "maxBalance": 0.01
                }
            ]
        },
        "stratum": {
            "hosts": [
                "stratum-asia.mintpond.com",
                "stratum-australia.mintpond.com",
                "stratum-eu.mintpond.com",
                "stratum-us.mintpond.com"
            ],
            "ports": [
                {
                    "number": 3000,
                    "difficulty": 1,
                    "minDiff": 0.15,
                    "maxDiff": 450
                },
                {
                    "number": 3001,
                    "difficulty": 10,
                    "minDiff": 3,
                    "maxDiff": 450
                },
                {
                    "number": 3002,
                    "difficulty": 35,
                    "minDiff": 15,
                    "maxDiff": 1024
                }
            ]
        }
    }
}

miner hashrate top

Get a miners current hashrate.

GET Request:

https://api.mintpond.com/v1/zcoin/miner/hashrate/<walletAddress>

Result Example:

{
    "miner": {
        "hashrate": 159086
    }
}

miner efficiency top

Get a miners current efficiency as a 0-1 percent.

GET Request:

https://api.mintpond.com/v1/zcoin/miner/efficiency/<walletAddress>

Result Example:

{
    "miner": {
        "efficiency": 1   /* percent */
    }
}

miner roundshares top

Get total value of shares submitted by a miner during the current round.

GET Request:

https://api.mintpond.com/v1/zcoin/miner/roundshares/<walletAddress>

Result Example:

{
    "miner": {
        "roundShares": {
            "valid": 23,
            "invalid": 0
        }
    }
}

miner balances top

Get miner coin balances.

GET Request:

https://api.mintpond.com/v1/zcoin/miner/balances/<walletAddress>

Result Example:

{
    "miner": {
        "balances": {
            "unconfirmed": 2800.000597,
            "confirmed": 0,
            "paid": 3443.997714
        }
    }
}

miner recenttransactions top

Get the last 25 recent transactions for a miner.

GET Request:

https://api.mintpond.com/v1/zcoin/miner/recenttransactions/<walletAddress>

Result Example:

{
    "miner": {
        "recentTransactions": [
            {
                "id": "4e39e11ce4edbec15f851662e66afff6",
                "time": 1520019961,   /* timestamp */
                "type": "PAYOUT",
                "transactionId": "69783e29ea05ebad532c57b5de64cf04d2baf6ba4099839d14808c6aed5cb020",
                "amount": -55.999
            },
            {
                "id": "8946940feadd412e59ae5803c0d833cd",
                "time": 1520019961,   /* timestamp */
                "type": "FEE",
                "amount": -0.001
            },
            {
                "id": "201cc55824716e1a4c9e6deeaf26fe40",
                "time": 1519959900,   /* timestamp */
                "type": "PAYOUT",
                "transactionId": "6b968c67f7520aa7b0bef668d57c3f9c7f5e716fbb760bc6f856fdf44b652f10",
                "amount": -32.464756
            },
            {
                "id": "77e40d69b5029cf6cc8f841729244ebe",
                "time": 1519959900,   /* timestamp */
                "type": "FEE",
                "amount": -0.001
            },
            {
                "id": "be6a4f3e88aea8638f71e40e6ffbd1c8",
                "time": 1519959722,   /* timestamp */
                "type": "PAYOUT",
                "transactionId": "4fb54a7d88836d8227bab404c0b20d706d6f65efa99865c857cba753d6d53a6e",
                "amount": -3215.7972
            },
            {
                "id": "b683b79e4f1e5dad46b4ccbcb7bf4dba",
                "time": 1519955478,   /* timestamp */
                "type": "MATURE",     // MATURE indicates credit from mature block reward
                "round": 39091,
                "amount": 28
            },
            {
                "id": "f5fa84d09cb94167de577f621bc634eb",
                "time": 1519955474,   /* timestamp */
                "type": "MATURE",
                "round": 39090,
                "amount": 28
            }
        ]
    }
}

miner workercount top

Get the number of workers a miner has connected to the pool. This is not the number of unique connections but rather the number of unique worker names.

GET Request:

https://api.mintpond.com/v1/zcoin/miner/workercount/<walletAddress>

Result Example:

{
    "miner": {
        "workerCount": 1
    }
}

miner workers top

Get info about a miners connected workers.

GET Request:

https://api.mintpond.com/v1/zcoin/miner/workers/<walletAddress>

Result Example:

{
    "miner": {
        "workers": [
            {
                "name": "miner111",
                "hashrate": 219502,
                "efficiency": 1,   /* percent */
                "difficulty": 0.15
            }
        ]
    }
}

miner status top

Get miner status in a single request.

GET Request:

https://api.mintpond.com/v1/zcoin/miner/status/<walletAddress>

Result Example:

{
    "miner": {
        "hashrate": 253056,
        "efficiency": 1,   /* percent */
        "roundShares": {
            "valid": 0,
            "invalid": 0
        },
        "balances": {
            "unconfirmed": 2800.005428,
            "confirmed": 84,
            "paid": 4143.991714
        }
    }
}