getmininginfo - Bitcoin

Example code for the getmininginfo JSON-RPC method. Complete guide on how to use getmininginfo JSON-RPC in GetBlock Web3 documentation.

This method returns a JSON object containing mining-related information.

Parameters

• None

Request

cURL

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "getmininginfo",
    "params": [],
    "id": "getblock.io"
}'

Axios

Request

Rust

Response

{
    "result": {
        "blocks": 928672,
        "currentblockweight": 3995956,
        "currentblocktx": 3955,
        "difficulty": 148195306640204.7,
        "networkhashps": 1.123192284545419e+21,
        "pooledtx": 20906,
        "chain": "main",
        "warnings": ""
    },
    "error": null
}

Response Parameters

Field	Type	Description
blocks	number	Current block height.
difficulty	number	Current network difficulty.
networkhashps	number	Estimated network hash rate per second.
pooledtx	number	Number of transactions in the mempool.
chain	string	Current network name (main, test, regtest).
warnings	string	Any network or blockchain warnings.

Use Case

The getmininginfo method is essential for:

• Monitoring mining network status

• Building mining dashboards

• Calculating mining profitability

• Tracking network hash rate

• Monitoring blockchain security

• Creating mining analytics tools

Error Handling

Status Code	Error Message	Cause
403	Forbidden	Missing or invalid ACCESS-TOKEN.

Integration with Web3

The getmininginfo method helps developers:

• Build mining monitoring applications

• Create profitability calculators

• Implement network health dashboards

• Track mining metrics over time

• Support mining pool integrations