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

Path Parameters

xpub_or_address

string

REQUIRED

An address, an extended public key, or an output descriptor. Supported descriptor forms: pkh(...), wpkh(...), sh(wpkh(...)), and tr(...). Must be an account-level key, not a master key. URL-encode the descriptor when placing it in the REST path.

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

This includes:

• key origin prefixes: tr([73c5da0a/86'/0'/0']xpub...)
• multipath selectors: tr(xpub.../<0;1>/*)
• explicit branch paths: tr(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 - tr(xpub...) - which is fully supported. The branch selector is unnecessary: Blockbook automatically scans both the receive (0) and change (1) branches for the account.

Query Parameters

confirmed

boolean

When set to true, only returns confirmed UTXOs.

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.

txid

string

Transaction ID of the UTXO

vout

integer

Output index in the transaction

value

string

UTXO value in satoshis

height

integer

Block height where the UTXO was created

confirmations

integer

Number of confirmations

address

string

The address this UTXO belongs to. Returned only for xpub and descriptor queries; omitted for single-address queries.

path

string

BIP32 derivation path of the address, e.g. m/86'/0'/0'/0/0. The last two segments are the branch (0 = receive, 1 = change) and the address index. Returned only for xpub and descriptor queries; omitted for single-address queries.

Request

1
curl -X GET "https://docs-demo.btc.quiknode.pro/utxo/bc1p72h09wplu60qdxyr8q3ftgdhga7jxnjhdz08qs4u9we9q3lzmqmqa4yzj6?confirmed=true" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json"

1
curl -X GET "https://docs-demo.btc.quiknode.pro/utxo/bc1p72h09wplu60qdxyr8q3ftgdhga7jxnjhdz08qs4u9we9q3lzmqmqa4yzj6?confirmed=true" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json"

1
async function main() {
2
    const response = await fetch('https://docs-demo.btc.quiknode.pro/utxo/bc1p72h09wplu60qdxyr8q3ftgdhga7jxnjhdz08qs4u9we9q3lzmqmqa4yzj6?confirmed=true', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json'}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
async function main() {
2
    const response = await fetch('https://docs-demo.btc.quiknode.pro/utxo/bc1p72h09wplu60qdxyr8q3ftgdhga7jxnjhdz08qs4u9we9q3lzmqmqa4yzj6?confirmed=true', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json'}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.btc.quiknode.pro/utxo/bc1p72h09wplu60qdxyr8q3ftgdhga7jxnjhdz08qs4u9we9q3lzmqmqa4yzj6?confirmed=True"
5

6
headers = {
7
  'Content-Type': 'application/json',
8
  'Accept': 'application/json'
9
}
10

11
response = requests.request("GET", url, headers=headers)
12

13
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.btc.quiknode.pro/utxo/bc1p72h09wplu60qdxyr8q3ftgdhga7jxnjhdz08qs4u9we9q3lzmqmqa4yzj6?confirmed=True"
5

6
headers = {
7
  'Content-Type': 'application/json',
8
  'Accept': 'application/json'
9
}
10

11
response = requests.request("GET", url, headers=headers)
12

13
print(response.text)

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

5
uri = URI("https://docs-demo.btc.quiknode.pro/utxo/bc1p72h09wplu60qdxyr8q3ftgdhga7jxnjhdz08qs4u9we9q3lzmqmqa4yzj6?confirmed=true")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10

11
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
12
  http.request(request)
13
end
14

15
puts response.body

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

5
uri = URI("https://docs-demo.btc.quiknode.pro/utxo/bc1p72h09wplu60qdxyr8q3ftgdhga7jxnjhdz08qs4u9we9q3lzmqmqa4yzj6?confirmed=true")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10

11
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
12
  http.request(request)
13
end
14

15
puts response.body

Response

1
[
2
  {
3
    "txid": "959bb7b066f8e8cfccb6f089eccdc1d1d84ed5199a2d35771465b2558e2d5339",
4
    "vout": 1,
5
    "value": "330078393",
6
    "height": 952895,
7
    "confirmations": 1
8
  },
9
  {
10
    "txid": "c301490a0b821c5182010d0c178e538c127bb251fb62d5b39414a7c260b8e681",
11
    "vout": 1,
12
    "value": "331021333",
13
    "height": 952895,
14
    "confirmations": 1
15
  }
16
]

1
[
2
  {
3
    "txid": "959bb7b066f8e8cfccb6f089eccdc1d1d84ed5199a2d35771465b2558e2d5339",
4
    "vout": 1,
5
    "value": "330078393",
6
    "height": 952895,
7
    "confirmations": 1
8
  },
9
  {
10
    "txid": "c301490a0b821c5182010d0c178e538c127bb251fb62d5b39414a7c260b8e681",
11
    "vout": 1,
12
    "value": "331021333",
13
    "height": 952895,
14
    "confirmations": 1
15
  }
16
]

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free