githubEdit

getnetworkhashps - Bitcoin

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

This method returns the estimated network hashes per second based on the last n blocks.

Parameters

Parameter
Type
Required
Description

nblocks

number

No

Number of blocks to average over (default: 120). Use -1 to average since last difficulty change.

height

number

No

Block height to estimate at (default: -1 for current tip).

Request

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

Response

{
    "result": 550000000000000000000,
    "error": null
}

Response Parameters

Field
Type
Description

result

number

Estimated hashes per second (in hashes/second).

Use Case

The getnetworkhashps method is essential for:

  • Calculating network security metrics

  • Estimating mining profitability

  • Tracking hashrate trends over time

  • Building mining analytics dashboards

  • Monitoring network health

  • Analyzing historical hashrate data

Error Handling

Status Code
Error Message
Cause

403

Forbidden

Missing or invalid ACCESS-TOKEN.

-8

Block height out of range

Specified height doesn't exist.

Integration With Web3

The getnetworkhashps method helps developers:

  • Build hashrate monitoring tools

  • Create mining profitability calculators

  • Implement network security indicators

  • Track historical hashrate trends

  • Support mining pool dashboards

Last updated

Was this helpful?