Parameters

nblocks

numeric

Default one month. The window size in number of blocks

blockhash

string

Default chain tip. The hash of the block that ends the window

Returns

result

object

The result is a JSON object with the following fields:

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_block_count

integer

The window's size in terms of blocks

window_tx_count

integer

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

window_interval

integer

The elapsed time in the window in seconds 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

JSON-RPC error object when the request failed, or null on success

id

integer

The JSON-RPC request identifier

Request

1
curl -X POST "https://docs-demo.bch-mainnet.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.bch-mainnet.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.bch-mainnet.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.bch-mainnet.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.bch-mainnet.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.bch-mainnet.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.bch-mainnet.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.bch-mainnet.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
  "result": {
3
    "time": 1770077670,
4
    "txcount": 413600599,
5
    "window_final_block_hash": "000000000000000000516816955012ae5d1947e12fb984c547340da216ab29f9",
6
    "window_block_count": 2016,
7
    "window_tx_count": 167721,
8
    "window_interval": 1203077,
9
    "txrate": 0.1394100294494866
10
  },
11
  "error": null,
12
  "id": 1
13
}

1
{
2
  "result": {
3
    "time": 1770077670,
4
    "txcount": 413600599,
5
    "window_final_block_hash": "000000000000000000516816955012ae5d1947e12fb984c547340da216ab29f9",
6
    "window_block_count": 2016,
7
    "window_tx_count": 167721,
8
    "window_interval": 1203077,
9
    "txrate": 0.1394100294494866
10
  },
11
  "error": null,
12
  "id": 1
13
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free