Parameters

nblocks

integer

default=one month. The window's size in number of blocks

blockhash

string

default=chain tip. The hash of the block that ends the window

Returns

result

object

Chain transaction statistics for the requested window

time

integer

The timestamp for the last block in the window, defined in UNIX epoch time

txcount

integer

The total number of chain transactions up to that point

window_final_block_hash

string

The hash of the final block in the window

window_final_block_height

integer

The height of the final block in the window

window_block_count

integer

The window's size in terms of blocks

window_interval

integer

The elapsed time in the window in seconds and only returned if "window_block_count" is > 0

window_tx_count

integer

The number of transactions in the window and only returned if "window_block_count" is > 0

txrate

number

The average rate of transactions per second in the window and only returned if "window_interval" is > 0

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

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'getchaintxstats',
4
    params: [2016],
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: 'getchaintxstats',
4
    params: [2016],
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": "getchaintxstats",
9
  "params": [
10
    2016
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": "getchaintxstats",
9
  "params": [
10
    2016
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: "getchaintxstats",
11
  params: [2016]
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: "getchaintxstats",
11
  params: [2016]
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
    "time": 1769215475,
5
    "txcount": 1301087928,
6
    "window_final_block_hash": "00000000000000000000b286a4d4ac73f6ad82e54d9ccf6d2d71c492ceeb4930",
7
    "window_final_block_height": 933586,
8
    "window_block_count": 2016,
9
    "window_interval": 1236672,
10
    "window_tx_count": 5491262,
11
    "txrate": 4.44035443512912
12
  },
13
  "id": 1
14
}

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "time": 1769215475,
5
    "txcount": 1301087928,
6
    "window_final_block_hash": "00000000000000000000b286a4d4ac73f6ad82e54d9ccf6d2d71c492ceeb4930",
7
    "window_final_block_height": 933586,
8
    "window_block_count": 2016,
9
    "window_interval": 1236672,
10
    "window_tx_count": 5491262,
11
    "txrate": 4.44035443512912
12
  },
13
  "id": 1
14
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free