Parameters

hash_type

string

It tells about which UTXO set hash should be calculated, with the possible values: "hash_serialized_3", "none" , "muhash". If not provided, default is set to be "hash_serialized_3"

hash_or_height

string/integer

The block hash or height of the target height. If not provided, default is set to be the current best block

use_index

boolean

Use coinstatsindex if available. If not provided, default is set to be true

Returns

result

object

The result is a JSON object with the following fields:

height

integer

The height of current block

bestblock

string

The hash of the block at the tip of the chain

transactions

integer

The number of transactions with unspent outputs

txouts

integer

The number of unspent transaction outputs

bogosize

integer

A meaningless metric for UTXO set size

hash_serialized

string

The serialized hash of the UTXO set

disk_size

integer

The estimated size of the chainstate on disk

total_amount

number

It's the value in BCH about all unspent outputs together

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

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

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

16
response = requests.request("POST", url, headers=headers, data=payload)
17

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

16
response = requests.request("POST", url, headers=headers, data=payload)
17

18
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: "gettxoutsetinfo",
11
  params: []
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: "gettxoutsetinfo",
11
  params: []
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
    "height": 913619,
4
    "bestblock": "000000000000000000673d5ea6054040c410841c3908f7cfb0cd45f5dae47466",
5
    "transactions": 25202263,
6
    "txouts": 58401028,
7
    "bogosize": 5428509198,
8
    "hash_serialized": "ef2557fa29f00f142e7fcf98bce3167b123616b00072316fb7a48616e8ef6a4c",
9
    "disk_size": 5593206866,
10
    "total_amount": 19917285.62250808
11
  },
12
  "error": null,
13
  "id": 1
14
}

1
{
2
  "result": {
3
    "height": 913619,
4
    "bestblock": "000000000000000000673d5ea6054040c410841c3908f7cfb0cd45f5dae47466",
5
    "transactions": 25202263,
6
    "txouts": 58401028,
7
    "bogosize": 5428509198,
8
    "hash_serialized": "ef2557fa29f00f142e7fcf98bce3167b123616b00072316fb7a48616e8ef6a4c",
9
    "disk_size": 5593206866,
10
    "total_amount": 19917285.62250808
11
  },
12
  "error": null,
13
  "id": 1
14
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free