Parameters

hash_or_height

string | integer

REQUIRED

The block hash or height of the target block

stats

JSON Array

JSON array of values to filter from

Returns

result

object

The block statistics object

avgfeerate

number

Average fee rate

minfeerate

number

Minimum feerate in the block

avgfee

string

Average fee in the block

avgtxsize

string

Average transaction size

blockhash

string

The hash of the block

feerate_percentiles

string

A JSON array containing Feerates at the 10th, 25th, 50th, 75th, and 90th percentile weight unit

height

integer

The height of the block

ins

string

The number of inputs

maxfee

string

Maximum fee in the block

maxfeerate

string

Maximum feerate in the block

maxtxsize

string

Maximum transaction size in the block

medianfee

string

Truncated median fee in the block

mediantime

integer

The block median time past

mediantxsize

string

Truncated median transaction size

minfee

string

Minimum fee in the block

mintxsize

string

Minimum transaction size

outs

string

The number of outputs

subsidy

string

The block subsidy

swtotal_size

string

Total size of all segwit transactions

swtotal_weight

string

Total weight of all segwit transactions

swtxs

string

The number of segwit transactions

time

integer

The block time

total_out

string

Total amount in all outputs (excluding coinbase thus reward [i.e subsidy + totalfee])

total_size

string

Total size of all non-coinbase transactions

total_weight

string

Total weight of all non-coinbase transactions

totalfee

string

The fee total

txs

string

The number of transactions

utxo_increase

string

The increase/decrease in the number of unspent outputs

utxo_size_inc

string

The increase/decrease in size for the utxo index

error

object | null

(Optional) JSON-RPC error when the request failed; omitted or null on success

code

integer

Error code

message

string

Error message

Request

1
curl -X POST "https://docs-demo.btc.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "getblockstats",
6
  "params": [
7
    "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",
8
    [
9
      "minfeerate",
10
      "avgfeerate"
11
    ]
12
  ],
13
  "id": 1
14
}'

1
curl -X POST "https://docs-demo.btc.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "getblockstats",
6
  "params": [
7
    "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",
8
    [
9
      "minfeerate",
10
      "avgfeerate"
11
    ]
12
  ],
13
  "id": 1
14
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'getblockstats',
4
    params: ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",["minfeerate","avgfeerate"]],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.btc.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'getblockstats',
4
    params: ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",["minfeerate","avgfeerate"]],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.btc.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.btc.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "getblockstats",
9
  "params": [
10
    "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",
11
    [
12
      "minfeerate",
13
      "avgfeerate"
14
    ]
15
  ],
16
  "id": 1
17
})
18
headers = {
19
  'Content-Type': 'application/json'
20
}
21

22
response = requests.request("POST", url, headers=headers, data=payload)
23

24
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.btc.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "getblockstats",
9
  "params": [
10
    "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",
11
    [
12
      "minfeerate",
13
      "avgfeerate"
14
    ]
15
  ],
16
  "id": 1
17
})
18
headers = {
19
  'Content-Type': 'application/json'
20
}
21

22
response = requests.request("POST", url, headers=headers, data=payload)
23

24
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.btc.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "getblockstats",
11
  params: ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",["minfeerate","avgfeerate"]]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.btc.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "getblockstats",
11
  params: ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",["minfeerate","avgfeerate"]]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

Response

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "avgfeerate": 0,
5
    "minfeerate": 0
6
  },
7
  "id": 1
8
}

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "avgfeerate": 0,
5
    "minfeerate": 0
6
  },
7
  "id": 1
8
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free