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

The result is a JSON object with the following fields:

height

The height of current block

bestblock

The hash of the block at the tip of the chain

txouts

The number of unspent transaction outputs

bogosize

A meaningless metric for UTXO set siz

hash_serialized_3

The serialized hash (only present if 'hash_serialized_3' hash_type is chosen)

muhash

The muhash (only present if 'muhash' hash_type is chosen) value is used to compare with other nodes to verify the UTXO set's integrity

total_amount

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

transactions

The number of transactions with unspent outputs

disk_size

The estimated size of the chainstate on disk

total_unspendable_amount

The total amount of coins permanently excluded from the UTXO set (only available if coinstatsindex is used)

block_info

object

An object which gives information of amounts in the block at this block height (only available if coinstatsindex is used)

prevout_spent

The total amount of all prevouts spent in this block

coinbase

The coinbase subsidy amount of this block

new_outputs_ex_coinbase

The total amount of new outputs created by this block

unspendable

The total amount of unspendable outputs created in this block

unspendables

An object which has detailed view of the unspendable categories

genesis_block

The unspendable amount of the Genesis block subsidy

bip30

The transactions overridden by duplicates (no longer possible with BIP30)

scripts

The amounts sent to scripts that are unspendable

unclaimed_rewards

The fee rewards that miners did not claim in their coinbase

error

The error message, if any

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

1
curl -X POST "https://docs-demo.btc.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.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: 'gettxoutsetinfo',
4
    params: [],
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": "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.btc.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.btc.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.btc.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": 894201,
4
    "bestblock": "000000000000000000016a63eea2cd5e870e45cf49f59bcb26fb53dde180fa59",
5
    "txouts": 174650130,
6
    "bogosize": 13667355086,
7
    "hash_serialized_3": "fd225dc9c1884cc4beedf388851ebfd5544cbfed600c1c247a76f25baf006b21",
8
    "total_amount": 19856660.24412765,
9
    "transactions": 121924370,
10
    "disk_size": 12015211078
11
  },
12
  "error": null,
13
  "id": 1
14
}

1
{
2
  "result": {
3
    "height": 894201,
4
    "bestblock": "000000000000000000016a63eea2cd5e870e45cf49f59bcb26fb53dde180fa59",
5
    "txouts": 174650130,
6
    "bogosize": 13667355086,
7
    "hash_serialized_3": "fd225dc9c1884cc4beedf388851ebfd5544cbfed600c1c247a76f25baf006b21",
8
    "total_amount": 19856660.24412765,
9
    "transactions": 121924370,
10
    "disk_size": 12015211078
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