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:
- network status
- pool status
- pool info
- pool topcontributors
- miner status
- miner workers
- miner recenttransactions
All resources:
- version
- network hashrate
- network height
- network difficulty
- network estimatedtime
- network lastblocktime
- network status
- pool hashrate
- pool efficiency
- pool roundshares
- pool workercount
- pool minercount
- pool fees
- pool estimatedtime
- pool lastblocktime
- pool recentblocks
- pool blockstats
- pool topcontributors
- pool status
- pool info
- miner hashrate
- miner efficiency
- miner roundshares
- miner balances
- miner recenttransactions
- miner workercount
- miner workers
- miner status
version top###
Get the full version of the API.
GET Request:
https://api.mintpond.com/v1/zcoin/versionResult 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/hashrateResult Example:
{
"network": {
"hashrate": 453710
}
}network height top###
Get the current network block height.
GET Request:
https://api.mintpond.com/v1/zcoin/network/heightResult Example:
{
"network": {
"height": 38437
}
}network difficulty top###
Get the current network difficulty.
GET Request:
https://api.mintpond.com/v1/zcoin/network/difficultyResult 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/estimatedtimeResult 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/estimatedtimeResult Example:
{
"network": {
"lastBlockTime": 1519958757 /* timestamp */
}
}network status top###
Get network status in a single request.
GET Request:
https://api.mintpond.com/v1/zcoin/network/statusResult 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/hashrateResult 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/efficiencyResult 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/roundsharesResult 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/workercountResult 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/minercountResult Example:
{
"pool": {
"minerCount": 347
}
}pool fees top###
Get pool fees.
GET Request:
https://api.mintpond.com/v1/zcoin/pool/feesResult 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/estimatedtimeResult 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/estimatedtimeResult 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/recentblocksResult 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/blockstatsResult 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/topcontributorsResult 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/statusResult 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/infoResult 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
}
}
}