FirmwareAPI DocumentationCGminer commands
pools
Lists all pools
pools
Description
Lists all the pools, in order, and their statistics.
On luxminer, this command outputs an extra GROUP field, to indicate the pool group.
Command
$ echo '{"command": "pools"}' | nc $MINER_IP 4028 | jqExamples
$ echo '{"command": "pools"}' | nc $MINER_IP 4028 | jq
{
"POOLS": [
{
"Accepted": 179,
"AsicBoost": true,
"Bad Work": 0,
"Best Share": 262144,
"Current Block Height": 0,
"Current Block Version": 536870912,
"Diff": "32K",
"Diff1 Shares": 6094848,
"Difficulty Accepted": 6094848,
"Difficulty Rejected": 0,
"Difficulty Stale": 0,
"Discarded": 0,
"GROUP": 0,
"Get Failures": 0,
"Getworks": 148,
"Has GBT": false,
"Has Stratum": true,
"Has Vmask": true,
"Last Share Difficulty": 32768,
"Last Share Time": "00:00:16",
"Long Pool": "N",
"POOL": 0,
"Pool Rejected%": 0.0,
"Pool Stale%": 0.0,
"Priority": 0,
"Proxy": "",
"Proxy Type": "",
"Quota": 1.0,
"Rejected": 0,
"Remote Failures": 0,
"Stale": 0,
"Status": "Alive",
"Stratum Active": true,
"Stratum Difficulty": 32768,
"Stratum URL": "btc.global.luxor.tech:700",
"URL": "stratum+tcp://btc.global.luxor.tech:700",
"User": "worker",
"Work Difficulty": 32768,
"Works": 0
},
],
"STATUS": [
{
"Code": 7,
"Description": "LUXminer 2024.2.19.131822-ef17c0c4",
"Msg": "1 Pool(s)",
"STATUS": "S",
"When": 1672770089
}
],
"id": 1
}
Field details
| Field | Notes |
|---|---|
Accepted | Number of accepted shares. |
AsicBoost | Always true. |
Bad Work | Always zero. |
Best Share | Highest difficulty accepted. |
Current Block Height | Always zero. |
Current Block Version | Current version, according to pool. |
Diff1 Shares | Total difficulty of accepted, rejected and stale shares. |
Diff | A formatted string of the last share difficulty (rounded). |
Difficulty Accepted | Total difficulty of accepted shares. |
Difficulty Rejected | Total difficulty of rejected, non-stale shares. |
Difficulty Stale | Total difficulty of stale shares. |
Discarded | Always zero. |
GROUP | Group ID. |
Get Failures | Always zero. |
Getworks | Number of received jobs from the server. |
Has GBT | Always false. |
Has Stratum | Always true. |
Has Vmask | Always true |
Last Share Difficulty | Difficulty of the last accepted share. |
Last Share Time | A formatted string with the time elapsed since the last accepted share. |
Long Pool | Always "N". |
POOL | Pool ID. |
Pool Rejected% | Percentage of rejected, non-stale shares. |
Pool Stale% | Percentage of stale shares. |
Priority | Same as POOL. |
Proxy | Always "". |
Proxy Type | Always "". |
Quota | Quota of the group that this pool belongs. |
Rejected | Number of rejected, non-stale shares. |
Remote Failures | Always zero. |
Stale | Number of stale shares. |
Status | Status of the pool connection. Can be Dead, Connecting, Alive or Disabled. |
Stratum Active | true when the pool is in Alive state, otherwise false. |
Stratum Difficulty | Difficulty of the pool. |
Stratum URL | URL of the pool. |
URL | Same as Stratum URL, but with the protocol prefix. |
User | Stratum user. |
Work Difficulty | Same as Last Share Difficulty. |
Works | Always zero. |