getmininginfo

getmininginfo is a Bitcoin Core JSON-RPC method that summarizes the current state of the Proof-of-Work network as seen by the node — the engine that mints BTC and extends the chain roughly every ten minutes. A single call returns the tip block height, the current difficulty, an estimate of total network hashes per second, the number of transactions waiting in the mempool, and which chain (main or test) the node is on. Send it to the read-only endpoint at https://bitcoin.therpc.io/YOUR_API_KEY to pull mining-related blockchain state without running your own full node.

Use cases

• Read the current difficulty and the estimated networkhashps together in one round trip instead of stitching several calls.
• Surface pooledtx, the count of transactions sitting in the node's mempool, to gauge backlog and fee pressure.
• Feed a mining or network-stats dashboard with tip height, difficulty, hashrate and chain, refreshed each block.

Parameters

This method takes no parameters. Pass an empty array [].

Response

Example request

1curl https://bitcoin.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5  "jsonrpc": "1.0",
6  "id": "therpc",
7  "method": "getmininginfo",
8  "params": []
9}'

Errors & troubleshooting

Common pitfalls

• The networkhashps field here is a single point estimate over Bitcoin Core's default block window. For a specific averaging window or a historical height, call getnetworkhashps directly and pass nblocks.
• pooledtx reflects only this provider node's mempool view; another node may hold a slightly different set of unconfirmed transactions.

Supported networks

• Mainnet
• Testnet

See also

• getnetworkhashps
• getdifficulty
• getnetworkinfo