eth_getTdByNumber

POST

/{apiKey}

Returns the total difficulty for a given block number. This method is primarily used by Heimdall to query the total difficulty of a produced block when building a milestone.

Path Parameters

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request

stringformat: "^0x([1-9a-f]+[0-9a-f]*|0)$"required

The block number for which to retrieve the total difficulty.

Responses

200

An object containing the block number and its total difficulty, or null if the block is not found.

POST/v2/{apiKey}

curl --request POST \  --url https://polygon-mainnet.g.alchemy.com/v2/docs-demo \  --header 'Content-Type: application/json' \  --data '{  "jsonrpc": "2.0",  "id": 1,  "method": "eth_getTdByNumber",  "params": [    "0x1b4"  ]}'

200Success

{  "jsonrpc": "2.0",  "id": 1,  "result": {    "blockNumber": "0x1b4",    "totalDifficulty": "0x27f07"  }}

Was this page helpful?