Getblockstats

getblockstats operations.

getblockstats

post

Returns a variety of statistics about the block identified by its height or block hash.

Authorizations

api-keyAuth

api-keystringRequired

NOWNodes API key passed in the api-key header.

Body

application/json

Request payload for getblockstats.

jsonrpcstring · enumRequired

JSON-RPC protocol version.

Example: 1.0Possible values:

methodstring · enumRequired

Name of the RPC method.

Example: getblockstatsPossible values:

paramsinteger[]Optional

Parameters for the method. For getblockstats, this is an array containing a single value – either the block height (integer) or block hash (string).

Example: [855000]

idstringRequired

Request identifier. The response will echo this value. Can be any string or number.

Example: curltest

Responses

200

Successful block statistics retrieval.

application/json

Object containing getblockstats response details.

errorone of · nullableRequired

JSON-RPC error object or null on success.

or

stringOptional

JSON-RPC error object. Null when the request succeeds.

Example: {"code":-28,"message":"Service temporarily unavailable"}

idone of · nullableRequired

Request id echoed by the server.

stringOptional

Client-provided request identifier echoed in the response.

Example: curltest

or

integerOptional

Client-provided request identifier echoed in the response.

Example: curltest

Other propertiesanyOptional

401

Unauthorized: API key is present but rejected by the NOWNodes gateway.

text/plain

405

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

text/plain

422

Missing API key. The NOWNodes gateway returns plain text for this error.

text/plain

500

Internal Server Error

application/json

post/

HTTPcURLJavaScriptPython

POST / HTTP/1.1
Host: btc-testnet.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 76

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblockstats",
  "params": [
    855000
  ]
}

{
  "result": {
    "avgfee": 1410,
    "avgfeerate": 10,
    "avgtxsize": 141,
    "blockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "feerate_percentiles": [
      8,
      10,
      12,
      15,
      20
    ],
    "height": 956047,
    "ins": 1,
    "maxfee": 1410,
    "maxfeerate": 10,
    "maxtxsize": 141,
    "medianfee": 1410,
    "mediantime": 1770000000,
    "mediantxsize": 141,
    "minfee": 1410,
    "minfeerate": 10,
    "mintxsize": 141,
    "outs": 2,
    "subsidy": 312500000,
    "swtotal_size": 141,
    "swtotal_weight": 561,
    "swtxs": 1,
    "time": 1770000000,
    "total_out": 312500000,
    "total_size": 141,
    "total_weight": 561,
    "totalfee": 1410,
    "txs": 1,
    "utxo_increase": 1,
    "utxo_size_inc": 172
  },
  "error": null,
  "id": "curltest"
}