Please note that this RPC method requires the Blockbook RPC enabled on your Quicknode endpoint.

Parameters

block_id

string

REQUIRED

The block height or block hash to query.

Returns

txCount

integer

Number of transactions in the block.

totalFeesSat

string

Total fees paid in the block, in satoshis.

averageFeePerKb

integer

Average fee per kilobyte across the block, in satoshis.

decilesFeePerKb

array

Fee-per-kilobyte distribution split into deciles (11 values, lowest to highest), in satoshis.

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": "bb_getFeeStats",
6
  "params": [
7
    "800000"
8
  ],
9
  "id": 1
10
}'

1
curl -X POST "https://docs-demo.btc.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "bb_getFeeStats",
6
  "params": [
7
    "800000"
8
  ],
9
  "id": 1
10
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'bb_getFeeStats',
4
    params: ["800000"],
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: 'bb_getFeeStats',
4
    params: ["800000"],
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": "bb_getFeeStats",
9
  "params": [
10
    "800000"
11
  ],
12
  "id": 1
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

18
response = requests.request("POST", url, headers=headers, data=payload)
19

20
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": "bb_getFeeStats",
9
  "params": [
10
    "800000"
11
  ],
12
  "id": 1
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

18
response = requests.request("POST", url, headers=headers, data=payload)
19

20
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: "bb_getFeeStats",
11
  params: ["800000"]
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: "bb_getFeeStats",
11
  params: ["800000"]
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
  "id": 1,
3
  "result": {
4
    "txCount": 3720,
5
    "totalFeesSat": "13687680",
6
    "averageFeePerKb": 11905,
7
    "decilesFeePerKb": [
8
      4081,
9
      5678,
10
      5814,
11
      6000,
12
      6000,
13
      6058,
14
      6260,
15
      7000,
16
      7934,
17
      12055,
18
      1105392
19
    ]
20
  },
21
  "jsonrpc": "2.0"
22
}

1
{
2
  "id": 1,
3
  "result": {
4
    "txCount": 3720,
5
    "totalFeesSat": "13687680",
6
    "averageFeePerKb": 11905,
7
    "decilesFeePerKb": [
8
      4081,
9
      5678,
10
      5814,
11
      6000,
12
      6000,
13
      6058,
14
      6260,
15
      7000,
16
      7934,
17
      12055,
18
      1105392
19
    ]
20
  },
21
  "jsonrpc": "2.0"
22
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free