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

Parameters

xpub_or_descriptor

string

REQUIRED

An address, an extended public key, or an output descriptor wrapping an extended public key. Supported descriptor form: pkh(...). Extended public keys must be account-level keys, not master keys.

Descriptors containing a / are not supported and return an error.

This includes:

• key origin prefixes: pkh([73c5da0a/44'/133'/0']xpub...)
• multipath selectors: pkh(xpub.../<0;1>/*)
• explicit branch paths: pkh(xpub.../0/*)

Percent-encoding the slash does not help. Note the origin prefix cannot be shortened either, since it contains slashes of its own.

Use the bare form instead - pkh(xpub...) - which is fully supported. The branch selector is unnecessary: Blockbook automatically scans both the receive (0) and change (1) branches for the account.

object

object

The options object with the following fields:

confirmed

boolean

Whether or not to exclude unconfirmed transactions.

gap

integer

The gap limit used when deriving addresses from an extended public key (xpub). Defaults to 20.

Returns

When querying by xpub or descriptor, each UTXO includes address and path, which identify the derivation branch and index it came from. Both are omitted when querying a single address, since the address is already known.

result

array

An array of unspent transaction outputs for an address or xpub. By default, the list contains both confirmed and unconfirmed transactions.

txid

string

The transaction id

vout

integer

The 4-byte index indicating the position of a transaction output

value

string

The value in zatoshis of the output

height

integer

The block height at which the transaction output was created

confirmations

integer

The number of block confirmations since the output was created

coinbase

boolean

Whether the UTXO is a Coinbase transaction. Coinbase UTXOs have this field set to true, however, due to performance reasons, it will return only up to the minimum Coinbase confirmations limit (100). After this limit, UTXOs are not detected as Coinbase.

address

string

(Optional) The address this UTXO belongs to; included for xpub and descriptor queries, omitted for single-address queries

path

string

(Optional) BIP32 derivation path of the address (e.g. m/44'/133'/0'/0/0); included for xpub and descriptor queries, omitted for single-address queries

Request

1
curl -X POST "https://docs-demo.zec-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "bb_getUTXOs",
6
  "params": [
7
    "t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",
8
    {
9
      "confirmed": true
10
    }
11
  ],
12
  "id": 1
13
}'

1
curl -X POST "https://docs-demo.zec-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "bb_getUTXOs",
6
  "params": [
7
    "t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",
8
    {
9
      "confirmed": true
10
    }
11
  ],
12
  "id": 1
13
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'bb_getUTXOs',
4
    params: ["t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",{"confirmed":true}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.zec-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: 'bb_getUTXOs',
4
    params: ["t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",{"confirmed":true}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.zec-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.zec-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "bb_getUTXOs",
9
  "params": [
10
    "t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",
11
    {
12
      "confirmed": True
13
    }
14
  ],
15
  "id": 1
16
})
17
headers = {
18
  'Content-Type': 'application/json'
19
}
20

21
response = requests.request("POST", url, headers=headers, data=payload)
22

23
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.zec-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "bb_getUTXOs",
9
  "params": [
10
    "t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",
11
    {
12
      "confirmed": True
13
    }
14
  ],
15
  "id": 1
16
})
17
headers = {
18
  'Content-Type': 'application/json'
19
}
20

21
response = requests.request("POST", url, headers=headers, data=payload)
22

23
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.zec-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "bb_getUTXOs",
11
  params: ["t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",{"confirmed":true}]
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.zec-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "bb_getUTXOs",
11
  params: ["t1L2b66MXbgpVMXDfUa94GCBFAN4dCxGohM",{"confirmed":true}]
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
    {
5
      "txid": "65c2220429d7858d42ca8741cb4170f64660bf189b9aeb82f13dd6cbbfb316ce",
6
      "vout": 0,
7
      "value": "125075000",
8
      "height": 3325978,
9
      "confirmations": 92,
10
      "coinbase": true
11
    },
12
    {
13
      "txid": "c7a5aba940d88b4a54c4e42350fc6d5f7af025e692c8ce5da932ab9c80306dcb",
14
      "vout": 0,
15
      "value": "125221500",
16
      "height": 3325941,
17
      "confirmations": 129
18
    },
19
    {
20
      "txid": "a11a005fa3bb17143122160b8073b3eb6ae2f511b6e2ea3f194b628c8b2ebead",
21
      "vout": 0,
22
      "value": "125000000",
23
      "height": 3325940,
24
      "confirmations": 130
25
    }
26
  ],
27
  "jsonrpc": "2.0"
28
}

1
{
2
  "id": 1,
3
  "result": [
4
    {
5
      "txid": "65c2220429d7858d42ca8741cb4170f64660bf189b9aeb82f13dd6cbbfb316ce",
6
      "vout": 0,
7
      "value": "125075000",
8
      "height": 3325978,
9
      "confirmations": 92,
10
      "coinbase": true
11
    },
12
    {
13
      "txid": "c7a5aba940d88b4a54c4e42350fc6d5f7af025e692c8ce5da932ab9c80306dcb",
14
      "vout": 0,
15
      "value": "125221500",
16
      "height": 3325941,
17
      "confirmations": 129
18
    },
19
    {
20
      "txid": "a11a005fa3bb17143122160b8073b3eb6ae2f511b6e2ea3f194b628c8b2ebead",
21
      "vout": 0,
22
      "value": "125000000",
23
      "height": 3325940,
24
      "confirmations": 130
25
    }
26
  ],
27
  "jsonrpc": "2.0"
28
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free